convert_utf.h File Reference

Support for unicode builds. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Defines
#define	UNI_REPLACEMENT_CHAR   (UTF32)0x0000FFFD
#define	UNI_MAX_BMP   (UTF32)0x0000FFFF
#define	UNI_MAX_UTF16   (UTF32)0x0010FFFF
#define	UNI_MAX_UTF32   (UTF32)0x7FFFFFFF
#define	UNI_MAX_LEGAL_UTF32   (UTF32)0x0010FFFF
Typedefs
typedef unsigned long	UTF32
typedef unsigned short	UTF16
typedef unsigned char	UTF8
typedef unsigned char	Booleano
Enumerations
enum	ConversionResult { conversionOK, sourceExhausted, targetExhausted, sourceIllegal }
enum	ConversionFlags { strictConversion = 0, lenientConversion }
Functions
ConversionResult	ConvertUTF8toUTF16 (const UTF8 **sourceStart, const UTF8 *sourceEnd, UTF16 **targetStart, UTF16 *targetEnd, ConversionFlags flags)
ConversionResult	ConvertUTF16toUTF8 (const UTF16 **sourceStart, const UTF16 *sourceEnd, UTF8 **targetStart, UTF8 *targetEnd, ConversionFlags flags)
ConversionResult	ConvertUTF8toUTF32 (const UTF8 **sourceStart, const UTF8 *sourceEnd, UTF32 **targetStart, UTF32 *targetEnd, ConversionFlags flags)
ConversionResult	ConvertUTF32toUTF8 (const UTF32 **sourceStart, const UTF32 *sourceEnd, UTF8 **targetStart, UTF8 *targetEnd, ConversionFlags flags)
ConversionResult	ConvertUTF16toUTF32 (const UTF16 **sourceStart, const UTF16 *sourceEnd, UTF32 **targetStart, UTF32 *targetEnd, ConversionFlags flags)
ConversionResult	ConvertUTF32toUTF16 (const UTF32 **sourceStart, const UTF32 *sourceEnd, UTF16 **targetStart, UTF16 *targetEnd, ConversionFlags flags)
Booleano	isLegalUTF8Sequence (const UTF8 *source, const UTF8 *sourceEnd)

---

Detailed Description

Support for unicode builds.

Definition in file convert_utf.h.

---

Define Documentation

#define UNI_MAX_BMP   (UTF32)0x0000FFFF

Definition at line 123 of file convert_utf.h.

Referenced by ConvertUTF32toUTF16(), and ConvertUTF8toUTF16().

#define UNI_MAX_LEGAL_UTF32   (UTF32)0x0010FFFF

Definition at line 126 of file convert_utf.h.

Referenced by ConvertUTF32toUTF16(), ConvertUTF32toUTF8(), and ConvertUTF8toUTF32().

#define UNI_MAX_UTF16   (UTF32)0x0010FFFF

Definition at line 124 of file convert_utf.h.

Referenced by ConvertUTF8toUTF16().

#define UNI_MAX_UTF32   (UTF32)0x7FFFFFFF

Definition at line 125 of file convert_utf.h.

#define UNI_REPLACEMENT_CHAR   (UTF32)0x0000FFFD

Definition at line 122 of file convert_utf.h.

Referenced by ConvertUTF16toUTF8(), ConvertUTF32toUTF16(), ConvertUTF32toUTF8(), ConvertUTF8toUTF16(), and ConvertUTF8toUTF32().

---

Typedef Documentation

typedef unsigned char Booleano

Definition at line 119 of file convert_utf.h.

typedef unsigned short UTF16

Definition at line 117 of file convert_utf.h.

typedef unsigned long UTF32

Definition at line 116 of file convert_utf.h.

typedef unsigned char UTF8

Definition at line 118 of file convert_utf.h.

---

Enumeration Type Documentation

enum ConversionFlags

Enumerator:

strictConversion
lenientConversion

