Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

CNContactStore.Contacts

Queries all contacts.

Component Version macOS Windows Linux Server iOS SDK
Contacts 8.5 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CNContactStore.Contacts" { ; unifyResults } )   More

Parameters

Parameter Description Example Flags
unifyResults Whether to unify results.
1 to unify contacts and 0 to return all invidivual contacts.
Default is 1.
1 Optional

Result

Returns list of contact identifiers or error.

Description

Queries all contacts.
You an get the list unified, so contacts in several accounts are merged.
Or you get list of all contacts with those merged which appear in multiple accounts.

Seems like Addressbook.people and CNContactStore.Contacts with unifyResults = 0 is the same list.

Examples

Query names for all contacts:

While(
[
    names = "";
    // query list of contacts IDs
    list = MBS( "CNContactStore.Contacts"; 1 );
    count = ValueCount(list);
    index = 1
] ;
    index ≤ count ;
[
    id = GetValue(list; index);
    // query name for each ID
    name = MBS( "CNContact.Name"; id);
    names = names & name & ¶;
    index = index + 1
] ;
// return all the names
names )

See also

Release notes

Example Databases

Blog Entries

This function checks for a license.

Created 25th September 2018, last changed 14th June 2022


CNContactStore.AuthorizationStatus - CNContactStore.ContactsInContainer