![]() |
ConvertFromUnicodeToPString |
||||
Header: | UnicodeConverter.h | Carbon status: | Supported | |
Converts a Unicode string to Pascal in a Mac OS text encoding.
OSStatus ConvertFromUnicodeToPString ( UnicodeToTextInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, ConstUniCharArrayPtr iUnicodeStr, Str255 oPascalStr );
A Unicode converter object. You use the CreateUnicodeToTextInfo or CreateUnicodeToTextInfoByEncoding function to obtain the Unicode converter object for the conversion.
The length in bytes of the Unicode string to be converted. This is the string your application provides in the iUnicodeStr parameter.
A pointer to an array containing the Unicode string to be converted.
A buffer. On return, the converted Pascal string returned by the function.
A result code.
The ConvertFromUnicodeToPString function provides an easy and efficient way to convert a Unicode string to a Pascal string in a Mac OS text encoding without incurring the overhead associated with use of the function ConvertFromUnicodeToText or ConvertFromUnicodeToScriptCodeRun.
If necessary, this function uses the loose mapping and fallback characters to map the text elements of the string. For fallback mappings, it uses the handler associated with the Unicode converter object.
Supported in Carbon. Available in Carbon 1.0.2 and later when running Mac OS 8.1 or later.
© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)