Function

CTFontCreateForString(_:_:_:)

Returns a font reference that most accurately maps the string range based on the current font.

Declaration

func CTFontCreateForString(_ currentFont: CTFont, _ string: CFString, _ range: CFRange) -> CTFont

Parameters

currentFont

The current font that contains a valid cascade list.

string

A Unicode string containing characters that can’t be encoded by the current font.

range

A CFRange structure specifying the range of the string to map.

Return Value

The best substitute font from the cascade list of the current font that can encode the specified string range.

Discussion

If the current font can encode the string range, the function retains and returns the font.

See Also

Creating Fonts

func CTFontCreateWithFontDescriptor(CTFontDescriptor, CGFloat, UnsafePointer<CGAffineTransform>?) -> CTFont

Returns a new font reference that best matches the given font descriptor.

func CTFontCreateUIFontForLanguage(CTFontUIFontType, CGFloat, CFString?) -> CTFont?

Returns the special user-interface font for the given language and user-interface type.

func CTFontCreateCopyWithFamily(CTFont, CGFloat, UnsafePointer<CGAffineTransform>?, CFString) -> CTFont?

Returns a new font in the specified family based on the traits of the original font.

func CTFontCreateForStringWithLanguage(CTFont, CFString, CFRange, CFString?) -> CTFont

Returns a font reference that most accurately maps the string range based on the current font and language.