---
title: "CFLocaleCreateCanonicalLanguageIdentifierFromString(_:_:)"
framework: corefoundation
role: symbol
role_heading: Function
path: "corefoundation/cflocalecreatecanonicallanguageidentifierfromstring(_:_:)"
---

# CFLocaleCreateCanonicalLanguageIdentifierFromString(_:_:)

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

## Declaration

```swift
func CFLocaleCreateCanonicalLanguageIdentifierFromString(_ 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.

## Return Value

Return Value A string that represents the canonical language identifier for the specified arbitrary locale identifier. 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)
- [CFLocaleCreateCanonicalLocaleIdentifierFromString(_:_:)](corefoundation/cflocalecreatecanonicallocaleidentifierfromstring(_:_:).md)
- [CFLocaleCreateComponentsFromLocaleIdentifier(_:_:)](corefoundation/cflocalecreatecomponentsfromlocaleidentifier(_:_:).md)
- [CFLocaleCreateLocaleIdentifierFromComponents(_:_:)](corefoundation/cflocalecreatelocaleidentifierfromcomponents(_:_:).md)
- [CFLocaleCreateLocaleIdentifierFromWindowsLocaleCode(_:_:)](corefoundation/cflocalecreatelocaleidentifierfromwindowslocalecode(_:_:).md)
- [CFLocaleGetWindowsLocaleCodeFromLocaleIdentifier(_:)](corefoundation/cflocalegetwindowslocalecodefromlocaleidentifier(_:).md)