Public Member Functions | |
| 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 |
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) |
Member Function Documentation
§ fromUnicode()
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.
§ heuristicContentMatch()
|
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.
§ heuristicNameMatch()
|
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.
§ mibEnum()
|
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.
§ name()
|
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.
§ toUnicode()
|
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.
The documentation for this class was generated from the following file:
- qtools/qtextcodec.cpp
