Simple transcoder for converting between external char and wchar_t strings and internal strings. More...

#include <transcoder.h>

Public Types
enum	{ LOSSCHAR = 0x3F }

Static Public Member Functions
static void	decodeUTF8 (const std::string &src, LogString &dst)
	Appends this specified string of UTF-8 characters to LogString.

static void	encodeUTF8 (const LogString &src, std::string &dst)
	Converts the LogString to a UTF-8 string.

static char *	encodeUTF8 (const LogString &src, log4cxx::helpers::Pool &p)
	Converts the LogString to a UTF-8 string.

static void	encodeUTF8 (unsigned int sv, ByteBuffer &dst)
	Append UCS-4 code point to a byte buffer as UTF-8.

static void	encodeUTF16LE (unsigned int sv, ByteBuffer &dst)
	Append UCS-4 code point to a byte buffer as UTF-16LE.

static void	encodeUTF16BE (unsigned int sv, ByteBuffer &dst)
	Append UCS-4 code point to a byte buffer as UTF-16BE.

static unsigned int	decode (const std::string &in, std::string::const_iterator &iter)
	Decodes next character from a UTF-8 string.

static void	encode (unsigned int ch, std::string &dst)
	Appends UCS-4 value to a UTF-8 string.

static void	decode (const std::string &src, LogString &dst)
	Appends string in the current code-page to a LogString.

static void	encode (const LogString &src, std::string &dst)
	Appends a LogString to a string in the current code-page.

static char *	encode (const LogString &src, log4cxx::helpers::Pool &p)
	Encodes the specified LogString to the current character set.

static void	decode (const std::wstring &src, LogString &dst)

static void	encode (const LogString &src, std::wstring &dst)

static wchar_t *	wencode (const LogString &src, log4cxx::helpers::Pool &p)

static unsigned int	decode (const std::wstring &in, std::wstring::const_iterator &iter)
	Decodes next character from a wstring.

static void	encode (unsigned int ch, std::wstring &dst)
	Appends UCS-4 value to a UTF-8 string.

static void	decode (const std::basic_string< UniChar > &src, LogString &dst)

static void	encode (const LogString &src, std::basic_string< UniChar > &dst)

static unsigned int	decode (const std::basic_string< UniChar > &in, std::basic_string< UniChar >::const_iterator &iter)
	Decodes next character from a UniChar string.

static void	encode (unsigned int ch, std::basic_string< UniChar > &dst)
	Appends UCS-4 value to a UTF-8 string.

static void	decode (const CFStringRef &src, LogString &dst)

static CFStringRef	encode (const LogString &src)

static logchar	decode (char v)
	Returns a logchar value given a character literal in the ASCII charset.

static LogString	decode (const char *v)
	Returns a LogString given a string literal in the ASCII charset.

static std::string	encodeCharsetName (const LogString &charsetName)
	Encodes a charset name in the default encoding without using a CharsetEncoder (which could trigger recursion).

Detailed Description

Simple transcoder for converting between external char and wchar_t strings and internal strings.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum

Enumerator
LOSSCHAR

Member Function Documentation

◆ decode() [1/9]

static logchar log4cxx::helpers::Transcoder::decode ( char v )

static

Returns a logchar value given a character literal in the ASCII charset.

Used to implement the LOG4CXX_STR macro for EBCDIC and UNICHAR.

◆ decode() [2/9]

static void log4cxx::helpers::Transcoder::decode	(	const CFStringRef &	src,
		LogString &	dst
	)

static

◆ decode() [3/9]

static LogString log4cxx::helpers::Transcoder::decode ( const char * v )

static

Returns a LogString given a string literal in the ASCII charset.

Used to implement the LOG4CXX_STR macro for EBCDIC and UNICHAR.

◆ decode() [4/9]

static unsigned int log4cxx::helpers::Transcoder::decode	(	const std::basic_string< UniChar > &	in,
		std::basic_string< UniChar >::const_iterator &	iter
	)

static

Decodes next character from a UniChar string.

Parameters

in	string from which the character is extracted.
iter	iterator addressing start of character, will be advanced to next character if successful.

Returns: scalar value (UCS-4) or 0xFFFF if invalid sequence.

◆ decode() [5/9]

static void log4cxx::helpers::Transcoder::decode	(	const std::basic_string< UniChar > &	src,
		LogString &	dst
	)

static

◆ decode() [6/9]

static unsigned int log4cxx::helpers::Transcoder::decode	(	const std::string &	in,
		std::string::const_iterator &	iter
	)

static

Decodes next character from a UTF-8 string.

Parameters

in	string from which the character is extracted.
iter	iterator addressing start of character, will be advanced to next character if successful.

Returns: scalar value (UCS-4) or 0xFFFF if invalid sequence.

◆ decode() [7/9]

static void log4cxx::helpers::Transcoder::decode	(	const std::string &	src,
		LogString &	dst
	)

static

Appends string in the current code-page to a LogString.

◆ decode() [8/9]

