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

CNContact.Name

Queries display name of contact.

Component Version macOS Windows Linux Server iOS SDK
Contacts 8.4 ✅ Yes ❌ No ❌ No ❌ No ✅ Yes
MBS( "CNContact.Name"; ContactIdentifier )   More

Parameters

Parameter Description Example
ContactIdentifier The contact identifier. "46B1E34D-58F9-4B6B-A80D-0F71ABB87A0E"

Result

Returns name or error.

Description

Queries display name of contact.

Examples

Query your name:

MBS( "CNContact.Name"; MBS( "CNContactStore.UnifiedMeContact" ))

Query name of first contact found with given name:

MBS("CNContact.Name"; GetValue ( MBS( "CNContactStore.ContactsMatchingName"; "Joe Miller" ); 1))

Query names for all contacts:

While(
[
    names = "";
    // query list of contact 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

  • Version 10.2

Blog Entries

Created 1st August 2018, last changed 14th June 2022


CNContact.MailingAddress - CNContact.SetValue