Contents

ABAddressBookCreateWithOptions(_:_:)

Creates a new address book object with data from the Address Book database.

Declaration

func ABAddressBookCreateWithOptions(_ options: CFDictionary!, _ error: UnsafeMutablePointer<Unmanaged<CFError>?>!) -> Unmanaged<ABAddressBook>!

Parameters

  • options:

    Reserved. Pass NULL.

  • error:

    On error, contains error information. See Address Book Errors.

Return Value

An address book object, NULL, or an empty database.

Discussion

Changes made to the returned address book are reflected in the Address Book database only after saving the address book with ABAddressBookSave(_:_:).

On iOS 6.0 and later, if the caller does not have access to the Address Book database:

  • For apps linked against iOS 6.0 and later, this function returns NULL.

  • For apps linked against previous version of iOS, this function returns an empty read-only database.

If your app syncs information with the database, it must not sync data when it does not have access to the database.

See Also

Deprecated