---
title: "ABAddressBookCreateWithOptions(_:_:)"
framework: addressbook
role: symbol
role_heading: Function
path: "addressbook/abaddressbookcreatewithoptions(_:_:)"
---

# ABAddressBookCreateWithOptions(_:_:)

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

## Declaration

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

## Parameters

- `options`: Reserved. Pass NULL.
- `error`: On error, contains error information. See doc://com.apple.addressbook/documentation/AddressBook/address-book-errors.

## Return Value

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

## Discussion

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. important: You must ensure that an instance of ABAddressBookRef is used by only one thread.

## See Also

### Deprecated

- [ABAddressBookAddRecord(_:_:_:)](addressbook/abaddressbookaddrecord(_:_:_:).md)
- [ABAddressBookCopyArrayOfAllGroups(_:)](addressbook/abaddressbookcopyarrayofallgroups(_:).md)
- [ABAddressBookCopyArrayOfAllGroupsInSource(_:_:)](addressbook/abaddressbookcopyarrayofallgroupsinsource(_:_:).md)
- [ABAddressBookCopyArrayOfAllPeople(_:)](addressbook/abaddressbookcopyarrayofallpeople(_:).md)
- [ABAddressBookCopyArrayOfAllPeopleInSource(_:_:)](addressbook/abaddressbookcopyarrayofallpeopleinsource(_:_:).md)
- [ABAddressBookCopyArrayOfAllPeopleInSourceWithSortOrdering(_:_:_:)](addressbook/abaddressbookcopyarrayofallpeopleinsourcewithsortordering(_:_:_:).md)
- [ABAddressBookCopyArrayOfAllSources(_:)](addressbook/abaddressbookcopyarrayofallsources(_:).md)
- [ABAddressBookCopyDefaultSource(_:)](addressbook/abaddressbookcopydefaultsource(_:).md)
- [ABAddressBookCopyLocalizedLabel(_:)](addressbook/abaddressbookcopylocalizedlabel(_:).md)
- [ABAddressBookCopyPeopleWithName(_:_:)](addressbook/abaddressbookcopypeoplewithname(_:_:).md)
- [ABAddressBookCreate()](addressbook/abaddressbookcreate().md)
- [ABAddressBookGetAuthorizationStatus()](addressbook/abaddressbookgetauthorizationstatus().md)
- [ABAddressBookGetGroupCount(_:)](addressbook/abaddressbookgetgroupcount(_:).md)
- [ABAddressBookGetGroupWithRecordID(_:_:)](addressbook/abaddressbookgetgroupwithrecordid(_:_:).md)
- [ABAddressBookGetPersonCount(_:)](addressbook/abaddressbookgetpersoncount(_:).md)