Types, constants, and prototypes for Unicode Converter. More...

#include <MacTypes.h>
#include <TextCommon.h>
#include <MixedMode.h>

Data Structures
struct	UnicodeMapping

Macros
#define	NewUnicodeToTextFallbackUPP(userRoutine)

#define	DisposeUnicodeToTextFallbackUPP(userUPP) DisposeRoutineDescriptor(userUPP)

#define	InvokeUnicodeToTextFallbackUPP(iSrcUniStr, iSrcUniStrLen, oSrcConvLen, oDestStr, iDestStrLen, oDestConvLen, iInfoPtr, iUnicodeMappingPtr, userUPP)

#define	NewUnicodeToTextFallbackProc(userRoutine) NewUnicodeToTextFallbackUPP(userRoutine)

#define	CallUnicodeToTextFallbackProc( userRoutine, iSrcUniStr, iSrcUniStrLen, oSrcConvLen, oDestStr, iDestStrLen, oDestConvLen, iInfoPtr, iUnicodeMappingPtr)

Typedefs
typedef struct OpaqueTextToUnicodeInfo *	TextToUnicodeInfo

typedef struct OpaqueUnicodeToTextInfo *	UnicodeToTextInfo

typedef struct OpaqueUnicodeToTextRunInfo *	UnicodeToTextRunInfo

typedef const TextToUnicodeInfo	ConstTextToUnicodeInfo

typedef const UnicodeToTextInfo	ConstUnicodeToTextInfo

typedef SInt32	UnicodeMapVersion

typedef struct UnicodeMapping	UnicodeMapping

typedef UnicodeMapping *	UnicodeMappingPtr

typedef const UnicodeMapping *	ConstUnicodeMappingPtr

typedef ByteCount	iSrcUniStrLen

typedef ByteCount ByteCount *	oSrcConvLen

typedef ByteCount ByteCount TextPtr	oDestStr

typedef ByteCount ByteCount TextPtr ByteCount	iDestStrLen

typedef ByteCount ByteCount TextPtr ByteCount ByteCount *	oDestConvLen

typedef ByteCount ByteCount TextPtr ByteCount ByteCount LogicalAddress	iInfoPtr

typedef ByteCount ByteCount TextPtr ByteCount ByteCount LogicalAddress ConstUnicodeMappingPtr	iUnicodeMappingPtr

Enumerations
enum	{ kUnicodeUseLatestMapping = -1 , kUnicodeUseHFSPlusMapping = 4 }

enum	{ kUnicodeUseFallbacksBit = 0 , kUnicodeKeepInfoBit = 1 , kUnicodeDirectionalityBits = 2 , kUnicodeVerticalFormBit = 4 , kUnicodeLooseMappingsBit = 5 , kUnicodeStringUnterminatedBit = 6 , kUnicodeTextRunBit = 7 , kUnicodeKeepSameEncodingBit = 8 , kUnicodeForceASCIIRangeBit = 9 , kUnicodeNoHalfwidthCharsBit = 10 , kUnicodeTextRunHeuristicsBit = 11 }

enum	{ kUnicodeUseFallbacksMask = 1L << kUnicodeUseFallbacksBit , kUnicodeKeepInfoMask = 1L << kUnicodeKeepInfoBit , kUnicodeDirectionalityMask = 3L << kUnicodeDirectionalityBits , kUnicodeVerticalFormMask = 1L << kUnicodeVerticalFormBit , kUnicodeLooseMappingsMask = 1L << kUnicodeLooseMappingsBit , kUnicodeStringUnterminatedMask = 1L << kUnicodeStringUnterminatedBit , kUnicodeTextRunMask = 1L << kUnicodeTextRunBit , kUnicodeKeepSameEncodingMask = 1L << kUnicodeKeepSameEncodingBit , kUnicodeForceASCIIRangeMask = 1L << kUnicodeForceASCIIRangeBit , kUnicodeNoHalfwidthCharsMask = 1L << kUnicodeNoHalfwidthCharsBit , kUnicodeTextRunHeuristicsMask = 1L << kUnicodeTextRunHeuristicsBit }

