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

# matchingDescriptors(forFamily:options:)

Returns an array of font descriptors matching the logical descriptors for the given font family and options.

## Declaration

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

## Parameters

- `family`: The font family whose descriptors are matched.
- `options`: A dictionary containing any combination of the Matching Descriptors Options keys or nil.

## Return Value

Return Value The matchingDescriptors for the given family and options.

## See Also

### Getting the Font Descriptors

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