cordova-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From shaz...@apache.org
Subject [7/7] docs commit: CB-1931: empty array in contacts.find() will result in an error.
Date Tue, 26 Feb 2013 14:47:14 GMT
Updated Branches:
  refs/heads/next 8bf8fd926 -> 888deeaac


CB-1931: empty array in contacts.find() will result in an error.


Project: http://git-wip-us.apache.org/repos/asf/cordova-docs/repo
Commit: http://git-wip-us.apache.org/repos/asf/cordova-docs/commit/888deeaa
Tree: http://git-wip-us.apache.org/repos/asf/cordova-docs/tree/888deeaa
Diff: http://git-wip-us.apache.org/repos/asf/cordova-docs/diff/888deeaa

Branch: refs/heads/next
Commit: 888deeaacb24eb5bbd460ec53f1ce3f413e792e4
Parents: 7c8c09b
Author: Fil Maj <maj.fil@gmail.com>
Authored: Fri Feb 22 11:16:47 2013 -0800
Committer: Fil Maj <maj.fil@gmail.com>
Committed: Fri Feb 22 11:16:47 2013 -0800

----------------------------------------------------------------------
 docs/en/edge/cordova/contacts/contacts.find.md |    2 +-
 1 files changed, 1 insertions(+), 1 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/cordova-docs/blob/888deeaa/docs/en/edge/cordova/contacts/contacts.find.md
----------------------------------------------------------------------
diff --git a/docs/en/edge/cordova/contacts/contacts.find.md b/docs/en/edge/cordova/contacts/contacts.find.md
index 70522a5..54217df 100644
--- a/docs/en/edge/cordova/contacts/contacts.find.md
+++ b/docs/en/edge/cordova/contacts/contacts.find.md
@@ -29,7 +29,7 @@ Description
 
 contacts.find is an asynchronous function that queries the device contacts database and returns
an array of `Contact` objects.  The resulting objects are passed to the `contactSuccess` callback
function specified by the __contactSuccess__ parameter.  
 
-Users must specify the contact fields to be used as a search qualifier in the __contactFields__
parameter.  Only the fields specified in the __contactFields__ parameter will be returned
as properties of the `Contact` objects that are passed to the __contactSuccess__ callback
function.  A zero-length __contactFields__ parameter will result in an array of `Contact`
objects with only the `id` property populated. A __contactFields__ value of ["*"] will return
all contact fields. 
+Users must specify the contact fields to be used as a search qualifier in the __contactFields__
parameter.  Only the fields specified in the __contactFields__ parameter will be returned
as properties of the `Contact` objects that are passed to the __contactSuccess__ callback
function.  A zero-length __contactFields__ parameter is invalid and will result in a `ContactError.INVALID_ARGUMENT_ERROR`
. A __contactFields__ value of ["*"] will return all contact fields. 
 
 The __contactFindOptions.filter__ string can be used as a search filter when querying the
contacts database.  If provided, a case-insensitive, partial value match is applied to each
field specified in the __contactFields__ parameter.  If a match is found in a comparison with
_any_ of the specified fields, the contact is returned.
 


Mime
View raw message