ABPerson Reference

Framework
AddressBook/AddressBook.h
Declared in
ABPerson.h

Overview

Person records are represented by instances of the ABRecordRef opaque type, whose record type is kABPersonType. Person records store information about a person, such as first name, last name, address, email, and phone number.

Person records don’t necessarily have to be stored in the Address Book database. You can use person records as a way to group contact information in memory and present it to the user through, for example, a person view controller (ABPersonViewController).

Functions by Task

Creating Person Records

Sorting Person Records

Getting Person Property Information

Managing Pictures

Accessing the Person Records in an Address Book

Displaying Person Records

Working with vCard Data

Functions

ABAddressBookCopyArrayOfAllPeople

Returns all the person records in an address book.

CFArrayRef ABAddressBookCopyArrayOfAllPeople (
   ABAddressBookRef addressBook
);
Parameters
addressBook

The address book whose person records are being returned.

Return Value

Array containing the person records in addressBook.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABAddressBookCopyArrayOfAllPeopleInSource

Returns an array of all person records from a particular source.

CFArrayRef ABAddressBookCopyArrayOfAllPeopleInSource (
   ABAddressBookRef addressBook,
   ABRecordRef source
);
Parameters
addressBook

The address book whose records are being returned.

source

The source whose records are being returned.

Return Value

An array of all person records from a particular source.

Availability
  • Available in iOS 4.0 and later.
Declared In
ABPerson.h

ABAddressBookCopyArrayOfAllPeopleInSourceWithSortOrdering

Returns an array of all person records in the address book, sorted with the specified order.

CFArrayRef ABAddressBookCopyArrayOfAllPeopleInSourceWithSortOrdering (
   ABAddressBookRef addressBook,
   ABRecordRef source,
   ABPersonSortOrdering sortOrdering
);
Parameters
addressBook

The address book whose person records are being returned.

source

The source whose records are being returned.

sortOrdering

Indicates whether to sort by first name or by last name. See “Sort Order”.

Return Value

An array of all person records in the address book database, sorted by sortOrdering.

Availability
  • Available in iOS 4.0 and later.
Declared In
ABPerson.h

ABAddressBookCopyPeopleWithName

Performs a prefix search on the composite names of people in an address book and returns an array of persons that match the search criteria.

CFArrayRef ABAddressBookCopyPeopleWithName (
   ABAddressBookRef addressBook,
   CFStringRef name
);
Parameters
addressBook

The address book in which to search.

name

The search term. Examples: "Mary", "Smi", "Hu Yan".

Return Value

Array containing person records (ABRecordRef objects) that match name.

Availability
  • Available in iOS 2.0 and later.
Related Sample Code
Declared In
ABPerson.h

ABAddressBookGetPersonCount

Returns the number of person records in an address book.

CFIndex ABAddressBookGetPersonCount (
   ABAddressBookRef addressBook
);
Parameters
addressBook

The address book whose person records are being counted.

Return Value

The number of person records in addressBook.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABAddressBookGetPersonWithRecordID

Returns the person record with a given record ID.

ABRecordRef ABAddressBookGetPersonWithRecordID (
   ABAddressBookRef addressBook,
   ABRecordID recordID
);
Parameters
addressBook

The address book in which to search for recordID.

recordID

The record identifier to seek in addressBook.

Return Value

If found, the person record with recordID as its identifier, otherwise NULL.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonComparePeopleByName

Indicates how two person records get sorted.

CFComparisonResult ABPersonComparePeopleByName (
   ABRecordRef person1,
   ABRecordRef person2,
   ABPersonSortOrdering ordering
);
Parameters
person1

The first person.

person2

The second person.

ordering

Indicates whether to sort by first name or by last name. See “Sort Order”.

Return Value
Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonCopyArrayOfAllLinkedPeople

Returns an array of all person records in the address book database that are linked to the given person record.

CFArrayRef ABPersonCopyArrayOfAllLinkedPeople (
   ABRecordRef person
);
Parameters
person

The person record whose linked records are being returned.

Return Value

An array of all person records in the address book database that are linked to the given person record

Discussion

Linked records contain information about the same person, and usually come from different sources.

Availability
  • Available in iOS 4.0 and later.
Declared In
ABPerson.h

ABPersonCopyCompositeNameDelimiterForRecord

Returns the delimiter to use between name components.

CFStringRef ABPersonCopyCompositeNameDelimiterForRecord (
   ABRecordRef record
);
Parameters
record

