CTFontDescriptorCreateMatchingFontDescriptor(_:_:)
Returns the single preferred matching font descriptor based on the original descriptor and system precedence.
Declaration
func CTFontDescriptorCreateMatchingFontDescriptor(_ descriptor: CTFontDescriptor, _ mandatoryAttributes: CFSet?) -> CTFontDescriptor?Parameters
- descriptor:
The original font descriptor.
- mandatoryAttributes:
A set of attribute keys which must be identically matched in any returned font descriptors. May be
NULL.
Return Value
A retained, normalized font descriptor matching the attributes present in descriptor.
Discussion
The original descriptor may be returned in normalized form. The caller is responsible for releasing the result. 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(_:_:_:)CTFontDescriptorCreateMatchingFontDescriptors(_:_:)