enum	{ kUnicodeDefaultDirection = 0 , kUnicodeLeftToRight = 1 , kUnicodeRightToLeft = 2 }

enum	{ kUnicodeDefaultDirectionMask , kUnicodeLeftToRightMask = kUnicodeLeftToRight << kUnicodeDirectionalityBits , kUnicodeRightToLeftMask = kUnicodeRightToLeft << kUnicodeDirectionalityBits }

enum	{ kUnicodeMatchUnicodeBaseBit = 0 , kUnicodeMatchUnicodeVariantBit = 1 , kUnicodeMatchUnicodeFormatBit = 2 , kUnicodeMatchOtherBaseBit = 3 , kUnicodeMatchOtherVariantBit = 4 , kUnicodeMatchOtherFormatBit = 5 }

enum	{ kUnicodeMatchUnicodeBaseMask = 1L << kUnicodeMatchUnicodeBaseBit , kUnicodeMatchUnicodeVariantMask = 1L << kUnicodeMatchUnicodeVariantBit , kUnicodeMatchUnicodeFormatMask = 1L << kUnicodeMatchUnicodeFormatBit , kUnicodeMatchOtherBaseMask = 1L << kUnicodeMatchOtherBaseBit , kUnicodeMatchOtherVariantMask = 1L << kUnicodeMatchOtherVariantBit , kUnicodeMatchOtherFormatMask = 1L << kUnicodeMatchOtherFormatBit }

enum	{ kUnicodeFallbackSequencingBits = 0 }

enum	{ kUnicodeFallbackSequencingMask = 3L << kUnicodeFallbackSequencingBits , kUnicodeFallbackInterruptSafeMask }

enum	{ kUnicodeFallbackDefaultOnly = 0L , kUnicodeFallbackCustomOnly = 1L , kUnicodeFallbackDefaultFirst = 2L , kUnicodeFallbackCustomFirst = 3L }

enum	{ uppUnicodeToTextFallbackProcInfo = 0x003FFFF0 }