The record being displayed.

Return Value

The delimiter to use between name components.

Discussion

If the record is NULL, or if it has no first name, middle name, or last name, then the default delimiter is returned.

Availability
  • Available in iOS 7.0 and later.
Declared In
ABPerson.h

ABPersonCopyImageData

Returns the picture for a person record.

CFDataRef ABPersonCopyImageData (
   ABRecordRef person
);
Parameters
person

The person record whose picture is being returned.

Return Value

The picture for person, or NULL if the person has no picture.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonCopyImageDataWithFormat

Returns the picture for a person record in the given format.

CFDataRef ABPersonCopyImageDataWithFormat (
   ABRecordRef person,
   ABPersonImageFormat format
);
Parameters
person

The person record whose picture is being returned.

format

The size and shape being returned. See “Image Format”.

Return Value

The picture for person, or NULL if the person has no picture.

Availability
  • Available in iOS 4.1 and later.
Declared In
ABPerson.h

ABPersonCopyLocalizedPropertyName

Returns the localized name of a person property

CFStringRef ABPersonCopyLocalizedPropertyName (
   ABPropertyID property
);
Parameters
property

The person property whose localized name is being returned.

Return Value

The localized name of property.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonCopySource

Returns the source that the person record is from.

ABRecordRef ABPersonCopySource (
   ABRecordRef person
);
Parameters
person

The person whose source is being returned.

Return Value

The source of the person record.

Availability
  • Available in iOS 4.0 and later.
Declared In
ABPerson.h

ABPersonCreate

Creates a new person record in the default source.

ABRecordRef ABPersonCreate (
   void
);
Discussion

To add the newly created person record to the Address Book database, use ABAddressBookAddRecord.

Availability
  • Available in iOS 2.0 and later.
Related Sample Code
Declared In
ABPerson.h

ABPersonCreateInSource

Creates a new person record in a particular source.

ABRecordRef ABPersonCreateInSource (
   ABRecordRef source
);
Parameters
source

The source to create the person record in.

Return Value

A new person record in the specified source.

Discussion

To add the newly created person record to the Address Book database, use ABAddressBookAddRecord.

If source is NULL, the group is created in the default source.

Availability
  • Available in iOS 4.0 and later.
Declared In
ABPerson.h

ABPersonCreatePeopleInSourceWithVCardRepresentation

Creates person records from the given vCard representation.

CFArrayRef ABPersonCreatePeopleInSourceWithVCardRepresentation (
   ABRecordRef source,
   CFDataRef vCardData
);
Parameters
source

The source in which to create the person record.

vCardData

The vCard data.

Return Value

The newly created person records.

Discussion

Address Book supports vCard version 3.0.

Availability
  • Available in iOS 5.0 and later.
Declared In
ABPerson.h

ABPersonCreateVCardRepresentationWithPeople

Returns the vCard representation of the given person records.

CFDataRef ABPersonCreateVCardRepresentationWithPeople (
   CFArrayRef people
);
Parameters
people

An array of person records.

Return Value

The vCard representation of the records.

Availability
  • Available in iOS 5.0 and later.
Declared In
ABPerson.h

ABPersonGetCompositeNameFormat

Returns the person-name display format. (Deprecated. Use ABPersonGetCompositeNameFormatForRecord instead.)

ABPersonCompositeNameFormat ABPersonGetCompositeNameFormat (
   void
);
Return Value

A constant indicating person-name display order; see “Composite Name Format.”

Availability
  • Available in iOS 2.0 and later.
  • Deprecated in iOS 7.0.
Declared In
ABPerson.h

ABPersonGetCompositeNameFormatForRecord

Returns the person-name display format to use for the given record.

ABPersonCompositeNameFormat ABPersonGetCompositeNameFormatForRecord (
   ABRecordRef record
);
Parameters
record

The record being displayed.

Return Value

The person-name display format to use for the given record.

Discussion

If the record is NULL, or if it has no first name, middle name, or last name, then the user’s default order preference is returned. For possible values, see “Composite Name Format.”

Availability
  • Available in iOS 7.0 and later.
Declared In
ABPerson.h

ABPersonGetSortOrdering

Returns the user’s sort-ordering preference for lists of persons.

ABPersonSortOrdering ABPersonGetSortOrdering (
   void
);
Return Value

The user’s sort ordering preference; see “Sort Order”.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonGetTypeOfProperty

