Function

CTFontCreateForStringWithLanguage(_:_:_:_:)

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

Declaration

func CTFontCreateForStringWithLanguage(_ currentFont: CTFont, _ string: CFString, _ range: CFRange, _ language: CFString?) -> 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 specifying the range of the string to map.

language

A language identifier to select a font for a particular localization.

Return Value

The best substitute font that can encode the specified string range.

Discussion

The current font itself can be returned if it covers the string provided. If the caller does not specify the language parameter, the function uses the current system language. The format of the language identifier should conform to UTS #35.

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 CTFontCreateForString(CTFont, CFString, CFRange) -> CTFont

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