Type Method

addressBook

Returns a new instance of ABAddressBook, or nil if the Address Book database can’t be initialized.

Declaration

+ (ABAddressBook *)addressBook;

Return Value

A new instance of ABAddressBook, or nil if the Address Book database can’t be initialized.

Discussion

If you're just making one-off lookups and edits, the sharedAddressBook method is probably more appropriate. If your code is executing a tight loop, the addressBook method can yield significant performance improvements when used with the ABPerson initWithAddressBook: method. See Accessing the Address Book for more details.

If the user denies your application access to the Address Book database, this method returns nil.

See Also

Creating and Initializing an Address Book

+ sharedAddressBook

Returns the unique shared instance of ABAddressBook, or nil if the Address Book database can’t be initialized.