Functions
typedef	CALLBACK_API (OSStatus, UnicodeToTextFallbackProcPtr)(UniChar *iSrcUniStr

typedef	STACK_UPP_TYPE (UnicodeToTextFallbackProcPtr) UnicodeToTextFallbackUPP

UnicodeToTextFallbackUPP	NewUnicodeToTextFallbackUPP (UnicodeToTextFallbackProcPtr userRoutine)

void	DisposeUnicodeToTextFallbackUPP (UnicodeToTextFallbackUPP userUPP)

OSStatus	InvokeUnicodeToTextFallbackUPP (UniChar iSrcUniStr, ByteCount iSrcUniStrLen, ByteCount oSrcConvLen, TextPtr oDestStr, ByteCount iDestStrLen, ByteCount *oDestConvLen, LogicalAddress iInfoPtr, ConstUnicodeMappingPtr iUnicodeMappingPtr, UnicodeToTextFallbackUPP userUPP)

OSStatus	CreateTextToUnicodeInfo (ConstUnicodeMappingPtr iUnicodeMapping, TextToUnicodeInfo *oTextToUnicodeInfo)

OSStatus	CreateTextToUnicodeInfoByEncoding (TextEncoding iEncoding, TextToUnicodeInfo *oTextToUnicodeInfo)

OSStatus	CreateUnicodeToTextInfo (ConstUnicodeMappingPtr iUnicodeMapping, UnicodeToTextInfo *oUnicodeToTextInfo)

OSStatus	CreateUnicodeToTextInfoByEncoding (TextEncoding iEncoding, UnicodeToTextInfo *oUnicodeToTextInfo)

OSStatus	CreateUnicodeToTextRunInfo (ItemCount iNumberOfMappings, const UnicodeMapping iUnicodeMappings[], UnicodeToTextRunInfo *oUnicodeToTextInfo)

OSStatus	CreateUnicodeToTextRunInfoByEncoding (ItemCount iNumberOfEncodings, const TextEncoding iEncodings[], UnicodeToTextRunInfo *oUnicodeToTextInfo)

OSStatus	CreateUnicodeToTextRunInfoByScriptCode (ItemCount iNumberOfScriptCodes, const ScriptCode iScripts[], UnicodeToTextRunInfo *oUnicodeToTextInfo)

OSStatus	ChangeTextToUnicodeInfo (TextToUnicodeInfo ioTextToUnicodeInfo, ConstUnicodeMappingPtr iUnicodeMapping)

OSStatus	ChangeUnicodeToTextInfo (UnicodeToTextInfo ioUnicodeToTextInfo, ConstUnicodeMappingPtr iUnicodeMapping)

OSStatus	DisposeTextToUnicodeInfo (TextToUnicodeInfo *ioTextToUnicodeInfo)

OSStatus	DisposeUnicodeToTextInfo (UnicodeToTextInfo *ioUnicodeToTextInfo)

OSStatus	DisposeUnicodeToTextRunInfo (UnicodeToTextRunInfo *ioUnicodeToTextRunInfo)

OSStatus	ConvertFromTextToUnicode (TextToUnicodeInfo iTextToUnicodeInfo, ByteCount iSourceLen, ConstLogicalAddress iSourceStr, OptionBits iControlFlags, ItemCount iOffsetCount, ByteOffset iOffsetArray[], ItemCount oOffsetCount, ByteOffset oOffsetArray[], ByteCount iOutputBufLen, ByteCount oSourceRead, ByteCount *oUnicodeLen, UniChar oUnicodeStr[])

OSStatus	ConvertFromUnicodeToText (UnicodeToTextInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, const UniChar iUnicodeStr[], OptionBits iControlFlags, ItemCount iOffsetCount, ByteOffset iOffsetArray[], ItemCount oOffsetCount, ByteOffset oOffsetArray[], ByteCount iOutputBufLen, ByteCount oInputRead, ByteCount *oOutputLen, LogicalAddress oOutputStr)

OSStatus	ConvertFromUnicodeToTextRun (UnicodeToTextRunInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, const UniChar iUnicodeStr[], OptionBits iControlFlags, ItemCount iOffsetCount, ByteOffset iOffsetArray[], ItemCount oOffsetCount, ByteOffset oOffsetArray[], ByteCount iOutputBufLen, ByteCount oInputRead, ByteCount oOutputLen, LogicalAddress oOutputStr, ItemCount iEncodingRunBufLen, ItemCount oEncodingRunOutLen, TextEncodingRun oEncodingRuns[])

OSStatus	ConvertFromUnicodeToScriptCodeRun (UnicodeToTextRunInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, const UniChar iUnicodeStr[], OptionBits iControlFlags, ItemCount iOffsetCount, ByteOffset iOffsetArray[], ItemCount oOffsetCount, ByteOffset oOffsetArray[], ByteCount iOutputBufLen, ByteCount oInputRead, ByteCount oOutputLen, LogicalAddress oOutputStr, ItemCount iScriptRunBufLen, ItemCount oScriptRunOutLen, ScriptCodeRun oScriptCodeRuns[])

OSStatus	TruncateForTextToUnicode (ConstTextToUnicodeInfo iTextToUnicodeInfo, ByteCount iSourceLen, ConstLogicalAddress iSourceStr, ByteCount iMaxLen, ByteCount *oTruncatedLen)

OSStatus	TruncateForUnicodeToText (ConstUnicodeToTextInfo iUnicodeToTextInfo, ByteCount iSourceLen, const UniChar iSourceStr[], OptionBits iControlFlags, ByteCount iMaxLen, ByteCount *oTruncatedLen)

OSStatus	ConvertFromPStringToUnicode (TextToUnicodeInfo iTextToUnicodeInfo, ConstStr255Param iPascalStr, ByteCount iOutputBufLen, ByteCount *oUnicodeLen, UniChar oUnicodeStr[])

OSStatus	ConvertFromUnicodeToPString (UnicodeToTextInfo iUnicodeToTextInfo, ByteCount iUnicodeLen, const UniChar iUnicodeStr[], Str255 oPascalStr)

OSStatus	CountUnicodeMappings (OptionBits iFilter, ConstUnicodeMappingPtr iFindMapping, ItemCount *oActualCount)

OSStatus	QueryUnicodeMappings (OptionBits iFilter, ConstUnicodeMappingPtr iFindMapping, ItemCount iMaxCount, ItemCount *oActualCount, UnicodeMapping oReturnedMappings[])

OSStatus	SetFallbackUnicodeToText (UnicodeToTextInfo iUnicodeToTextInfo, UnicodeToTextFallbackUPP iFallback, OptionBits iControlFlags, LogicalAddress iInfoPtr)

OSStatus	SetFallbackUnicodeToTextRun (UnicodeToTextRunInfo iUnicodeToTextRunInfo, UnicodeToTextFallbackUPP iFallback, OptionBits iControlFlags, LogicalAddress iInfoPtr)

OSStatus	ResetTextToUnicodeInfo (TextToUnicodeInfo ioTextToUnicodeInfo)

OSStatus	ResetUnicodeToTextInfo (UnicodeToTextInfo ioUnicodeToTextInfo)

OSStatus	ResetUnicodeToTextRunInfo (UnicodeToTextRunInfo ioUnicodeToTextRunInfo)

Detailed Description

Types, constants, and prototypes for Unicode Converter.

Introduced In: Mac OS 9.0

Avaliable From: Universal Interfaces 3.4.1

Copyright: © 1994-2001 by Apple Computer, Inc., all rights reserved.

For bug reports, consult the following page on the World Wide Web:

http://developer.apple.com/bugreporter/

Macro Definition Documentation

◆ CallUnicodeToTextFallbackProc

#define CallUnicodeToTextFallbackProc	(	userRoutine,
		iSrcUniStr,
		iSrcUniStrLen,
		oSrcConvLen,
		oDestStr,
		iDestStrLen,
		oDestConvLen,
		iInfoPtr,
		iUnicodeMappingPtr
	)

