---
title: "records(matching:)"
framework: addressbook
role: symbol
role_heading: Instance Method
path: "addressbook/abaddressbook/records(matching:)"
---

# records(matching:)

Returns an array of records that match the given search element, or returns an empty array if no records match the search element.

## Declaration

```swift
func records(matching search: ABSearchElement!) -> [Any]!
```

## Parameters

- `search`: The search element to perform the search against.

## Return Value

Return Value An array of records that match the given search element, or an empty array if no records match the search element.

## Discussion

Discussion If search is nil, this method raises an exception.