CNMutableContact

A mutable object that stores information about a single contact, such as the contact’s first name, phone numbers, and addresses.

Declaration

class CNMutableContact

Overview

CNMutableContact objects are not a thread-safe class. To access the contact information in a thread-safe manner, use a CNContact object instead.

You may modify only those properties whose values you fetched from the contacts database. When fetching a contact, you specify which properties you want to retrieve from the database. The contact store then populates the properties of a CNContact object with those values. After creating a mutable copy of that object, you can modify only those properties for which a value exists. If you attempt to access a property that is not available, the CNMutableContact object throws a CNContactPropertyNotFetchedExceptionName exception.

To remove the value for a property, set string and array properties to empty, and set all other properties to nil.

Topics

Setting the Identity of the Contact

contactType

Setting Name Information

Setting Work Information

Setting Addresses

Setting Phone Information

phoneNumbers

Setting Social Profiles

socialProfiles

Setting Birthday Information

Setting Notes

note

Setting Images

imageData

Relating Other Information to the Contact

Instance Properties

id