QWindowsLocalCodec Class Reference

Inheritance diagram for QWindowsLocalCodec:

Public Functions
QByteArray	convertFromUnicode (const QChar *, int, ConverterState *) const
	QTextCodec subclasses must reimplement this function. More...
QString	convertToUnicode (const char *, int, ConverterState *) const
	QTextCodec subclasses must reimplement this function. More...
QString	convertToUnicodeCharByChar (const char *chars, int length, ConverterState *state) const
int	mibEnum () const
	Subclasses of QTextCodec must reimplement this function. More...
QByteArray	name () const
	QTextCodec subclasses must reimplement this function. More...
	QWindowsLocalCodec ()
	~QWindowsLocalCodec ()
Public Functions inherited from QTextCodec
virtual QList< QByteArray >	aliases () const
	Subclasses can return a number of aliases for the codec in question. More...
bool	canEncode (QChar) const
	Returns true if the Unicode character ch can be fully encoded with this codec; otherwise returns false. More...
bool	canEncode (const QString &) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.s contains the string being tested for encode-ability. More...
QByteArray	fromUnicode (const QString &uc) const
	Converts str from Unicode to the encoding of this codec, and returns the result in a QByteArray. More...
QByteArray	fromUnicode (const QChar *in, int length, ConverterState *state=0) const
	Converts the first number of characters from the input array from Unicode to the encoding of this codec, and returns the result in a QByteArray. More...
QTextDecoder *	makeDecoder () const
	Creates a QTextDecoder which stores enough state to decode chunks of char * data to create chunks of Unicode data. More...
QTextDecoder *	makeDecoder (ConversionFlags flags) const
QTextEncoder *	makeEncoder () const
	Creates a QTextEncoder which stores enough state to encode chunks of Unicode data as char * data. More...
QTextEncoder *	makeEncoder (ConversionFlags flags) const
QString	toUnicode (const QByteArray &) const
	Converts a from the encoding of this codec to Unicode, and returns the result in a QString. More...
QString	toUnicode (const char *chars) const
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.chars contains the source characters. More...
QString	toUnicode (const char *in, int length, ConverterState *state=0) const
	Converts the first size characters from the input from the encoding of this codec to Unicode, and returns the result in a QString. More...

Additional Inherited Members
Public Types inherited from QTextCodec
enum	ConversionFlag { DefaultConversion, ConvertInvalidToNull = 0x80000000, IgnoreHeader = 0x1, FreeFunction = 0x2 }
Static Public Functions inherited from QTextCodec
static QList< QByteArray >	availableCodecs ()
	Returns the list of all available codecs, by name. More...
static QList< int >	availableMibs ()
	Returns the list of MIBs for all available codecs. More...
static QTextCodec *	codecForCStrings ()
	Returns the codec used by QString to convert to and from const char * and QByteArrays. More...
static QTextCodec *	codecForHtml (const QByteArray &ba)
	Tries to detect the encoding of the provided snippet of HTML in the given byte array, ba, by checking the BOM (Byte Order Mark) and the content-type meta header and returns a QTextCodec instance that is capable of decoding the html to unicode. More...
static QTextCodec *	codecForHtml (const QByteArray &ba, QTextCodec *defaultCodec)
	Tries to detect the encoding of the provided snippet of HTML in the given byte array, ba, by checking the BOM (Byte Order Mark) and the content-type meta header and returns a QTextCodec instance that is capable of decoding the html to unicode. More...
static QTextCodec *	codecForLocale ()
	Returns a pointer to the codec most suitable for this locale. More...
static QTextCodec *	codecForMib (int mib)
	Returns the QTextCodec which matches the MIBenum mib. More...
static QTextCodec *	codecForName (const QByteArray &name)
	Searches all installed QTextCodec objects and returns the one which best matches name; the match is case-insensitive. More...
static QTextCodec *	codecForName (const char *name)
	Searches all installed QTextCodec objects and returns the one which best matches name; the match is case-insensitive. More...
static QTextCodec *	codecForTr ()
	Returns the codec used by QObject::tr() on its argument. More...
static QTextCodec *	codecForUtfText (const QByteArray &ba)
	Tries to detect the encoding of the provided snippet ba by using the BOM (Byte Order Mark) and returns a QTextCodec instance that is capable of decoding the text to unicode. More...
