tsk_unicode.h File Reference

Contains the definitions for Unicode-based conversion methods. More...

#include "tsk_base.h"

Unicode
enum	TSKConversionResult { TSKconversionOK, TSKsourceExhausted, TSKtargetExhausted, TSKsourceIllegal }
enum	TSKConversionFlags { TSKstrictConversion = 0, TSKlenientConversion }
typedef unsigned short	UTF16
typedef unsigned char	UTF8
typedef unsigned char	Boolean
TSKConversionResult	tsk_UTF8toUTF16 (const UTF8 **sourceStart, const UTF8 *sourceEnd, UTF16 **targetStart, UTF16 *targetEnd, TSKConversionFlags flags)
	Convert a UTF-8 string to UTF-16 (in local endian ordering). More...
TSKConversionResult	tsk_UTF16toUTF8 (TSK_ENDIAN_ENUM, const UTF16 **sourceStart, const UTF16 *sourceEnd, UTF8 **targetStart, UTF8 *targetEnd, TSKConversionFlags flags)
	Convert a UTF-16 string to UTF-8. More...
TSKConversionResult	tsk_UTF16toUTF8_lclorder (const UTF16 **sourceStart, const UTF16 *sourceEnd, UTF8 **targetStart, UTF8 *targetEnd, TSKConversionFlags flags)
	Convert a UTF-16 string in local endian ordering to UTF-8. More...
TSKConversionResult	tsk_UTF16WtoUTF8_lclorder (const wchar_t **sourceStart, const wchar_t *sourceEnd, UTF8 **targetStart, UTF8 *targetEnd, TSKConversionFlags flags)
Boolean	tsk_isLegalUTF8Sequence (const UTF8 *source, const UTF8 *sourceEnd)
void	tsk_cleanupUTF8 (char *source, const char replacement)
	Cleans up the passed in string to replace invalid UTF-8 values with the passed in character. More...

Detailed Description

Contains the definitions for Unicode-based conversion methods.

Enumeration Type Documentation

enum TSKConversionFlags

Enumerator
TSKstrictConversion	Error if invalid surrogate pairs are found.
TSKlenientConversion	Ignore invalid surrogate pairs.

enum TSKConversionResult

Enumerator
TSKconversionOK	conversion successful
TSKsourceExhausted	partial character in source, but hit end
TSKtargetExhausted	insuff. room in target for conversion
TSKsourceIllegal	source sequence is illegal/malformed

Function Documentation

void tsk_cleanupUTF8	(	char *	source,
		const char	replacement
	)

Cleans up the passed in string to replace invalid UTF-8 values with the passed in character.

Parameters

source	String to be cleaned up
replacement	Character to insert into source as needed.