---
title: "CTFontCopyLocalizedName(_:_:_:)"
framework: coretext
role: symbol
role_heading: Function
path: "coretext/ctfontcopylocalizedname(_:_:_:)"
---

# CTFontCopyLocalizedName(_:_:_:)

Returns a reference to a localized name for the given font.

## Declaration

```swift
func CTFontCopyLocalizedName(_ font: CTFont, _ nameKey: CFString, _ actualLanguage: UnsafeMutablePointer<Unmanaged<CFString>?>?) -> CFString?
```

## Parameters

- `font`: The font reference.
- `nameKey`: The name specifier. See doc://com.apple.coretext/documentation/CoreText/name-specifier-constants for possible values.
- `actualLanguage`: On output, points to the language string of the returned name string. The format of the language identifier conforms to the RFC 3066bis standard.

## Return Value

Return Value A specific localized name from the font reference or NULL if the font does not have an entry for the requested name key.

## Discussion

Discussion The name is localized based on the user’s global language preference precedence. That is, the user’s language preference is a list of languages in order of precedence. So, for example, if the list had Japanese and English, in that order, then a font that did not have Japanese name strings but had English strings would return the English strings.

## See Also

### Getting Font Names

- [CTFontCopyPostScriptName(_:)](coretext/ctfontcopypostscriptname(_:).md)
- [CTFontCopyFamilyName(_:)](coretext/ctfontcopyfamilyname(_:).md)
- [CTFontCopyFullName(_:)](coretext/ctfontcopyfullname(_:).md)
- [CTFontCopyDisplayName(_:)](coretext/ctfontcopydisplayname(_:).md)
- [CTFontCopyName(_:_:)](coretext/ctfontcopyname(_:_:).md)