static QTextCodec *	codecForUtfText (const QByteArray &ba, QTextCodec *defaultCodec)
	Tries to detect the encoding of the provided snippet ba by using the BOM (Byte Order Mark) and returns a QTextCodec instance that is capable of decoding the text to unicode. More...
static void	setCodecForCStrings (QTextCodec *c)
static void	setCodecForLocale (QTextCodec *c)
	Set the codec to c; this will be returned by codecForLocale(). More...
static void	setCodecForTr (QTextCodec *c)
Protected Functions inherited from QTextCodec
	QTextCodec ()
	Constructs a QTextCodec, and gives it the highest precedence. More...
virtual	~QTextCodec ()
	Destroys the QTextCodec. More...

Detailed Description

Definition at line 247 of file qtextcodec.cpp.

Constructors and Destructors

QWindowsLocalCodec()

QWindowsLocalCodec::QWindowsLocalCodec

(

)

Definition at line 262 of file qtextcodec.cpp.

{
}

~QWindowsLocalCodec()

QWindowsLocalCodec::~QWindowsLocalCodec

(

)

Definition at line 266 of file qtextcodec.cpp.

{
}

Functions

convertFromUnicode()

QByteArray QWindowsLocalCodec::convertFromUnicode ( const QChar *  input, int  number, ConverterState *  state  ) const

virtual

QTextCodec subclasses must reimplement this function.

Converts the first number of characters from the input array from Unicode to the encoding of the subclass, and returns the result in a QByteArray.

state can be 0 in which case the conversion is stateless and default conversion rules should be used. If state is not 0, the codec should save the state after the conversion in state, and adjust the remainingChars and invalidChars members of the struct.

Implements QTextCodec.

Definition at line 412 of file qtextcodec.cpp.

{
    if (!ch)
        return QByteArray();
    if (uclen == 0)
        return QByteArray("");
    BOOL used_def;
    QByteArray mb(4096, 0);
    int len;
    while (!(len=WideCharToMultiByte(CP_ACP, 0, (const wchar_t*)ch, uclen,
                mb.data(), mb.size()-1, 0, &used_def)))
    {
        int r = GetLastError();
        if (r == ERROR_INSUFFICIENT_BUFFER) {
            mb.resize(1+WideCharToMultiByte(CP_ACP, 0,
                                (const wchar_t*)ch, uclen,
                                0, 0, 0, &used_def));
                // and try again...
        } else {
#ifndef QT_NO_DEBUG
            // Fail.
            qWarning("WideCharToMultiByte: Cannot convert multibyte text (error %d): %s (UTF-8)",
                r, QString(ch, uclen).toLocal8Bit().data());
#endif
            break;
        }
    }
    mb.resize(len);
    return mb;
}

convertToUnicode()

QString QWindowsLocalCodec::convertToUnicode ( const char *  chars, int  len, ConverterState *  state  ) const

virtual

QTextCodec subclasses must reimplement this function.

Converts the first len characters of chars from the encoding of the subclass to Unicode, and returns the result in a QString.

state can be 0, in which case the conversion is stateless and default conversion rules should be used. If state is not 0, the codec should save the state after the conversion in state, and adjust the remainingChars and invalidChars members of the struct.

Implements QTextCodec.

Definition at line 270 of file qtextcodec.cpp.