Value:

  InvokeUnicodeToTextFallbackUPP(iSrcUniStr, iSrcUniStrLen, oSrcConvLen,       \
                                 oDestStr, iDestStrLen, oDestConvLen,          \
                                 iInfoPtr, iUnicodeMappingPtr, userRoutine)

◆ InvokeUnicodeToTextFallbackUPP

#define InvokeUnicodeToTextFallbackUPP	(	iSrcUniStr,
		iSrcUniStrLen,
		oSrcConvLen,
		oDestStr,
		iDestStrLen,
		oDestConvLen,
		iInfoPtr,
		iUnicodeMappingPtr,
		userUPP
	)

Value:

  (OSStatus) CALL_EIGHT_PARAMETER_UPP(                                         \
      (userUPP), uppUnicodeToTextFallbackProcInfo, (iSrcUniStr),               \
      (iSrcUniStrLen), (oSrcConvLen), (oDestStr), (iDestStrLen),               \
      (oDestConvLen), (iInfoPtr), (iUnicodeMappingPtr))

◆ NewUnicodeToTextFallbackProc

#define NewUnicodeToTextFallbackProc ( userRoutine ) NewUnicodeToTextFallbackUPP(userRoutine)

support for pre-Carbon UPP routines: New...Proc and Call...Proc

◆ NewUnicodeToTextFallbackUPP

#define NewUnicodeToTextFallbackUPP ( userRoutine )

Value:

  (UnicodeToTextFallbackUPP) NewRoutineDescriptor(                             \
      (ProcPtr)(userRoutine), uppUnicodeToTextFallbackProcInfo,                \
      GetCurrentArchitecture())

pascal 4_bytes Func(4_bytes, 4_bytes, 4_bytes, 4_bytes, 4_bytes, 4_bytes, 4_bytes, 4_bytes)

Typedef Documentation

◆ TextToUnicodeInfo

typedef struct OpaqueTextToUnicodeInfo* TextToUnicodeInfo

Unicode conversion contexts:

◆ UnicodeMapVersion

typedef SInt32 UnicodeMapVersion

