MeVis/Foundation/Sources/MLUtilities/mlUnicode.h File Reference

Defines mapping functions from local strings to unicode and vice-versa. More...

#include "mlUtilsSystem.h"

Go to the source code of this file.

Functions

Unicode string conversion

ML_UTILS_EXPORT MLuint16 * MLConvertUTF8ToUTF16 (const char *inputString)

Thread-safety: These functions are reentrant.

ML_UTILS_EXPORT MLuint32 * MLConvertUTF8ToUTF32 (const char *inputString)

Converts the given char string inputString (UTF8, terminated by 0) to UTF32, returns a newly allocated string that must be freed with MLFree(), returns NULL on error.

ML_UTILS_EXPORT char * MLConvertUTF16ToUTF8 (const MLuint16 *inputWideString)

Converts the given wide string inputWideString (UTF16, terminated by 0) to UTF8, returns a newly allocated wide string that must be freed with MLFree(), returns NULL on error.

ML_UTILS_EXPORT char * MLConvertUTF8ToLatin1 (const char *inputUTFString)

Converts the given UTF8 encoded and null terminated string inputUTFString to a Latin1 string, converting all non Latin1 chars to '?', the returned string must be freed with MLFree(), returns NULL on error.

ML_UTILS_EXPORT char * MLConvertUTF16ToLatin1 (const MLuint16 *inputUTF16WideString)

Converts the given UTF16 encoded wide and null terminated string inputUTF16WideString to a Latin1 string, converting all non Latin1 chars to '?', the returned string must be freed with MLFree(), returns NULL on error.

ML_UTILS_EXPORT char * MLConvertLatin1ToUTF8 (const char *inputLatin1String)

Converts the given Latin1 encoded and null terminated string inputLatin1String into a UTF8 string, the returned string must be freed with MLFree(), returns NULL on error.

ML_UTILS_EXPORT MLuint16 * MLConvertLatin1ToUTF16 (const char *inputLatin1String)

Convert the given Latin1 encoded and null terminated string inputLatin1String to a UTF16 string, the returned string must be freed with MLFree(), returns NULL on error.

Detailed Description

Defines mapping functions from local strings to unicode and vice-versa.

Note that this file needs is considered part of the mlUtils API and needs to be included explicitly, because it is no default include of mlUtils.h.

Author:: Florian Link

Date:: 09/2004

Definition in file mlUnicode.h.


Functions
Unicode string conversion
ML_UTILS_EXPORT MLuint16 *	MLConvertUTF8ToUTF16 (const char *inputString)
	Thread-safety: These functions are reentrant.
ML_UTILS_EXPORT MLuint32 *	MLConvertUTF8ToUTF32 (const char *inputString)
	Converts the given char string `inputString` (UTF8, terminated by 0) to UTF32, returns a newly allocated string that must be freed with MLFree(), returns NULL on error.
ML_UTILS_EXPORT char *	MLConvertUTF16ToUTF8 (const MLuint16 *inputWideString)
	Converts the given wide string `inputWideString` (UTF16, terminated by 0) to UTF8, returns a newly allocated wide string that must be freed with MLFree(), returns NULL on error.
ML_UTILS_EXPORT char *	MLConvertUTF8ToLatin1 (const char *inputUTFString)
	Converts the given UTF8 encoded and null terminated string `inputUTFString` to a Latin1 string, converting all non Latin1 chars to '?', the returned string must be freed with MLFree(), returns NULL on error.
ML_UTILS_EXPORT char *	MLConvertUTF16ToLatin1 (const MLuint16 *inputUTF16WideString)
	Converts the given UTF16 encoded wide and null terminated string `inputUTF16WideString` to a Latin1 string, converting all non Latin1 chars to '?', the returned string must be freed with MLFree(), returns NULL on error.
ML_UTILS_EXPORT char *	MLConvertLatin1ToUTF8 (const char *inputLatin1String)
	Converts the given Latin1 encoded and null terminated string `inputLatin1String` into a UTF8 string, the returned string must be freed with MLFree(), returns NULL on error.
ML_UTILS_EXPORT MLuint16 *	MLConvertLatin1ToUTF16 (const char *inputLatin1String)
	Convert the given Latin1 encoded and null terminated string `inputLatin1String` to a UTF16 string, the returned string must be freed with MLFree(), returns NULL on error.