Function

CFStringGetSystemEncoding

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

Declaration

CFStringEncoding CFStringGetSystemEncoding(void);

Return Value

The default string encoding.

Discussion

This function returns the default text encoding used by the OS when it creates strings. In macOS, this encoding is determined by the user's preferred language setting. The preferred language is the first language listed in the International pane of the System Preferences.

In most situations you will not want to use this function, however, because your primary interest will be your application's default text encoding. The application encoding is required when you create a CFStringRef from strings stored in Resource Manager resources, which typically use one of the Mac encodings such as MacRoman or MacJapanese.

To get your application's default text encoding, call the GetApplicationTextEncoding Carbon function.

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.

CFStringGetNameOfEncoding

Returns the canonical name of a specified string encoding.

CFStringGetSmallestEncoding

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

CFStringIsEncodingAvailable

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