UnicodeMapVersion type & values

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Control flags for ConvertFromUnicodeToText and ConvertFromTextToUnicode

◆ anonymous enum

anonymous enum

Values for kUnicodeDirectionality field

◆ anonymous enum

anonymous enum

Directionality masks for control flags

◆ anonymous enum

anonymous enum

Control flags for TruncateForUnicodeToText: Now TruncateForUnicodeToText uses control flags from the same set as used by ConvertFromTextToUnicode, ConvertFromUnicodeToText, etc., but only kUnicodeStringUnterminatedMask is meaningful for TruncateForUnicodeToText.

Previously two special control flags were defined for TruncateForUnicodeToText: kUnicodeTextElementSafeBit = 0 kUnicodeRestartSafeBit = 1 However, neither of these was implemented. Instead of implementing kUnicodeTextElementSafeBit, we now use kUnicodeStringUnterminatedMask since it accomplishes the same thing and avoids having special flags just for TruncateForUnicodeToText Also, kUnicodeRestartSafeBit is unnecessary, since restart-safeness is handled by setting kUnicodeKeepInfoBit with ConvertFromUnicodeToText. If TruncateForUnicodeToText is called with one or both of the old special control flags set (bits 0 or 1), it will not generate a paramErr, but the old bits have no effect on its operation. Filter bits for filter field in QueryUnicodeMappings and CountUnicodeMappings:

◆ anonymous enum

anonymous enum

Control flags for SetFallbackUnicodeToText

◆ anonymous enum

anonymous enum

values for kUnicodeFallbackSequencing field

Function Documentation

◆ CALLBACK_API()

typedef CALLBACK_API	(	OSStatus	,
		UnicodeToTextFallbackProcPtr
	)

Caller-supplied entry point to a fallback handler

◆ ChangeTextToUnicodeInfo()

OSStatus ChangeTextToUnicodeInfo	(	TextToUnicodeInfo	ioTextToUnicodeInfo,
		ConstUnicodeMappingPtr	iUnicodeMapping
	)

Change the TextToUnicodeInfo to another mapping. ChangeTextToUnicodeInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ ChangeUnicodeToTextInfo()

OSStatus ChangeUnicodeToTextInfo	(	UnicodeToTextInfo	ioUnicodeToTextInfo,
		ConstUnicodeMappingPtr	iUnicodeMapping
	)

Change the UnicodeToTextInfo to another mapping. ChangeUnicodeToTextInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ ConvertFromPStringToUnicode()

OSStatus ConvertFromPStringToUnicode	(	TextToUnicodeInfo	iTextToUnicodeInfo,
		ConstStr255Param	iPascalStr,
		ByteCount	iOutputBufLen,
		ByteCount *	oUnicodeLen,
		UniChar	oUnicodeStr[]
	)

Convert a Pascal string to Unicode string. ConvertFromPStringToUnicode()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ ConvertFromTextToUnicode()

OSStatus ConvertFromTextToUnicode	(	TextToUnicodeInfo	iTextToUnicodeInfo,
		ByteCount	iSourceLen,
		ConstLogicalAddress	iSourceStr,
		OptionBits	iControlFlags,
		ItemCount	iOffsetCount,
		ByteOffset	iOffsetArray[],
		ItemCount *	oOffsetCount,
		ByteOffset	oOffsetArray[],
		ByteCount	iOutputBufLen,
		ByteCount *	oSourceRead,
		ByteCount *	oUnicodeLen,
		UniChar	oUnicodeStr[]
	)

ConvertFromTextToUnicode()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

Parameters

oOffsetCount	can be NULL
oOffsetArray	can be NULL
iOutputBufLen	can be NULL

◆ ConvertFromUnicodeToPString()

OSStatus ConvertFromUnicodeToPString	(	UnicodeToTextInfo	iUnicodeToTextInfo,
		ByteCount	iUnicodeLen,
		const UniChar	iUnicodeStr[],
		Str255	oPascalStr
	)

Convert a Unicode string to Pascal string. ConvertFromUnicodeToPString()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ ConvertFromUnicodeToScriptCodeRun()

