QSimpleTextCodec Class Reference

Inheritance diagram for QSimpleTextCodec:

Public Member Functions
	QSimpleTextCodec (int)
	~QSimpleTextCodec ()
QString	toUnicode (const char *chars, int len) const
QCString	fromUnicode (const QString &uc, int &lenInOut) const
const char *	name () const
int	mibEnum () const
int	heuristicContentMatch (const char *chars, int len) const
int	heuristicNameMatch (const char *hint) const
Public Member Functions inherited from QTextCodec
virtual	~QTextCodec ()
virtual QTextDecoder *	makeDecoder () const
virtual QTextEncoder *	makeEncoder () 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

Private Attributes
int	forwardIndex

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 1326 of file qtextcodec.cpp.

Constructor & Destructor Documentation

QSimpleTextCodec::QSimpleTextCodec

(

int

i

)

Definition at line 1813 of file qtextcodec.cpp.

    : QTextCodec(), forwardIndex( i )
{
}

QSimpleTextCodec::~QSimpleTextCodec

(

)

Definition at line 1819 of file qtextcodec.cpp.

{
    if ( reverseOwner == this ) {
        delete reverseMap;
        reverseMap = 0;
        reverseOwner = 0;
    }
}

Member Function Documentation

QCString QSimpleTextCodec::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 1851 of file qtextcodec.cpp.

{
    if ( reverseOwner != this ) {
        int m = 0;
        int i = 0;
        while( i < 128 ) {
            if ( unicodevalues[forwardIndex].values[i] > m &&
                 unicodevalues[forwardIndex].values[i] < 0xfffd )
                m = unicodevalues[forwardIndex].values[i];
            i++;
        }
        m++;
        if ( !reverseMap )
            reverseMap = new QArray<char>( m );
        if ( m > (int)(reverseMap->size()) )
            reverseMap->resize( m );
        for( i = 0; i < 128 && i < m; i++ )
            (*reverseMap)[i] = (char)i;
        for( ;i < m; i++ )
            (*reverseMap)[i] = '?';
        for( i=128; i<256; i++ ) {
            int u = unicodevalues[forwardIndex].values[i-128];
            if ( u < m )
                (*reverseMap)[u] = (char)(unsigned char)(i);
        }
        reverseOwner = this;
    }
    if ( len <0 || len > (int)uc.length() )
        len = uc.length();
    QCString r( len+1 );
    int i = len;
    int u;
    const QChar* ucp = uc.unicode();
    char* rp = r.rawData();
    char* rmp = reverseMap->data();
    int rmsize = (int) reverseMap->size();
    while( i-- )
    {
        u = ucp->unicode();
        *rp++ = u < 128 ? u : (( u < rmsize ) ? (*(rmp+u)) : '?' );
        ucp++;
    }
    r[len] = 0;
    return r;
}

int QSimpleTextCodec::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 1927 of file qtextcodec.cpp.

{
    if ( len<1 || !chars )
        return -1;
    int i = 0;
    const uchar * c = (const unsigned char *)chars;
    int r = 0;
    while( i<len && c && *c ) {
        if ( *c >= 128 ) {
            if ( unicodevalues[forwardIndex].values[(*c)-128] == 0xfffd )
                return -1;
        }
        if ( (*c >= ' ' && *c < 127) ||
             *c == '\n' || *c == '\t' || *c == '\r' )
            r++;
        i++;
        c++;
    }
    if ( mibEnum()==4 )
        r+=1;
    return r;
}

int QSimpleTextCodec::heuristicNameMatch ( const char *  hint ) const

virtual

Returns a value indicating how likely this decoder is for decoding some format that has the given name.

A good match returns a positive number around the length of the string. A bad match is negative.

The default implementation calls simpleHeuristicNameMatch() with the name of the codec.

Reimplemented from QTextCodec.

Definition at line 1909 of file qtextcodec.cpp.

{
    if ( hint[0]=='k' ) {
        // Help people with messy fonts
        if ( QCString(hint) == "koi8-1" )
            return QTextCodec::heuristicNameMatch("koi8-r")-1;
        if ( QCString(hint) == "koi8-ru" )
            return QTextCodec::heuristicNameMatch("koi8-r")-1;
    } else if ( hint[0] == 't' && QCString(name()) == "ISO 8859-11" ) {
        // 8859-11 and tis620 are byte by bute equivalent
        int i = simpleHeuristicNameMatch("tis620-0", hint);
        if( !i )
            i = simpleHeuristicNameMatch("tis-620", hint);
        if( i ) return i;
    }
    return QTextCodec::heuristicNameMatch(hint);
}

int QSimpleTextCodec::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 1904 of file qtextcodec.cpp.

{
    return unicodevalues[forwardIndex].mib;
}

const char * QSimpleTextCodec::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 1898 of file qtextcodec.cpp.

{
    return unicodevalues[forwardIndex].cs;
}

QString QSimpleTextCodec::toUnicode ( const char *  chars, int  len  ) const

virtual

Subclasses of QTextCodec must reimplement this function or makeDecoder(). It converts the first len characters of chars to Unicode.

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

Reimplemented from QTextCodec.

Definition at line 1829 of file qtextcodec.cpp.

{
    if(len <= 0)
        return QString::null;

    int clen = qstrlen(chars);
    len = QMIN(len, clen); // Note: NUL ends string

    QString r;
    r.setUnicode(0, len);
    QChar* uc = (QChar*)r.unicode(); // const_cast
    const unsigned char * c = (const unsigned char *)chars;
    for( int i=0; i<len; i++ ) {
        if ( c[i] > 127 )
            uc[i] = unicodevalues[forwardIndex].values[c[i]-128];
        else
            uc[i] = c[i];
    }
    return r;
}

Member Data Documentation

int QSimpleTextCodec::forwardIndex

private

Definition at line 1343 of file qtextcodec.cpp.

---

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

• doxygen-1.8.11/qtools/qtextcodec.cpp