Definition at line 135 of file convert_utf.h.

enum ConversionResult

Enumerator:

conversionOK
sourceExhausted
targetExhausted
sourceIllegal

Definition at line 128 of file convert_utf.h.

---

Function Documentation

ConversionResult ConvertUTF16toUTF32	(	const UTF16 **	sourceStart,
		const UTF16 *	sourceEnd,
		UTF32 **	targetStart,
		UTF32 *	targetEnd,
		ConversionFlags	flags
	)

Definition at line 131 of file convert_utf.cpp.

References conversionOK, sourceExhausted, sourceIllegal, strictConversion, targetExhausted, UNI_SUR_HIGH_END, UNI_SUR_HIGH_START, UNI_SUR_LOW_END, and UNI_SUR_LOW_START.

ConversionResult ConvertUTF16toUTF8	(	const UTF16 **	sourceStart,
		const UTF16 *	sourceEnd,
		UTF8 **	targetStart,
		UTF8 *	targetEnd,
		ConversionFlags	flags
	)

Definition at line 235 of file convert_utf.cpp.

References conversionOK, sourceExhausted, sourceIllegal, strictConversion, targetExhausted, UNI_REPLACEMENT_CHAR, UNI_SUR_HIGH_END, UNI_SUR_HIGH_START, UNI_SUR_LOW_END, and UNI_SUR_LOW_START.

ConversionResult ConvertUTF32toUTF16	(	const UTF32 **	sourceStart,
		const UTF32 *	sourceEnd,
		UTF16 **	targetStart,
		UTF16 *	targetEnd,
		ConversionFlags	flags
	)

Definition at line 82 of file convert_utf.cpp.

References conversionOK, sourceIllegal, strictConversion, targetExhausted, UNI_MAX_BMP, UNI_MAX_LEGAL_UTF32, UNI_REPLACEMENT_CHAR, UNI_SUR_HIGH_START, UNI_SUR_LOW_END, and UNI_SUR_LOW_START.

ConversionResult ConvertUTF32toUTF8	(	const UTF32 **	sourceStart,
		const UTF32 *	sourceEnd,
		UTF8 **	targetStart,
		UTF8 *	targetEnd,
		ConversionFlags	flags
	)

Definition at line 430 of file convert_utf.cpp.

References conversionOK, sourceIllegal, strictConversion, targetExhausted, UNI_MAX_LEGAL_UTF32, UNI_REPLACEMENT_CHAR, UNI_SUR_HIGH_START, and UNI_SUR_LOW_END.

ConversionResult ConvertUTF8toUTF16	(	const UTF8 **	sourceStart,
		const UTF8 *	sourceEnd,
		UTF16 **	targetStart,
		UTF16 *	targetEnd,
		ConversionFlags	flags
	)

Definition at line 357 of file convert_utf.cpp.

References conversionOK, sourceExhausted, sourceIllegal, strictConversion, targetExhausted, UNI_MAX_BMP, UNI_MAX_UTF16, UNI_REPLACEMENT_CHAR, UNI_SUR_HIGH_START, UNI_SUR_LOW_END, and UNI_SUR_LOW_START.

ConversionResult ConvertUTF8toUTF32	(	const UTF8 **	sourceStart,
		const UTF8 *	sourceEnd,
		UTF32 **	targetStart,
		UTF32 *	targetEnd,
		ConversionFlags	flags
	)

Definition at line 483 of file convert_utf.cpp.

References conversionOK, sourceExhausted, sourceIllegal, strictConversion, targetExhausted, UNI_MAX_LEGAL_UTF32, UNI_REPLACEMENT_CHAR, UNI_SUR_HIGH_START, and UNI_SUR_LOW_END.

Booleano isLegalUTF8Sequence	(	const UTF8 *	source,
		const UTF8 *	sourceEnd
	)

Definition at line 347 of file convert_utf.cpp.

---