CTFontDescriptorCreateMatchingFontDescriptors(_:_:)
Returns an array of normalized font descriptors matching the provided descriptor.
Declaration
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
A retained array of normalized font descriptors matching the attributes present in descriptor.
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(_:_:)CTFontDescriptorCreateWithAttributes(_:)CTFontDescriptorCreateCopyWithAttributes(_:_:)CTFontDescriptorCreateCopyWithVariation(_:_:_:)CTFontDescriptorCreateCopyWithFeature(_:_:_:)CTFontDescriptorCreateCopyWithFamily(_:_:)CTFontDescriptorCreateCopyWithSymbolicTraits(_:_:_:)CTFontDescriptorCreateMatchingFontDescriptor(_:_:)