Returns the type of a person property.

ABPropertyType ABPersonGetTypeOfProperty (
   ABPropertyID property
);
Parameters
property

The person property whose type is being returned.

Return Value

The type of property.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonHasImageData

Indicates whether a person has a picture.

bool ABPersonHasImageData (
   ABRecordRef person
);
Parameters
person

The person record in question.

Return Value

true when person has a picture, false otherwise.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonRemoveImageData

Removes a person’s picture.

bool ABPersonRemoveImageData (
   ABRecordRef person,
   CFErrorRef *error
);
Parameters
person

The person record whose picture is being removed.

error

On error, information about the cause.

Return Value

true when successful, false otherwise.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonSetImageData

Sets a person’s picture.

bool ABPersonSetImageData (
   ABRecordRef person,
   CFDataRef imageData,
   CFErrorRef *error
);
Parameters
person

The person record whose picture is being set.

imageData

The picture to assign to person.

error

On error, information about the cause.

Return Value

true when successful, false otherwise.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

Data Types

ABPersonSortOrdering

Indicates a person sort ordering.

typedef uint32_t ABPersonSortOrdering;
Discussion

See “Sort Order”.

Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonCompositeNameFormat

Indicates a person-name display format.

typedef uint32_t ABPersonCompositeNameFormat;
Availability
  • Available in iOS 2.0 and later.
Declared In
ABPerson.h

ABPersonImageFormat

Indicates an image format.

typedef enum ABPersonImageFormat;
Discussion

See “Image Format”.

Availability
  • Available in iOS 4.1 and later.
Declared In
ABPerson.h

Constants

Sort Order

These constants identify sort order for person lists.

enum {
   kABPersonSortByFirstName = 0,
   kABPersonSortByLastName  = 1
};
Constants
kABPersonSortByFirstName

Order by first name.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonSortByLastName

Order by last name.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Composite Name Format

These constants identify the format to use for a person’s composite name order for person records.

enum  {
   kABPersonCompositeNameFormatFirstNameFirst = 0,
   kABPersonCompositeNameFormatLastNameFirst  = 1
};
Constants
kABPersonCompositeNameFormatFirstNameFirst

First name first.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonCompositeNameFormatLastNameFirst

Last name first.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Image Format

These constants identify the size and shape of images.

enum {
   kABPersonImageFormatThumbnail = 0,
   kABPersonImageFormatOriginalSize = 2
};
Constants
kABPersonImageFormatThumbnail

The small square thumbnail.

Available in iOS 4.1 and later.

Declared in ABPerson.h.

kABPersonImageFormatOriginalSize

The image at its original size and shape.

Available in iOS 4.1 and later.

Declared in ABPerson.h.

Personal Information Properties

These constants identify person properties used to store personal information.

const ABPropertyID kABPersonFirstNameProperty;
const ABPropertyID kABPersonLastNameProperty;
const ABPropertyID kABPersonMiddleNameProperty;
const ABPropertyID kABPersonPrefixProperty;
const ABPropertyID kABPersonSuffixProperty;
const ABPropertyID kABPersonNicknameProperty;
const ABPropertyID kABPersonFirstNamePhoneticProperty;
const ABPropertyID kABPersonLastNamePhoneticProperty;
const ABPropertyID kABPersonMiddleNamePhoneticProperty;
const ABPropertyID kABPersonOrganizationProperty;
const ABPropertyID kABPersonJobTitleProperty;
const ABPropertyID kABPersonDepartmentProperty;
const ABPropertyID kABPersonEmailProperty;
const ABPropertyID kABPersonBirthdayProperty;
const ABPropertyID kABPersonNoteProperty;
const ABPropertyID kABPersonCreationDateProperty;
const ABPropertyID kABPersonModificationDateProperty;
Constants
kABPersonFirstNameProperty

First name. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonLastNameProperty

Last name. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonMiddleNameProperty

Middle name. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonPrefixProperty

Prefix (“Sir,” “Duke,” “General”). Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonSuffixProperty

Suffix (“Jr.,” “Sr.,” “III”). Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonNicknameProperty

Nickname. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonFirstNamePhoneticProperty

First name phonetic. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonLastNamePhoneticProperty

Last name phonetic. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonMiddleNamePhoneticProperty

Middle name phonetic. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonOrganizationProperty

Organization name. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonJobTitleProperty

Job title. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonDepartmentProperty

Department. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonEmailProperty

