<!--
{
  "availability" : [
    "macOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AddressBook",
  "identifier" : "/documentation/AddressBook/ABPersonCreateSearchElement(_:_:_:_:_:)",
  "metadataVersion" : "0.1.0",
  "role" : "Function",
  "symbol" : {
    "kind" : "Function",
    "modules" : [
      "Address Book"
    ],
    "preciseIdentifier" : "c:@F@ABPersonCreateSearchElement"
  },
  "title" : "ABPersonCreateSearchElement(_:_:_:_:_:)"
}
-->

# ABPersonCreateSearchElement(_:_:_:_:_:)

Returns a search element object that specifies a query for records of this type.

```
func ABPersonCreateSearchElement(_ property: CFString!, _ label: CFString!, _ key: CFString!, _ value: CFTypeRef!, _ comparison: ABSearchComparison) -> Unmanaged<ABSearchElementRef>!
```

## Parameters

`property`

The name of the property to search on. It cannot be `NULL`. For a full list of the properties, see `Person Properties` and Common Properties in ABRecord.

`label`

The label name for a multi-value list. If `property` does not have multiple values, pass `NULL`. If `property` does have multiple values, pass `NULL` to search all the values.

`key`

The key name for a dictionary. If `property` is not a dictionary, pass `NULL`. If `property` is a dictionary, pass `NULL` to search all keys.

`value`

The value you are searching for. It cannot be `NULL`

`comparison`

Specifies the type of comparison to perform, such as [`kABEqual`](/documentation/AddressBook/kABEqual) or [`kABPrefixMatchCaseInsensitive`](/documentation/AddressBook/kABPrefixMatchCaseInsensitive). For a full list, see [`ABSearchComparison`](/documentation/AddressBook/ABSearchComparison).

## Return Value

A search element object that specifies a query according to the above parameters. You are responsible for releasing this object.

## Discussion

Use the ABAddressBook [`ABCopyArrayOfMatchingRecords(_:_:)`](/documentation/AddressBook/ABCopyArrayOfMatchingRecords(_:_:)) function to actually perform the query. Also, see `ABSearchElement C` for more functions that create compound queries.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)