CNContactStore.ContactsMatchingName
-----------------------------------

Queries matching contacts for a name.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Contacts](component_Contacts.md) | [8.4](newinversion84.md) | ✅ Yes | ❌ No | ❌ No | ❌ No | ✅ Yes |

MBS( "CNContactStore.ContactsMatchingName"; Name ) 

**MBS**( **"CNContactStore.ContactsMatchingName";** /\* Queries matching contacts for a name. \*/  
**$Name**) /\* The name to match against.e.g. "Joe Miller" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Name | The name to match against. | "Joe Miller" |

### Result

Returns list or error.

### Description

Queries matching contacts for a name.  
Returns list of contact identifiers.  
  
This will use unified contacts, so data is merged from several sources.  
### Examples

Query name of first contact found with given name:

 MBS ("[CNContact.Name](CNContactName.md)"; GetValue ( MBS ( "CNContactStore.ContactsMatchingName"; "Joe Miller" ); 1))  
### See also

- [CNContact.JSON](CNContactJSON.md)
- [CNContact.Name](CNContactName.md)
- [CNContactStore.Contacts](CNContactStoreContacts.md)
- [CNContactStore.ContactsMatchingEmailAddress](CNContactStoreContactsMatchingEmailAddress.md)
- [CNContactStore.ContactsMatchingPhoneNumber](CNContactStoreContactsMatchingPhoneNumber.md)
- [CNContactStore.ContactsMatchingURL](CNContactStoreContactsMatchingURL.md)
- [CNContactStore.ContactsWithData](CNContactStoreContactsWithData.md)
- [CNContactStore.DataWithContacts](CNContactStoreDataWithContacts.md)

### Release notes

- **Version 10.1**
    - Fixed [CNContactStore.Contacts](https://www.mbsplugins.eu/CNContactStoreContacts.shtml), [CNContactStore.UnifiedMeContact](https://www.mbsplugins.eu/CNContactStoreUnifiedMeContact.shtml), [CNContactStore.ContactsInGroup](https://www.mbsplugins.eu/CNContactStoreContactsInGroup.shtml), [CNContactStore.ContactsMatchingName](https://www.mbsplugins.eu/CNContactStoreContactsMatchingName.shtml) and others to work if your iOS application has not the entitlement to access notes in contacts.

### Example Databases

- [Mac and iOS/Contacts/Contacts Dialogs](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/Mac%20and%20iOS/Contacts/Contacts%20Dialogs.shtml#3ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin, version 10.1pr5](https://www.mbsplugins.de/archive/2020-02-24/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.1pr2](https://www.mbsplugins.de/archive/2020-02-03/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 1st August 2018 , last changed 21st September 2018

  
[CNContactStore.ContactsMatchingEmailAddress](CNContactStoreContactsMatchingEmailAddress.md) - [CNContactStore.ContactsMatchingPhoneNumber](CNContactStoreContactsMatchingPhoneNumber.md)

[HTML Version](CNContactStoreContactsMatchingName.shtml)