OSStatus ConvertFromUnicodeToScriptCodeRun	(	UnicodeToTextRunInfo	iUnicodeToTextInfo,
		ByteCount	iUnicodeLen,
		const UniChar	iUnicodeStr[],
		OptionBits	iControlFlags,
		ItemCount	iOffsetCount,
		ByteOffset	iOffsetArray[],
		ItemCount *	oOffsetCount,
		ByteOffset	oOffsetArray[],
		ByteCount	iOutputBufLen,
		ByteCount *	oInputRead,
		ByteCount *	oOutputLen,
		LogicalAddress	oOutputStr,
		ItemCount	iScriptRunBufLen,
		ItemCount *	oScriptRunOutLen,
		ScriptCodeRun	oScriptCodeRuns[]
	)

ConvertFromUnicodeToScriptCodeRun()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

Parameters

oOffsetCount	can be NULL
oOffsetArray	can be NULL
iOutputBufLen	can be NULL

◆ ConvertFromUnicodeToText()

OSStatus ConvertFromUnicodeToText	(	UnicodeToTextInfo	iUnicodeToTextInfo,
		ByteCount	iUnicodeLen,
		const UniChar	iUnicodeStr[],
		OptionBits	iControlFlags,
		ItemCount	iOffsetCount,
		ByteOffset	iOffsetArray[],
		ItemCount *	oOffsetCount,
		ByteOffset	oOffsetArray[],
		ByteCount	iOutputBufLen,
		ByteCount *	oInputRead,
		ByteCount *	oOutputLen,
		LogicalAddress	oOutputStr
	)

ConvertFromUnicodeToText()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

Parameters

oOffsetCount	can be NULL
oOffsetArray	can be NULL
iOutputBufLen	can be NULL

◆ ConvertFromUnicodeToTextRun()

OSStatus ConvertFromUnicodeToTextRun	(	UnicodeToTextRunInfo	iUnicodeToTextInfo,
		ByteCount	iUnicodeLen,
		const UniChar	iUnicodeStr[],
		OptionBits	iControlFlags,
		ItemCount	iOffsetCount,
		ByteOffset	iOffsetArray[],
		ItemCount *	oOffsetCount,
		ByteOffset	oOffsetArray[],
		ByteCount	iOutputBufLen,
		ByteCount *	oInputRead,
		ByteCount *	oOutputLen,
		LogicalAddress	oOutputStr,
		ItemCount	iEncodingRunBufLen,
		ItemCount *	oEncodingRunOutLen,
		TextEncodingRun	oEncodingRuns[]
	)

ConvertFromUnicodeToTextRun()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

Parameters

oOffsetCount	can be NULL
oOffsetArray	can be NULL
iOutputBufLen	can be NULL

◆ CountUnicodeMappings()

OSStatus CountUnicodeMappings	(	OptionBits	iFilter,
		ConstUnicodeMappingPtr	iFindMapping,
		ItemCount *	oActualCount
	)

Count the available conversion mappings. CountUnicodeMappings()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ CreateTextToUnicodeInfo()

OSStatus CreateTextToUnicodeInfo	(	ConstUnicodeMappingPtr	iUnicodeMapping,
		TextToUnicodeInfo *	oTextToUnicodeInfo
	)

CALL_NOT_IN_CARBON Function prototypes TARGET_CPU_68K && !TARGET_RT_MAC_CFM CreateTextToUnicodeInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ CreateTextToUnicodeInfoByEncoding()

OSStatus CreateTextToUnicodeInfoByEncoding	(	TextEncoding	iEncoding,
		TextToUnicodeInfo *	oTextToUnicodeInfo
	)

CreateTextToUnicodeInfoByEncoding()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ CreateUnicodeToTextInfo()

OSStatus CreateUnicodeToTextInfo	(	ConstUnicodeMappingPtr	iUnicodeMapping,
		UnicodeToTextInfo *	oUnicodeToTextInfo
	)

CreateUnicodeToTextInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ CreateUnicodeToTextInfoByEncoding()

