Apache log4cxx  Version 0.11.0
log4cxx::helpers::CharsetDecoder Class Referenceabstract

An abstract engine to transform a sequences of bytes in a specific charset into a LogString. More...

#include <charsetdecoder.h>

Inheritance diagram for log4cxx::helpers::CharsetDecoder:
log4cxx::helpers::ObjectImpl log4cxx::helpers::Object

Public Member Functions

virtual ~CharsetDecoder ()
 Destructor.
 
virtual log4cxx_status_t decode (ByteBuffer &in, LogString &out)=0
 Decodes as many bytes as possible from the given input buffer, writing the results to the given output string. More...
 
- Public Member Functions inherited from log4cxx::helpers::ObjectImpl
void addRef () const
 
void releaseRef () const
 
- Public Member Functions inherited from log4cxx::helpers::Object
virtual bool instanceof (const Class &clazz) const =0
 
virtual const void * cast (const Class &clazz) const =0
 

Static Public Member Functions

static CharsetDecoderPtr getDefaultDecoder ()
 Get decoder for default charset.
 
static CharsetDecoderPtr getDecoder (const LogString &charset)
 Get decoder for specified character set. More...
 
static CharsetDecoderPtr getUTF8Decoder ()
 Get decoder for UTF-8.
 
static CharsetDecoderPtr getISOLatinDecoder ()
 Get decoder for ISO-8859-1.
 
static bool isError (log4cxx_status_t stat)
 Determins if status value indicates an invalid byte sequence.
 

Protected Member Functions

 CharsetDecoder ()
 Protected constructor.
 

Additional Inherited Members

- Protected Attributes inherited from log4cxx::helpers::ObjectImpl
unsigned int volatile ref
 

Detailed Description

An abstract engine to transform a sequences of bytes in a specific charset into a LogString.

Member Function Documentation

◆ decode()

virtual log4cxx_status_t log4cxx::helpers::CharsetDecoder::decode ( ByteBuffer in,
LogString &  out 
)
pure virtual

Decodes as many bytes as possible from the given input buffer, writing the results to the given output string.

Parameters
ininput buffer.
outoutput string.
Returns
APR_SUCCESS if not encoding errors were found.

◆ getDecoder()

static CharsetDecoderPtr log4cxx::helpers::CharsetDecoder::getDecoder ( const LogString &  charset)
static

Get decoder for specified character set.

Parameters
charsetthe following values should be recognized: "US-ASCII", "ISO-8859-1", "UTF-8", "UTF-16BE", "UTF-16LE".
Returns
decoder
Exceptions
IllegalArgumentExceptionif charset is not recognized.

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