Function

CTFontCreateForString(_:_:_:)

Returns a new font reference that can best map the given 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 cannot be encoded by the current font.

range

A CFRange structure specifying the range of the string that needs to be mapped.

Return Value

The best substitute font from the cascade list of the current font that can encode the specified string range. If the current font is capable of encoding the string range, then it is retained and returned.

See Also

Creating Fonts