OSStatus CreateUnicodeToTextInfoByEncoding	(	TextEncoding	iEncoding,
		UnicodeToTextInfo *	oUnicodeToTextInfo
	)

CreateUnicodeToTextInfoByEncoding()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ CreateUnicodeToTextRunInfo()

OSStatus CreateUnicodeToTextRunInfo	(	ItemCount	iNumberOfMappings,
		const UnicodeMapping	iUnicodeMappings[],
		UnicodeToTextRunInfo *	oUnicodeToTextInfo
	)

CreateUnicodeToTextRunInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ CreateUnicodeToTextRunInfoByEncoding()

OSStatus CreateUnicodeToTextRunInfoByEncoding	(	ItemCount	iNumberOfEncodings,
		const TextEncoding	iEncodings[],
		UnicodeToTextRunInfo *	oUnicodeToTextInfo
	)

CreateUnicodeToTextRunInfoByEncoding()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ CreateUnicodeToTextRunInfoByScriptCode()

OSStatus CreateUnicodeToTextRunInfoByScriptCode	(	ItemCount	iNumberOfScriptCodes,
		const ScriptCode	iScripts[],
		UnicodeToTextRunInfo *	oUnicodeToTextInfo
	)

CreateUnicodeToTextRunInfoByScriptCode()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ DisposeTextToUnicodeInfo()

OSStatus DisposeTextToUnicodeInfo ( TextToUnicodeInfo * ioTextToUnicodeInfo )

DisposeTextToUnicodeInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ DisposeUnicodeToTextFallbackUPP()

void DisposeUnicodeToTextFallbackUPP ( UnicodeToTextFallbackUPP userUPP )

DisposeUnicodeToTextFallbackUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ DisposeUnicodeToTextInfo()

OSStatus DisposeUnicodeToTextInfo ( UnicodeToTextInfo * ioUnicodeToTextInfo )

DisposeUnicodeToTextInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ DisposeUnicodeToTextRunInfo()

OSStatus DisposeUnicodeToTextRunInfo ( UnicodeToTextRunInfo * ioUnicodeToTextRunInfo )

DisposeUnicodeToTextRunInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ InvokeUnicodeToTextFallbackUPP()

OSStatus InvokeUnicodeToTextFallbackUPP	(	UniChar *	iSrcUniStr,
		ByteCount	iSrcUniStrLen,
		ByteCount *	oSrcConvLen,
		TextPtr	oDestStr,
		ByteCount	iDestStrLen,
		ByteCount *	oDestConvLen,
		LogicalAddress	iInfoPtr,
		ConstUnicodeMappingPtr	iUnicodeMappingPtr,
		UnicodeToTextFallbackUPP	userUPP
	)

InvokeUnicodeToTextFallbackUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ NewUnicodeToTextFallbackUPP()

UnicodeToTextFallbackUPP NewUnicodeToTextFallbackUPP ( UnicodeToTextFallbackProcPtr userRoutine )

NewUnicodeToTextFallbackUPP()

Non-Carbon CFM: available as macro/inline

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ QueryUnicodeMappings()

OSStatus QueryUnicodeMappings	(	OptionBits	iFilter,
		ConstUnicodeMappingPtr	iFindMapping,
		ItemCount	iMaxCount,
		ItemCount *	oActualCount,
		UnicodeMapping	oReturnedMappings[]
	)

Get a list of the available conversion mappings. QueryUnicodeMappings()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ ResetTextToUnicodeInfo()

OSStatus ResetTextToUnicodeInfo ( TextToUnicodeInfo ioTextToUnicodeInfo )

Re-initialize all state information kept by the context objects. ResetTextToUnicodeInfo()

Non-Carbon CFM: in UnicodeConverter 1.3 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ ResetUnicodeToTextInfo()

OSStatus ResetUnicodeToTextInfo ( UnicodeToTextInfo ioUnicodeToTextInfo )

Re-initialize all state information kept by the context objects. ResetUnicodeToTextInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ ResetUnicodeToTextRunInfo()

