Returns an array of font feature-setting tuples.
SDKs
- iOS 3.2+
- macOS 10.5+
- Mac Catalyst 13.0+
- tvOS 9.0+
- watchOS 2.0+
Framework
- Core Text
Declaration
CFArray Ref CTFontCopyFeatureSettings(CTFont Ref font);
Parameters
font
The font reference.
Return Value
A normalized array of font feature-setting dictionaries. The array contains only the non-default settings that should be applied to the font, or NULL
if the default settings should be used.
Discussion
A feature-setting dictionary is a tuple of a k
key-value pair and a k
key-value pair. Each setting dictionary indicates which setting is enabled. It is the caller's responsibility to handle exclusive and nonexclusive settings as necessary.
The feature settings are verified against those that the font supports and any that do not apply are removed. Further, feature settings that represent a default setting for the font are also removed.