---
title: "CTFontCollectionCreateMatchingFontDescriptorsForFamily(_:_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontcollectioncreatematchingfontdescriptorsforfamily(_:_:_:)"
---

# CTFontCollectionCreateMatchingFontDescriptorsForFamily(_:_:_:)

Retrieves an array of font descriptors that match the specified family, one descriptor for each style in the collection.

## Declaration

```swift
func CTFontCollectionCreateMatchingFontDescriptorsForFamily(_ collection: CTFontCollection, _ familyName: CFString, _ options: CFDictionary?) -> CFArray?
```

## Parameters

- `collection`: The font collection reference.
- `familyName`: The font family name.
- `options`: The options dictionary.

## Return Value

Return Value An array of CTFontDescriptor objects that match the specified family in the collection, or NULL if there are none.

## See Also

### Getting Font Descriptors

- [CTFontCollectionCreateMatchingFontDescriptors(_:)](coretext/ctfontcollectioncreatematchingfontdescriptors(_:).md)
- [CTFontCollectionCreateMatchingFontDescriptorsWithOptions(_:_:)](coretext/ctfontcollectioncreatematchingfontdescriptorswithoptions(_:_:).md)
- [CTFontCollectionCreateMatchingFontDescriptorsSortedWithCallback(_:_:_:)](coretext/ctfontcollectioncreatematchingfontdescriptorssortedwithcallback(_:_:_:).md)
- [CTFontCollectionSortDescriptorsCallback](coretext/ctfontcollectionsortdescriptorscallback.md)