Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Up Previous Next 

PATH Mac OS 8 and 9 Developer Documentation > Text Encoding Conversion Manager
Programming With the Text Encoding Conversion Manager

UnicodeToTextFallbackProcPtr

In converting a text string, when the Unicode Converter encounters a source text element for which there is no destination encoding equivalent, it may use loose mappings and fallback characters to perform the conversion.

A fallback handler is a function that the Unicode Converter uses to perform fallback mapping. To assign your fallback handler to a Unicode converter object, you use the function SetFallbackUnicodeToText or SetFallbackUnicodeToTextRun. Your own fallback handler must adhere to the following prototype function defined by the Unicode Converter:

typedef pascal OSStatus (*UnicodeToTextFallbackProcPtr)(
                            UniChar         *iSrcUniStr,
                            ByteCount       iSrcUniStrLen,
                            ByteCount       *oSrcConvLen,
                            TextPtr         oDestStr,
                            ByteCount       iDestStrLen,
                            ByteCount       *oDestConvLen,
                            LogicalAddress  iInfoPtr,
                            ConstUnicodeMappingPtr iUnicodeMappingPtr);

For information about creating a fallback handler function, see the description of the function MyUnicodeToTextFallbackProc.

© 1999 Apple Computer, Inc. – (Last Updated 13 Dec 99)

Up Previous Next