#include <qutfcodec.h>

Inheritance diagram for QUtf8Codec:

Public Member Functions
virtual int	mibEnum () const

const char *	name () const

QTextDecoder *	makeDecoder () const

QCString	fromUnicode (const QString &uc, int &len_in_out) const

int	heuristicContentMatch (const char *chars, int len) const

Public Member Functions inherited from QTextCodec
virtual	~QTextCodec ()

virtual QTextEncoder *	makeEncoder () const

virtual QString	toUnicode (const char *chars, int len) const

QCString	fromUnicode (const QString &uc) const

QString	toUnicode (const QByteArray &, int len) const

QString	toUnicode (const QByteArray &) const

QString	toUnicode (const char *chars) const

virtual bool	canEncode (QChar) const

virtual bool	canEncode (const QString &) const

virtual int	heuristicNameMatch (const char *hint) const

Additional Inherited Members
Static Public Member Functions inherited from QTextCodec
static QTextCodec *	loadCharmap (QIODevice *)

static QTextCodec *	loadCharmapFile (QString filename)

static QTextCodec *	codecForMib (int mib)

static QTextCodec *	codecForName (const char *hint, int accuracy=0)

static QTextCodec *	codecForContent (const char *chars, int len)

static QTextCodec *	codecForIndex (int i)

static QTextCodec *	codecForLocale ()

static void	deleteAllCodecs ()

static const char *	locale ()

Protected Member Functions inherited from QTextCodec
	QTextCodec ()

Static Protected Member Functions inherited from QTextCodec
static int	simpleHeuristicNameMatch (const char name, const char hint)

Detailed Description

Definition at line 47 of file qutfcodec.h.

Member Function Documentation

QCString QUtf8Codec::fromUnicode	(	const QString &	uc,
		int &	lenInOut
	)		const

virtual

Subclasses of QTextCodec must reimplement either this function or makeEncoder(). It converts the first lenInOut characters of uc from Unicode to the encoding of the subclass. If lenInOut is negative or too large, the length of uc is used instead.

The value returned is the property of the caller, which is responsible for deleting it with "delete []". The length of the resulting Unicode character sequence is returned in lenInOut.

The default implementation makes an encoder with makeEncoder() and converts the input with that. Note that the default makeEncoder() implementation makes an encoder that simply calls this function, hence subclasses must reimplement one function or the other to avoid infinite recursion.

Reimplemented from QTextCodec.

Definition at line 47 of file qutfcodec.cpp.

 {
     int l = QMIN((int)uc.length(),len_in_out);
     int rlen = l*3+1;
     QCString rstr(rlen);
     uchar* cursor = (uchar*)rstr.data();
     for (int i=0; i<l; i++) {
         QChar ch = uc[i];
         if ( !ch.row() && ch.cell() < 0x80 ) {
             *cursor++ = ch.cell();
         } else {
             uchar b = (ch.row() << 2) | (ch.cell() >> 6);
             if ( ch.row() < 0x08 ) {
                 *cursor++ = 0xc0 | b;
             } else {
                 *cursor++ = 0xe0 | (ch.row() >> 4);
                 *cursor++ = 0x80 | (b&0x3f);
             }
             *cursor++ = 0x80 | (ch.cell()&0x3f);
         }
     }
     len_in_out = (int)(cursor - (uchar*)rstr.data());
     rstr.truncate(len_in_out);
     return rstr;
 }

int QUtf8Codec::heuristicContentMatch	(	const char *	chars,
		int	len
	)		const

virtual

Subclasses of QTextCodec must reimplement this function. It examines the first len bytes of chars and returns a value indicating how likely it is that the string is a prefix of text encoded in the encoding of the subclass. Any negative return value indicates that the text is detectably not in the encoding (eg. it contains undefined characters). A return value of 0 indicates that the text should be decoded with this codec rather than as ASCII, but there is no particular evidence. The value should range up to len. Thus, most decoders will return -1, 0, or -len.

The characters are not null terminated.

See also: codecForContent().

Implements QTextCodec.

Definition at line 78 of file qutfcodec.cpp.

 {
     int score = 0;
     for (int i=0; i<len; i++) {
         uchar ch = chars[i];
         // No nulls allowed.
         if ( !ch )
             return -1;
         if ( ch < 128 ) {
             // Inconclusive
             score++;
         } else if ( (ch&0xe0) == 0xc0 ) {
             if ( i < len-1 ) {
                 uchar c2 = chars[++i];
                 if ( (c2&0xc0) != 0x80 )
                     return -1;
                 score+=3;
             }
         } else if ( (ch&0xf0) == 0xe0 ) {
             if ( i < len-1 ) {
                 uchar c2 = chars[++i];
                 if ( (c2&0xc0) != 0x80 ) {
                     return -1;
 #if 0
                     if ( i < len-1 ) {
                         uchar c3 = chars[++i];
                         if ( (c3&0xc0) != 0x80 )
                             return -1;
                         score+=3;
                     }
 #endif
                 }
                 score+=2;
             }
         }
     }
     return score;
 }

QTextDecoder * QUtf8Codec::makeDecoder ( ) const

virtual

Creates a QTextDecoder which stores enough state to decode chunks of char* data to create chunks of Unicode data. The default implementation creates a stateless decoder, which is sufficient for only the simplest encodings where each byte corresponds to exactly one Unicode character.

The caller is responsible for deleting the returned object.

Reimplemented from QTextCodec.

Definition at line 161 of file qutfcodec.cpp.

 {
     return new QUtf8Decoder;
 }

int QUtf8Codec::mibEnum ( ) const

virtual

Subclasses of QTextCodec must reimplement this function. It returns the MIBenum (see the IANA character-sets encoding file for more information). It is important that each QTextCodec subclass return the correct unique value for this function.

Implements QTextCodec.

Definition at line 42 of file qutfcodec.cpp.

 {
     return 106;
 }

const char * QUtf8Codec::name ( ) const

virtual

Subclasses of QTextCodec must reimplement this function. It returns the name of the encoding supported by the subclass. When choosing a name for an encoding, consider these points:

On X11, heuristicNameMatch( const char * hint ) is used to test if a the QTextCodec can convert between Unicode and the encoding of a font with encoding hint, such as "iso8859-1" for Latin-1 fonts, "koi8-r" for Russian KOI8 fonts. The default algorithm of heuristicNameMatch() uses name().
Some applications may use this function to present encodings to the end user.

Implements QTextCodec.

Definition at line 73 of file qutfcodec.cpp.

 {
     return "UTF-8";
 }

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

doxygen-1.8.11/qtools/qutfcodec.h
doxygen-1.8.11/qtools/qutfcodec.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Member Function Documentation