---
title: "CTFontDescriptorCreateMatchingFontDescriptors(_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontdescriptorcreatematchingfontdescriptors(_:_:)"
---

# CTFontDescriptorCreateMatchingFontDescriptors(_:_:)

Returns an array of normalized font descriptors matching the provided descriptor.

## Declaration

```swift
func CTFontDescriptorCreateMatchingFontDescriptors(_ descriptor: CTFontDescriptor, _ mandatoryAttributes: CFSet?) -> CFArray?
```

## Parameters

- `descriptor`: The font descriptor.
- `mandatoryAttributes`: A set of attribute keys that must be identically matched in any returned font descriptors. May be NULL.

## Return Value

Return Value A retained array of normalized font descriptors matching the attributes present in descriptor.

## Discussion

Discussion If descriptor itself is normalized, then the array will contain only one item: the original descriptor. In the context of font descriptors, normalized infers that the input values were matched up with actual existing fonts, and the descriptors for those existing fonts are the returned normalized descriptors.

## See Also

### Creating Font Descriptors

- [CTFontDescriptorCreateWithNameAndSize(_:_:)](coretext/ctfontdescriptorcreatewithnameandsize(_:_:).md)
- [CTFontDescriptorCreateWithAttributes(_:)](coretext/ctfontdescriptorcreatewithattributes(_:).md)
- [CTFontDescriptorCreateCopyWithAttributes(_:_:)](coretext/ctfontdescriptorcreatecopywithattributes(_:_:).md)
- [CTFontDescriptorCreateCopyWithVariation(_:_:_:)](coretext/ctfontdescriptorcreatecopywithvariation(_:_:_:).md)
- [CTFontDescriptorCreateCopyWithFeature(_:_:_:)](coretext/ctfontdescriptorcreatecopywithfeature(_:_:_:).md)
- [CTFontDescriptorCreateCopyWithFamily(_:_:)](coretext/ctfontdescriptorcreatecopywithfamily(_:_:).md)
- [CTFontDescriptorCreateCopyWithSymbolicTraits(_:_:_:)](coretext/ctfontdescriptorcreatecopywithsymbolictraits(_:_:_:).md)
- [CTFontDescriptorCreateMatchingFontDescriptor(_:_:)](coretext/ctfontdescriptorcreatematchingfontdescriptor(_:_:).md)