You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by sh...@apache.org on 2013/02/26 15:47:14 UTC
[7/7] docs commit: CB-1931: empty array in contacts.find() will
result in an error.
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 <ma...@gmail.com>
Authored: Fri Feb 22 11:16:47 2013 -0800
Committer: Fil Maj <ma...@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.