{
    const char *mb = chars;
    int mblen = length;

    if (!mb || !mblen)
        return QString();

    QVarLengthArray<wchar_t, 4096> wc(4096);
    int len;
    QString sp;
    bool prepend = false;
    char state_data = 0;
    int remainingChars = 0;

    //save the current state information
    if (state) {
        state_data = (char)state->state_data[0];
        remainingChars = state->remainingChars;
    }

    //convert the pending charcter (if available)
    if (state && remainingChars) {
        char prev[3] = {0};
        prev[0] = state_data;
        prev[1] = mb[0];
        remainingChars = 0;
        len = MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED,
                                    prev, 2, wc.data(), wc.size());
        if (len) {
            prepend = true;
            sp.append(QChar(wc[0]));
            mb++;
            mblen--;
            wc[0] = 0;
        }
    }

    while (!(len=MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED|MB_ERR_INVALID_CHARS,
                mb, mblen, wc.data(), wc.size()))) {
        int r = GetLastError();
        if (r == ERROR_INSUFFICIENT_BUFFER) {
                const int wclen = MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED,
                                    mb, mblen, 0, 0);
                wc.resize(wclen);
        } else if (r == ERROR_NO_UNICODE_TRANSLATION) {
            //find the last non NULL character
            while (mblen > 1  && !(mb[mblen-1]))
                mblen--;
            //check whether,  we hit an invalid character in the middle
            if ((mblen <= 1) || (remainingChars && state_data))
                return convertToUnicodeCharByChar(chars, length, state);
            //Remove the last character and try again...
            state_data = mb[mblen-1];
            remainingChars = 1;
            mblen--;
        } else {
            // Fail.
            qWarning("MultiByteToWideChar: Cannot convert multibyte text");
            break;
        }
    }

    if (len <= 0)
        return QString();

    if (wc[len-1] == 0) // len - 1: we don't want terminator
        --len;

    //save the new state information
    if (state) {
        state->state_data[0] = (char)state_data;
        state->remainingChars = remainingChars;
    }
    QString s((QChar*)wc.data(), len);
    if (prepend) {
        return sp+s;
    }
    return s;
}

convertToUnicodeCharByChar()

QString QWindowsLocalCodec::convertToUnicodeCharByChar	(	const char *	chars,
		int	length,
		ConverterState *	state
	)		const

Definition at line 351 of file qtextcodec.cpp.

{
    if (!chars || !length)
        return QString();

    int copyLocation = 0;
    int extra = 2;
    if (state && state->remainingChars) {
        copyLocation = state->remainingChars;
        extra += copyLocation;
    }
    int newLength = length + extra;
    char *mbcs = new char[newLength];
    //ensure that we have a NULL terminated string
    mbcs[newLength-1] = 0;
    mbcs[newLength-2] = 0;
    memcpy(&(mbcs[copyLocation]), chars, length);
    if (copyLocation) {
        //copy the last character from the state
        mbcs[0] = (char)state->state_data[0];
        state->remainingChars = 0;
    }
    const char *mb = mbcs;
#ifndef Q_OS_WINCE
    const char *next = 0;
    QString s;
    while((next = CharNextExA(CP_ACP, mb, 0)) != mb) {
        wchar_t wc[2] ={0};
        int charlength = next - mb;
        int len = MultiByteToWideChar(CP_ACP, MB_PRECOMPOSED|MB_ERR_INVALID_CHARS, mb, charlength, wc, 2);
        if (len>0) {
            s.append(QChar(wc[0]));
        } else {
            int r = GetLastError();
            //check if the character being dropped is the last character
            if (r == ERROR_NO_UNICODE_TRANSLATION && mb == (mbcs+newLength -3) && state) {
                state->remainingChars = 1;
                state->state_data[0] = (char)*mb;
            }
        }
        mb = next;
    }
#else
    QString s;
    int size = mbstowcs(NULL, mb, length);
    if (size < 0) {
        Q_ASSERT("Error in CE TextCodec");
        return QString();
    }
    wchar_t* ws = new wchar_t[size + 2];
    ws[size +1] = 0;
    ws[size] = 0;
    size = mbstowcs(ws, mb, length);
    for (int i=0; i< size; i++)
        s.append(QChar(ws[i]));
    delete [] ws;
#endif
    delete [] mbcs;
    return s;
}

mibEnum()

int QWindowsLocalCodec::mibEnum ( ) const

virtual

Subclasses of QTextCodec must reimplement this function.

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

Implements QTextCodec.

Definition at line 449 of file qtextcodec.cpp.

{
    return 0;
}

name()

QByteArray QWindowsLocalCodec::name ( ) const

virtual

QTextCodec subclasses must reimplement this function.

It returns the name of the encoding supported by the subclass.

If the codec is registered as a character set in the IANA character-sets encoding file this method should return the preferred mime name for the codec if defined, otherwise its name.

Implements QTextCodec.

Definition at line 444 of file qtextcodec.cpp.

{
    return "System";
}

---

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

• /src/corelib/codecs/qtextcodec.cpp