CFLocale

Overview

Unicode operations such as collation and text boundary determination can be affected by the conventions of a particular language or region. CFLocale objects specify language-specific or region-specific information for locale-sensitive operations.

The CFLocale opaque type provides support for obtaining available locales, obtaining localized locale names, and converting among locale data formats. Locale identifiers in macOS follow the IETF’s BCP 47. CFLocale never uses Script Manager codes (except for the legacy support provided by CFLocaleCreateCanonicalLocaleIdentifierFromScriptManagerCodes(_:_:_:))—the Script Manager and all its concepts are deprecated.

For more information on locale identifiers, read Internationalization and Localization Guide. It is also useful to read the ICU’s User Guide for the Locale Class.

CFLocale is “toll-free bridged” with its Cocoa Foundation counterpart, NSLocale. This means that the Core Foundation type is interchangeable in function or method calls with the bridged Foundation object. Therefore, in a method where you see an NSLocale * parameter, you can pass in a CFLocaleRef, and in a function where you see a CFLocaleRef parameter, you can pass in an NSLocale instance. See Toll-Free Bridged Types for more information on toll-free bridging.

Topics

Creating a Locale

func CFLocaleCopyCurrent()

Returns a copy of the logical locale for the current user.

func CFLocaleCreate(CFAllocator!, CFLocaleIdentifier!)

Creates a locale for the given arbitrary locale identifier.

func CFLocaleCreateCopy(CFAllocator!, CFLocale!)

Returns a copy of a locale.

func CFLocaleGetSystem()

Returns the root, canonical locale.

Getting System Locale Information

func CFLocaleCopyAvailableLocaleIdentifiers()

Returns an array of CFString objects that represents all locales for which locale data is available.

Getting ISO Information

func CFLocaleCopyISOCountryCodes()

Returns an array of CFString objects that represents all known legal ISO country codes.

func CFLocaleCopyISOLanguageCodes()

Returns an array of CFString objects that represents all known legal ISO language codes.

func CFLocaleCopyISOCurrencyCodes()

Returns an array of CFString objects that represents all known legal ISO currency codes.

func CFLocaleCopyCommonISOCurrencyCodes()

Returns an array of strings that represents ISO currency codes for currencies in common use.

Language Preferences

func CFLocaleCopyPreferredLanguages()

Returns the array of canonicalized language IDs that the user prefers.

Getting Information About a Locale

func CFLocaleCopyDisplayNameForPropertyValue(CFLocale!, CFLocaleKey!, CFString!)

Returns the display name for the given value.

func CFLocaleGetValue(CFLocale!, CFLocaleKey!)

Returns the corresponding value for the given key of a locale’s key-value pair.

func CFLocaleGetIdentifier(CFLocale!)

Returns the given locale's identifier.

Getting and Creating Locale Identifiers

func CFLocaleCreateCanonicalLocaleIdentifierFromScriptManagerCodes(CFAllocator!, LangCode, RegionCode)

Returns a canonical locale identifier from given language and region codes.

func CFLocaleCreateCanonicalLanguageIdentifierFromString(CFAllocator!, CFString!)

Returns a canonical language identifier by mapping an arbitrary locale identification string to the canonical identifier

func CFLocaleCreateCanonicalLocaleIdentifierFromString(CFAllocator!, CFString!)

Returns a canonical locale identifier by mapping an arbitrary locale identification string to the canonical identifier.

func CFLocaleCreateComponentsFromLocaleIdentifier(CFAllocator!, CFLocaleIdentifier!)

Returns a dictionary containing the result from parsing a locale ID consisting of language, script, country, variant, and keyword/value pairs.

func CFLocaleCreateLocaleIdentifierFromComponents(CFAllocator!, CFDictionary!)

Returns a locale identifier consisting of language, script, country, variant, and keyword/value pairs derived from a dictionary containing the source information.

func CFLocaleCreateLocaleIdentifierFromWindowsLocaleCode(CFAllocator!, UInt32)

Returns a locale identifier from a Windows locale code.

func CFLocaleGetWindowsLocaleCodeFromLocaleIdentifier(CFLocaleIdentifier!)

Returns a Windows locale code from the locale identifier.