ABCopyArrayOfMatchingRecords(_:_:)
Returns an array of records that match the given search element, or an empty array if no records match the search element.
Declaration
func ABCopyArrayOfMatchingRecords(_ addressBook: ABAddressBookRef!, _ search: ABSearchElementRef!) -> Unmanaged<CFArray>!Parameters
- addressBook:
The address book for the logged-in user.
- search:
The search element that specifies the query. If
searchisNULL, this function raises an exception. Create an ABSearchElement object using the record specific functions: Abgroupcreatesearchelement(_:_:_:_:_:) or Abpersoncreatesearchelement(_:_:_:_:_:). SeeABSearchElement Cfor more functions that create compound queries.
Return Value
A new array containing ABRecord objects representing all the records that match search. If no records match search, this function returns an empty array. You are responsible for releasing this object.