Email address. Type: kABMultiStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonBirthdayProperty

Birthday. Type: kABDateTimePropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonNoteProperty

Note. Type: kABStringPropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonCreationDateProperty

Creation date. Type: kABDateTimePropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonModificationDateProperty

Modification date. Type: kABDateTimePropertyType.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Address Property

These constants implement the person address property (a multivalue property of type kABMultiDictionaryPropertyType) and the labels used to identify each of the property’s values.

const ABPropertyID kABPersonAddressProperty;
const CFStringRef kABPersonAddressStreetKey;
const CFStringRef kABPersonAddressCityKey;
const CFStringRef kABPersonAddressStateKey;
const CFStringRef kABPersonAddressZIPKey;
const CFStringRef kABPersonAddressCountryKey;
const CFStringRef kABPersonAddressCountryCodeKey;
Constants
kABPersonAddressProperty

Identifier for the address multivalue property.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonAddressStreetKey

Street.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonAddressCityKey

City.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonAddressStateKey

State.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonAddressZIPKey

Zip code.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonAddressCountryKey

Country.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonAddressCountryCodeKey

Country code. The value is an ISO country code.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Date Properties

These constants implement the person dates property (a multivalue property of type kABMultiDateTimePropertyType) and the labels used to identify each of the property’s values.

const ABPropertyID kABPersonDateProperty;
const CFStringRef kABPersonAnniversaryLabel;
Constants
kABPersonDateProperty

Identifier for the dates multivalue property.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonAnniversaryLabel

Birthdate.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Person Type Property

These constants implement the person type property (a property of type kABIntegerPropertyType), which indicates whether a person record represents a human being or an organization.

const ABPropertyID kABPersonKindProperty;
const CFNumberRef kABPersonKindPerson;
const CFNumberRef kABPersonKindOrganization;
Constants
kABPersonKindProperty

Identifier for the type property.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonKindPerson

Identifies a person.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonKindOrganization

Identifies an organization.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Phone Number Property

These constants implement the person phone number property (a multivalue property of type kABMultiStringPropertyType) and the labels used to identify each of the property’s values.

const ABPropertyID kABPersonPhoneProperty;
const CFStringRef kABPersonPhoneMobileLabel;
const CFStringRef kABPersonPhoneIPhoneLabel;
const CFStringRef kABPersonPhoneMainLabel;
const CFStringRef kABPersonPhoneHomeFAXLabel;
const CFStringRef kABPersonPhoneWorkFAXLabel;
const CFStringRef kABPersonPhoneOtherFAXLabel;
const CFStringRef kABPersonPhonePagerLabel;
Constants
kABPersonPhoneProperty

Identifier for the phone number multivalue property.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonPhoneMobileLabel

Mobile phone number.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonPhoneIPhoneLabel

iPhone number.

Available in iOS 3.0 and later.

Declared in ABPerson.h.

kABPersonPhoneMainLabel

Main phone number.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonPhoneHomeFAXLabel

Home fax number.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonPhoneWorkFAXLabel

Work fax number.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonPhoneOtherFAXLabel

Other fax number.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonPhonePagerLabel

Pager phone number.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Instant Messaging Keys

The keys used to specify the different fields in a kABPersonInstantMessageProperty property (a multivalue property of type kABMultiDictionaryPropertyType). Neither developers nor users can add more keys.

const ABPropertyID kABPersonInstantMessageProperty;
const CFStringRef kABPersonInstantMessageServiceKey;
const CFStringRef kABPersonInstantMessageUsernameKey;
Constants
kABPersonInstantMessageProperty

Identifier for the instant message multivalue property.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceKey

Instant message service.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageUsernameKey

Instant message service username.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Instant Messaging Services

The predefined constants are used to identify instant messaging services. You may use these constants or any other string.

const CFStringRef kABPersonInstantMessageServiceYahoo;
const CFStringRef kABPersonInstantMessageServiceJabber;
const CFStringRef kABPersonInstantMessageServiceMSN;
const CFStringRef kABPersonInstantMessageServiceICQ;
const CFStringRef kABPersonInstantMessageServiceAIM;
const CFStringRef kABPersonInstantMessageServiceQQ;
const CFStringRef kABPersonInstantMessageServiceGoogleTalk;
const CFStringRef kABPersonInstantMessageServiceSkype;
const CFStringRef kABPersonInstantMessageServiceFacebook;
const CFStringRef kABPersonInstantMessageServiceGaduGadu;
Constants
kABPersonInstantMessageServiceYahoo