OSStatus ResetUnicodeToTextRunInfo ( UnicodeToTextRunInfo ioUnicodeToTextRunInfo )

Re-initialize all state information kept by the context objects in TextRun conversions. ResetUnicodeToTextRunInfo()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ SetFallbackUnicodeToText()

OSStatus SetFallbackUnicodeToText	(	UnicodeToTextInfo	iUnicodeToTextInfo,
		UnicodeToTextFallbackUPP	iFallback,
		OptionBits	iControlFlags,
		LogicalAddress	iInfoPtr
	)

Setup the fallback handler for converting Unicode To Text. SetFallbackUnicodeToText()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ SetFallbackUnicodeToTextRun()

OSStatus SetFallbackUnicodeToTextRun	(	UnicodeToTextRunInfo	iUnicodeToTextRunInfo,
		UnicodeToTextFallbackUPP	iFallback,
		OptionBits	iControlFlags,
		LogicalAddress	iInfoPtr
	)

Setup the fallback handler for converting Unicode To TextRuns. SetFallbackUnicodeToTextRun()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ TruncateForTextToUnicode()

OSStatus TruncateForTextToUnicode	(	ConstTextToUnicodeInfo	iTextToUnicodeInfo,
		ByteCount	iSourceLen,
		ConstLogicalAddress	iSourceStr,
		ByteCount	iMaxLen,
		ByteCount *	oTruncatedLen
	)

Truncate a multibyte string at a safe place. TruncateForTextToUnicode()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

◆ TruncateForUnicodeToText()

OSStatus TruncateForUnicodeToText	(	ConstUnicodeToTextInfo	iUnicodeToTextInfo,
		ByteCount	iSourceLen,
		const UniChar	iSourceStr[],
		OptionBits	iControlFlags,
		ByteCount	iMaxLen,
		ByteCount *	oTruncatedLen
	)

Truncate a Unicode string at a safe place. TruncateForUnicodeToText()

Non-Carbon CFM: in UnicodeConverter 1.1 and later

Carbon Lib: in CarbonLib 1.0 and later

Mac OS X: in version 10.0 and later

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ CallUnicodeToTextFallbackProc

◆ InvokeUnicodeToTextFallbackUPP

◆ NewUnicodeToTextFallbackProc

◆ NewUnicodeToTextFallbackUPP

Typedef Documentation

◆ TextToUnicodeInfo

◆ UnicodeMapVersion

Enumeration Type Documentation

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

◆ anonymous enum

Function Documentation

◆ CALLBACK_API()

◆ ChangeTextToUnicodeInfo()

◆ ChangeUnicodeToTextInfo()

◆ ConvertFromPStringToUnicode()

◆ ConvertFromTextToUnicode()

◆ ConvertFromUnicodeToPString()

◆ ConvertFromUnicodeToScriptCodeRun()

◆ ConvertFromUnicodeToText()

◆ ConvertFromUnicodeToTextRun()

◆ CountUnicodeMappings()

◆ CreateTextToUnicodeInfo()

◆ CreateTextToUnicodeInfoByEncoding()

◆ CreateUnicodeToTextInfo()

◆ CreateUnicodeToTextInfoByEncoding()

◆ CreateUnicodeToTextRunInfo()

◆ CreateUnicodeToTextRunInfoByEncoding()

◆ CreateUnicodeToTextRunInfoByScriptCode()

◆ DisposeTextToUnicodeInfo()

◆ DisposeUnicodeToTextFallbackUPP()

◆ DisposeUnicodeToTextInfo()

◆ DisposeUnicodeToTextRunInfo()

◆ InvokeUnicodeToTextFallbackUPP()

◆ NewUnicodeToTextFallbackUPP()

◆ QueryUnicodeMappings()

◆ ResetTextToUnicodeInfo()

◆ ResetUnicodeToTextInfo()

◆ ResetUnicodeToTextRunInfo()

◆ SetFallbackUnicodeToText()

◆ SetFallbackUnicodeToTextRun()

◆ TruncateForTextToUnicode()

◆ TruncateForUnicodeToText()