static unsigned int log4cxx::helpers::Transcoder::decode	(	const std::wstring &	in,
		std::wstring::const_iterator &	iter
	)

static

Decodes next character from a wstring.

Parameters

in	string from which the character is extracted.
iter	iterator addressing start of character, will be advanced to next character if successful.

Returns: scalar value (UCS-4) or 0xFFFF if invalid sequence.

◆ decode() [9/9]

static void log4cxx::helpers::Transcoder::decode	(	const std::wstring &	src,
		LogString &	dst
	)

static

◆ decodeUTF8()

static void log4cxx::helpers::Transcoder::decodeUTF8	(	const std::string &	src,
		LogString &	dst
	)

static

Appends this specified string of UTF-8 characters to LogString.

◆ encode() [1/8]

static CFStringRef log4cxx::helpers::Transcoder::encode ( const LogString & src )

static

◆ encode() [2/8]

static char * log4cxx::helpers::Transcoder::encode	(	const LogString &	src,
		log4cxx::helpers::Pool &	p
	)

static

Encodes the specified LogString to the current character set.

Parameters

src	string to encode.
p	pool from which to allocate return value.

Returns: pool allocated string.

◆ encode() [3/8]

static void log4cxx::helpers::Transcoder::encode	(	const LogString &	src,
		std::basic_string< UniChar > &	dst
	)

static

◆ encode() [4/8]

static void log4cxx::helpers::Transcoder::encode	(	const LogString &	src,
		std::string &	dst
	)

static

Appends a LogString to a string in the current code-page.

Unrepresentable characters may be replaced with loss characters.

◆ encode() [5/8]

static void log4cxx::helpers::Transcoder::encode	(	const LogString &	src,
		std::wstring &	dst
	)

static

◆ encode() [6/8]

static void log4cxx::helpers::Transcoder::encode	(	unsigned int	ch,
		std::basic_string< UniChar > &	dst
	)

static

Appends UCS-4 value to a UTF-8 string.

Parameters

ch	UCS-4 value.
dst	destination.

◆ encode() [7/8]

static void log4cxx::helpers::Transcoder::encode	(	unsigned int	ch,
		std::string &	dst
	)

static

Appends UCS-4 value to a UTF-8 string.

Parameters

ch	UCS-4 value.
dst	destination.

◆ encode() [8/8]

static void log4cxx::helpers::Transcoder::encode	(	unsigned int	ch,
		std::wstring &	dst
	)

static

Appends UCS-4 value to a UTF-8 string.

Parameters

ch	UCS-4 value.
dst	destination.

◆ encodeCharsetName()

static std::string log4cxx::helpers::Transcoder::encodeCharsetName ( const LogString & charsetName )

static

Encodes a charset name in the default encoding without using a CharsetEncoder (which could trigger recursion).

◆ encodeUTF16BE()

static void log4cxx::helpers::Transcoder::encodeUTF16BE	(	unsigned int	sv,
		ByteBuffer &	dst
	)

static

Append UCS-4 code point to a byte buffer as UTF-16BE.

◆ encodeUTF16LE()

static void log4cxx::helpers::Transcoder::encodeUTF16LE	(	unsigned int	sv,
		ByteBuffer &	dst
	)

static

Append UCS-4 code point to a byte buffer as UTF-16LE.

◆ encodeUTF8() [1/3]

static char * log4cxx::helpers::Transcoder::encodeUTF8	(	const LogString &	src,
		log4cxx::helpers::Pool &	p
	)

static

Converts the LogString to a UTF-8 string.

◆ encodeUTF8() [2/3]

static void log4cxx::helpers::Transcoder::encodeUTF8	(	const LogString &	src,
		std::string &	dst
	)

static

Converts the LogString to a UTF-8 string.

◆ encodeUTF8() [3/3]

static void log4cxx::helpers::Transcoder::encodeUTF8	(	unsigned int	sv,
		ByteBuffer &	dst
	)

static

Append UCS-4 code point to a byte buffer as UTF-8.

◆ wencode()

static wchar_t * log4cxx::helpers::Transcoder::wencode	(	const LogString &	src,
		log4cxx::helpers::Pool &	p
	)

static

The documentation for this class was generated from the following file:

log4cxx/helpers/transcoder.h

Public Types

Static Public Member Functions

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

Member Function Documentation

◆ decode() [1/9]

◆ decode() [2/9]

◆ decode() [3/9]

◆ decode() [4/9]

◆ decode() [5/9]

◆ decode() [6/9]

◆ decode() [7/9]

◆ decode() [8/9]

◆ decode() [9/9]

◆ decodeUTF8()

◆ encode() [1/8]

◆ encode() [2/8]

◆ encode() [3/8]

◆ encode() [4/8]

◆ encode() [5/8]

◆ encode() [6/8]

◆ encode() [7/8]

◆ encode() [8/8]

◆ encodeCharsetName()

◆ encodeUTF16BE()

◆ encodeUTF16LE()

◆ encodeUTF8() [1/3]

◆ encodeUTF8() [2/3]

◆ encodeUTF8() [3/3]

◆ wencode()