Yahoo instant message service.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceJabber

Jabber instant message service.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceMSN

MSN instant message service.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceICQ

ICQ instant message service.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceAIM

AIM instant message service.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceQQ

QQ instant message service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceGoogleTalk

Google Talk instant message service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceSkype

Skype instant message service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceFacebook

Facebook instant message service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonInstantMessageServiceGaduGadu

Gadu-Gadu instant message service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

Social Profile Keys

The keys used to specify the different fields in a kABPersonSocialProfileProperty property (a multivalue property of type kABMultiDictionaryPropertyType). Neither developers nor users can add more keys.

const ABPropertyID kABPersonSocialProfileProperty;
const CFStringRef kABPersonSocialProfileURLKey;
const CFStringRef kABPersonSocialProfileServiceKey;
const CFStringRef kABPersonSocialProfileUsernameKey;
const CFStringRef kABPersonSocialProfileUserIdentifierKey;
Constants
kABPersonSocialProfileProperty

Identifier for the social profile property.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileURLKey

Social profile URL.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileServiceKey

Social profile service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileUsernameKey

Social profile username.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileUserIdentifierKey

Social profile user identifier.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

Social Profile Services

The predefined constants are used to identify social networking services. You may use these constants or any other string.

const CFStringRef kABPersonSocialProfileServiceTwitter;
const CFStringRef kABPersonSocialProfileServiceSinaWeibo;
const CFStringRef kABPersonSocialProfileServiceGameCenter;
const CFStringRef kABPersonSocialProfileServiceFacebook;
const CFStringRef kABPersonSocialProfileServiceMyspace;
const CFStringRef kABPersonSocialProfileServiceLinkedIn;
const CFStringRef kABPersonSocialProfileServiceFlickr;
Constants
kABPersonSocialProfileServiceTwitter

Twitter social profile service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileServiceGameCenter

Game Center social profile service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileServiceSinaWeibo

Sina Weibo social profile service.

Available in iOS 6.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileServiceFacebook

Facebook social profile service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileServiceMyspace

Myspace social profile service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileServiceLinkedIn

LinkedIn social profile service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

kABPersonSocialProfileServiceFlickr

Flickr social profile service.

Available in iOS 5.0 and later.

Declared in ABPerson.h.

URL Property

This constant implements the person URL property (a multivalue property of type kABMultiStringPropertyType) and the label used to identify the property’s sole value.

const ABPropertyID kABPersonURLProperty;
const CFStringRef kABPersonHomePageLabel;
Constants
kABPersonURLProperty

Identifier for the URL multivalue property.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonHomePageLabel

Home page.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Related Name Property

These constants implement the person related name property (a multivalue property of type kABMultiStringPropertyType) and the labels used to identify each of the property’s values.

const ABPropertyID kABPersonRelatedNamesProperty;
const CFStringRef kABPersonMotherLabel;
const CFStringRef kABPersonFatherLabel;
const CFStringRef kABPersonParentLabel;
const CFStringRef kABPersonSisterLabel;
const CFStringRef kABPersonBrotherLabel;
const CFStringRef kABPersonChildLabel;
const CFStringRef kABPersonFriendLabel;
const CFStringRef kABPersonSpouseLabel;
const CFStringRef kABPersonPartnerLabel;
const CFStringRef kABPersonManagerLabel;
const CFStringRef kABPersonAssistantLabel;
Constants
kABPersonRelatedNamesProperty

Identifier for the related name multivalue property.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonMotherLabel

Mother.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonFatherLabel

Father.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonParentLabel

Parent.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonSisterLabel

Sister.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonBrotherLabel

Brother.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonChildLabel

Child.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonFriendLabel

Friend.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonSpouseLabel

Spouse.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonPartnerLabel

Partner.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonManagerLabel

Manager.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABPersonAssistantLabel

Assistant.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

Generic Property Labels

These constants contain generic property labels.

const CFStringRef kABWorkLabel;
const CFStringRef kABHomeLabel;
const CFStringRef kABOtherLabel;
Constants
kABWorkLabel

Work label.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABHomeLabel

Home label.

Available in iOS 2.0 and later.

Declared in ABPerson.h.

kABOtherLabel

Other label.

Available in iOS 2.0 and later.

Declared in ABPerson.h.