Function

CFStringGetSmallestEncoding

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

Declaration

CFStringEncoding CFStringGetSmallestEncoding(CFStringRef theString);

Parameters

theString

The string for which to find the smallest encoding.

Return Value

The string encoding that has the smallest representation of theString.

Discussion

This function returns the supported encoding that requires the least space (in terms of bytes needed to represent one character) to represent the character contents of a string. This information is not always immediately available, so this function might need to compute it.

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.

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.