Function

CFStringGetNameOfEncoding

Returns the canonical name of a specified string encoding.

Declaration

CFStringRef CFStringGetNameOfEncoding(CFStringEncoding encoding);

Parameters

encoding

The string encoding to use.

Return Value

Name of encoding; non-localized. Ownership follows the The Get Rule.

Discussion

This function returns the “canonical” name of the string encoding because the return value has to be the same no matter what localization is chosen. In other words, it can't change based on the International Preferences language panel setting. The canonical name is usually expressed in English.

See Also

Working With Encodings

CFStringConvertEncodingToIANACharSetName

Returns the name of the IANA registry “charset” that is the closest mapping to a specified string encoding.

CFStringConvertEncodingToNSStringEncoding

Returns the Cocoa encoding constant that maps most closely to a given Core Foundation encoding constant.

CFStringConvertEncodingToWindowsCodepage

Returns the Windows codepage identifier that maps most closely to a given Core Foundation encoding constant.

CFStringConvertIANACharSetNameToEncoding

Returns the Core Foundation encoding constant that is the closest mapping to a given IANA registry “charset” name.

CFStringConvertNSStringEncodingToEncoding

Returns the Core Foundation encoding constant that is the closest mapping to a given Cocoa encoding.

CFStringConvertWindowsCodepageToEncoding

Returns the Core Foundation encoding constant that is the closest mapping to a given Windows codepage identifier.

CFStringGetFastestEncoding

Returns for a CFString object the character encoding that requires the least conversion time.

CFStringGetListOfAvailableEncodings

Returns a pointer to a list of string encodings supported by the current system.

CFStringGetMaximumSizeForEncoding

Returns the maximum number of bytes a string of a specified length (in Unicode characters) will take up if encoded in a specified encoding.

CFStringGetMostCompatibleMacStringEncoding

Returns the most compatible Mac OS script value for the given input encoding.

CFStringGetSmallestEncoding

Returns the smallest encoding on the current system for the character contents of a string.

CFStringGetSystemEncoding

Returns the default encoding used by the operating system when it creates strings.

CFStringIsEncodingAvailable

Determines whether a given Core Foundation string encoding is available on the current system.