---
title: "matchingDescriptors(options:)"
framework: appkit
role: symbol
role_heading: Instance Method
path: "appkit/nsfontcollection/matchingdescriptors(options:)"
---

# matchingDescriptors(options:)

Returns an array of font descriptors matching the logical descriptors with the given options.

## Declaration

```swift
func matchingDescriptors(options: [NSFontCollectionMatchingOptionKey : NSNumber]? = nil) -> [NSFontDescriptor]?
```

## Parameters

- `options`: A dictionary containing any combination of the Matching Descriptors Options keys or nil.

## Return Value

Return Value The matchingDescriptors for the given options.

## See Also

### Getting the Font Descriptors

- [matchingDescriptors](appkit/nsfontcollection/matchingdescriptors.md)
- [matchingDescriptors(forFamily:)](appkit/nsfontcollection/matchingdescriptors(forfamily:).md)
- [matchingDescriptors(forFamily:options:)](appkit/nsfontcollection/matchingdescriptors(forfamily:options:).md)
- [NSFontCollectionMatchingOptionKey](appkit/nsfontcollectionmatchingoptionkey.md)
- [queryDescriptors](appkit/nsfontcollection/querydescriptors.md)
- [exclusionDescriptors](appkit/nsfontcollection/exclusiondescriptors.md)