---
title: "CFLocaleCreateCanonicalLocaleIdentifierFromString(_:_:)"
framework: corefoundation
role: symbol
role_heading: Function
path: "corefoundation/cflocalecreatecanonicallocaleidentifierfromstring(_:_:)"
---

# CFLocaleCreateCanonicalLocaleIdentifierFromString(_:_:)

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

## Declaration

```swift
func CFLocaleCreateCanonicalLocaleIdentifierFromString(_ allocator: CFAllocator!, _ localeIdentifier: CFString!) -> CFLocaleIdentifier!
```

## Parameters

- `allocator`: The allocator to use to allocate memory for the new object. Pass NULL or kCFAllocatorDefault to use the current default allocator.
- `localeIdentifier`: A string representation of an arbitrary locale identifier (for example, “English”).

## Return Value

Return Value A canonical locale identifier created by mapping the arbitrary locale identification string to the canonical identifier for the corresponding locale (for example, “en”). Returns NULL if there was a problem creating the object. Ownership follows the The Create Rule.

## See Also

### Getting and Creating Locale Identifiers

- [CFLocaleCreateCanonicalLocaleIdentifierFromScriptManagerCodes(_:_:_:)](corefoundation/cflocalecreatecanonicallocaleidentifierfromscriptmanagercodes(_:_:_:).md)
- [CFLocaleCreateCanonicalLanguageIdentifierFromString(_:_:)](corefoundation/cflocalecreatecanonicallanguageidentifierfromstring(_:_:).md)
- [CFLocaleCreateComponentsFromLocaleIdentifier(_:_:)](corefoundation/cflocalecreatecomponentsfromlocaleidentifier(_:_:).md)
- [CFLocaleCreateLocaleIdentifierFromComponents(_:_:)](corefoundation/cflocalecreatelocaleidentifierfromcomponents(_:_:).md)
- [CFLocaleCreateLocaleIdentifierFromWindowsLocaleCode(_:_:)](corefoundation/cflocalecreatelocaleidentifierfromwindowslocalecode(_:_:).md)
- [CFLocaleGetWindowsLocaleCodeFromLocaleIdentifier(_:)](corefoundation/cflocalegetwindowslocalecodefromlocaleidentifier(_:).md)