Carbon


InitializeUnicodeConverter

Header: UnicodeConverter.h Carbon status: Unsupported

Initializes the 68K static library version of the Unicode Converter.

OSStatus InitializeUnicodeConverter (
    StringPtr TECFileName
);
Parameter descriptions
TECFileName

Text Encoding Conversion Manager extension file name. You may pass NULL for this parameter or you can pass the extension file name, which improves performance of the function. After you call InitializeUnicodeConverter, you can obtain the extension name for subsequent calls to InitializeUnicodeConverter using the function TECGetInfo.

function result

A result code.

DISCUSSION

The Text Encoding Conversion Manager provides 68K static libraries that include the Unicode Converter and Basic Text functions. You can use the static libraries if you do not want to use the Code Fragment Manager (CFM) 68K version. The static libraries are provided directly to you to link into your applications, whereas the shared libraries that require the Code Fragment Manager are distributed with Mac OS, beginning with Mac OS 8. These static libraries use resources from the Text Encoding Converter extension and from the files in the Text Encodings folder, so both must be present whether you use the CFM 68K Unicode Converter or the 68K shared libraries.

Clients of the 68K static libraries must explicitly initialize and terminate the Unicode Converter using the InitializeUnicodeConverter and TerminateUnicodeConverter functions. Initialization and termination are handled automatically for CFM clients.

You may call InitializeUnicodeConverter more than once. The function checks whether the converter has already been initialized, and if so, completes execution successfully.

CARBON NOTES

This function is not considered part of Carbon as it is available only through a static 68K library.


© 2000 Apple Computer, Inc. (Last Updated 7/17/2000)