---
title: "ABPersonComparePeopleByName(_:_:_:)"
framework: Address Book
role: symbol
role_heading: Function
platforms: [iOS 2.0+, iPadOS 2.0+, Mac Catalyst 13.1+]
path: "addressbook/abpersoncomparepeoplebyname(_:_:_:)"
---

# ABPersonComparePeopleByName(_:_:_:)

Indicates how two person records get sorted.

## Declaration

```swift
func ABPersonComparePeopleByName(_ person1: ABRecord!, _ person2: ABRecord!, _ ordering: ABPersonSortOrdering) -> CFComparisonResult
```

## Parameters

- `person1`: The first person.
- `person2`: The second person.
- `ordering`: Indicates whether to sort by first name or by last name. See doc://com.apple.addressbook/documentation/AddressBook/1619730-sort-order.

## Return Value

Return Value - kCFCompareLessThan when person1 goes before person2.

## Discussion

Discussion kCFCompareEqualTo when person1 and person2 have the same name. kCFCompareGreaterThan when person1 goes after person2.

## 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)
- [ABAddressBookCreateWithOptions(_:_:)](addressbook/abaddressbookcreatewithoptions(_:_:).md)
- [ABAddressBookGetAuthorizationStatus()](addressbook/abaddressbookgetauthorizationstatus().md)
- [ABAddressBookGetGroupCount(_:)](addressbook/abaddressbookgetgroupcount(_:).md)
- [ABAddressBookGetGroupWithRecordID(_:_:)](addressbook/abaddressbookgetgroupwithrecordid(_:_:).md)
