Add Qt3 development HEAD version

1 files changed, 1115 insertions, 0 deletions

diff --git a/src/tools/qstring.h b/src/tools/qstring.h
new file mode 100644
index 0000000..587d0f2
--- /dev/null
+++ b/src/tools/qstring.h
@@ -0,0 +1,1115 @@
+/****************************************************************************
+**
+** Definition of the QString class, and related Unicode functions.
+**
+** Created : 920609
+**
+** Copyright (C) 1992-2008 Trolltech ASA.  All rights reserved.
+**
+** This file is part of the tools module of the Qt GUI Toolkit.
+**
+** This file may be used under the terms of the GNU General
+** Public License versions 2.0 or 3.0 as published by the Free
+** Software Foundation and appearing in the files LICENSE.GPL2
+** and LICENSE.GPL3 included in the packaging of this file.
+** Alternatively you may (at your option) use any later version
+** of the GNU General Public License if such license has been
+** publicly approved by Trolltech ASA (or its successors, if any)
+** and the KDE Free Qt Foundation.
+**
+** Please review the following information to ensure GNU General
+** Public Licensing requirements will be met:
+** http://trolltech.com/products/qt/licenses/licensing/opensource/.
+** If you are unsure which license is appropriate for your use, please
+** review the following information:
+** http://trolltech.com/products/qt/licenses/licensing/licensingoverview
+** or contact the sales department at sales@trolltech.com.
+**
+** This file may be used under the terms of the Q Public License as
+** defined by Trolltech ASA and appearing in the file LICENSE.QPL
+** included in the packaging of this file.  Licensees holding valid Qt
+** Commercial licenses may use this file in accordance with the Qt
+** Commercial License Agreement provided with the Software.
+**
+** This file is provided "AS IS" with NO WARRANTY OF ANY KIND,
+** INCLUDING THE WARRANTIES OF DESIGN, MERCHANTABILITY AND FITNESS FOR
+** A PARTICULAR PURPOSE. Trolltech reserves all rights not granted
+** herein.
+**
+**********************************************************************/
+
+#ifndef QSTRING_H
+#define QSTRING_H
+
+#ifndef QT_H
+#include "qcstring.h"
+#endif // QT_H
+
+#ifndef QT_NO_CAST_ASCII
+#include <limits.h>
+#endif
+
+#ifndef QT_NO_STL
+#if defined ( Q_CC_MSVC_NET ) && _MSC_VER < 1310 // Avoids nasty warning for xlocale, line 450
+#  pragma warning ( push )
+#  pragma warning ( disable : 4189 )
+#  include <string>
+#  pragma warning ( pop )
+#else
+#  include <string>
+#endif
+#if defined(Q_WRONG_SB_CTYPE_MACROS) && defined(_SB_CTYPE_MACROS)
+#undef _SB_CTYPE_MACROS
+#endif
+#endif
+
+
+/*****************************************************************************
+  QString class
+ *****************************************************************************/
+
+class QRegExp;
+class QString;
+class QCharRef;
+template <class T> class QDeepCopy;
+
+class Q_EXPORT QChar {
+public:
+    QChar();
+    QChar( char c );
+    QChar( uchar c );
+    QChar( uchar c, uchar r );
+    QChar( const QChar& c ); // ### remove in 4.0 to allow compiler optimization
+    QChar( ushort rc );
+    QChar( short rc );
+    QChar( uint rc );
+    QChar( int rc );
+
+    QT_STATIC_CONST QChar null;            // 0000
+    QT_STATIC_CONST QChar replacement;     // FFFD
+    QT_STATIC_CONST QChar byteOrderMark;     // FEFF
+    QT_STATIC_CONST QChar byteOrderSwapped;     // FFFE
+    QT_STATIC_CONST QChar nbsp;            // 00A0
+
+    // Unicode information
+
+    enum Category
+    {
+        NoCategory,
+
+        Mark_NonSpacing,          //   Mn
+        Mark_SpacingCombining,    //   Mc
+        Mark_Enclosing,           //   Me
+
+        Number_DecimalDigit,      //   Nd
+        Number_Letter,            //   Nl
+        Number_Other,             //   No
+
+        Separator_Space,          //   Zs
+        Separator_Line,           //   Zl
+        Separator_Paragraph,      //   Zp
+
+        Other_Control,            //   Cc
+        Other_Format,             //   Cf
+        Other_Surrogate,          //   Cs
+        Other_PrivateUse,         //   Co
+        Other_NotAssigned,        //   Cn
+
+        Letter_Uppercase,         //   Lu
+        Letter_Lowercase,         //   Ll
+        Letter_Titlecase,         //   Lt
+        Letter_Modifier,          //   Lm
+        Letter_Other,             //   Lo
+
+        Punctuation_Connector,    //   Pc
+        Punctuation_Dash,         //   Pd
+        Punctuation_Dask = Punctuation_Dash, // oops
+        Punctuation_Open,         //   Ps
+        Punctuation_Close,        //   Pe
+        Punctuation_InitialQuote, //   Pi
+        Punctuation_FinalQuote,   //   Pf
+        Punctuation_Other,        //   Po
+
+        Symbol_Math,              //   Sm
+        Symbol_Currency,          //   Sc
+        Symbol_Modifier,          //   Sk
+        Symbol_Other              //   So
+    };
+
+    enum Direction
+    {
+        DirL, DirR, DirEN, DirES, DirET, DirAN, DirCS, DirB, DirS, DirWS, DirON,
+        DirLRE, DirLRO, DirAL, DirRLE, DirRLO, DirPDF, DirNSM, DirBN
+    };
+
+    enum Decomposition
+    {
+        Single, Canonical, Font, NoBreak, Initial, Medial,
+        Final, Isolated, Circle, Super, Sub, Vertical,
+        Wide, Narrow, Small, Square, Compat, Fraction
+    };
+
+    enum Joining
+    {
+        OtherJoining, Dual, Right, Center
+    };
+
+    enum CombiningClass
+    {
+        Combining_BelowLeftAttached       = 200,
+        Combining_BelowAttached           = 202,
+        Combining_BelowRightAttached      = 204,
+        Combining_LeftAttached            = 208,
+        Combining_RightAttached           = 210,
+        Combining_AboveLeftAttached       = 212,
+        Combining_AboveAttached           = 214,
+        Combining_AboveRightAttached      = 216,
+
+        Combining_BelowLeft               = 218,
+        Combining_Below                   = 220,
+        Combining_BelowRight              = 222,
+        Combining_Left                    = 224,
+        Combining_Right                   = 226,
+        Combining_AboveLeft               = 228,
+        Combining_Above                   = 230,
+        Combining_AboveRight              = 232,
+
+        Combining_DoubleBelow             = 233,
+        Combining_DoubleAbove             = 234,
+        Combining_IotaSubscript           = 240
+    };
+
+    // ****** WHEN ADDING FUNCTIONS, CONSIDER ADDING TO QCharRef TOO
+
+    int digitValue() const;
+    QChar lower() const;
+    QChar upper() const;
+
+    Category category() const;
+    Direction direction() const;
+    Joining joining() const;
+    bool mirrored() const;
+    QChar mirroredChar() const;
+    const QString &decomposition() const; // ### return just QString in 4.0
+    Decomposition decompositionTag() const;
+    unsigned char combiningClass() const;
+
+    char latin1() const { return ucs > 0xff ? 0 : (char) ucs; }
+    ushort unicode() const { return ucs; }
+#ifdef Q_NO_PACKED_REFERENCE
+    ushort &unicode() { return *((ushort*)&ucs); }
+#else
+    ushort &unicode() { return ucs; }
+#endif
+#ifndef QT_NO_CAST_ASCII
+    // like all ifdef'd code this is undocumented
+    operator char() const { return latin1(); }
+#endif
+
+    bool isNull() const { return unicode()==0; }
+    bool isPrint() const;
+    bool isPunct() const;
+    bool isSpace() const;
+    bool isMark() const;
+    bool isLetter() const;
+    bool isNumber() const;
+    bool isLetterOrNumber() const;
+    bool isDigit() const;
+    bool isSymbol() const;
+
+    uchar cell() const { return ((uchar) ucs & 0xff); }
+    uchar row() const { return ((uchar) (ucs>>8)&0xff); }
+    void setCell( uchar cell ) { ucs = (ucs & 0xff00) + cell; }
+    void setRow( uchar row ) { ucs = (((ushort) row)<<8) + (ucs&0xff); }
+
+    static bool networkOrdered() {
+	int wordSize;
+	bool bigEndian = FALSE;
+	qSysInfo( &wordSize, &bigEndian );
+	return bigEndian;
+    }
+
+    friend inline bool operator==( char ch, QChar c );
+    friend inline bool operator==( QChar c, char ch );
+    friend inline bool operator==( QChar c1, QChar c2 );
+    friend inline bool operator!=( QChar c1, QChar c2 );
+    friend inline bool operator!=( char ch, QChar c );
+    friend inline bool operator!=( QChar c, char ch );
+    friend inline bool operator<=( QChar c, char ch );
+    friend inline bool operator<=( char ch, QChar c );
+    friend inline bool operator<=( QChar c1, QChar c2 );
+
+private:
+    ushort ucs;
+#if defined(QT_QSTRING_UCS_4)
+    ushort grp;
+#endif
+} Q_PACKED;
+
+inline QChar::QChar() : ucs( 0 )
+#ifdef QT_QSTRING_UCS_4
+    , grp( 0 )
+#endif
+{
+}
+inline QChar::QChar( char c ) : ucs( (uchar)c )
+#ifdef QT_QSTRING_UCS_4
+    , grp( 0 )
+#endif
+{
+}
+inline QChar::QChar( uchar c ) : ucs( c )
+#ifdef QT_QSTRING_UCS_4
+    , grp( 0 )
+#endif
+{
+}
+inline QChar::QChar( uchar c, uchar r ) : ucs( (r << 8) | c )
+#ifdef QT_QSTRING_UCS_4
+    , grp( 0 )
+#endif
+{
+}
+inline QChar::QChar( const QChar& c ) : ucs( c.ucs )
+#ifdef QT_QSTRING_UCS_4
+   , grp( c.grp )
+#endif
+{
+}
+
+inline QChar::QChar( ushort rc ) : ucs( rc )
+#ifdef QT_QSTRING_UCS_4
+    , grp( 0 )
+#endif
+{
+}
+inline QChar::QChar( short rc ) : ucs( (ushort) rc )
+#ifdef QT_QSTRING_UCS_4
+    , grp( 0 )
+#endif
+{
+}
+inline QChar::QChar( uint rc ) : ucs(  (ushort ) (rc & 0xffff) )
+#ifdef QT_QSTRING_UCS_4
+    , grp( (ushort) ((rc >> 16) & 0xffff) )
+#endif
+{
+}
+inline QChar::QChar( int rc ) : ucs( (ushort) (rc & 0xffff) )
+#ifdef QT_QSTRING_UCS_4
+    , grp( (ushort) ((rc >> 16) & 0xffff) )
+#endif
+{
+}
+
+inline bool operator==( char ch, QChar c )
+{
+    return ((uchar) ch) == c.ucs;
+}
+
+inline bool operator==( QChar c, char ch )
+{
+    return ((uchar) ch) == c.ucs;
+}
+
+inline bool operator==( QChar c1, QChar c2 )
+{
+    return c1.ucs == c2.ucs;
+}
+
+inline bool operator!=( QChar c1, QChar c2 )
+{
+    return c1.ucs != c2.ucs;
+}
+
+inline bool operator!=( char ch, QChar c )
+{
+    return ((uchar)ch) != c.ucs;
+}
+
+inline bool operator!=( QChar c, char ch )
+{
+    return ((uchar) ch) != c.ucs;
+}
+
+inline bool operator<=( QChar c, char ch )
+{
+    return c.ucs <= ((uchar) ch);
+}
+
+inline bool operator<=( char ch, QChar c )
+{
+    return ((uchar) ch) <= c.ucs;
+}
+
+inline bool operator<=( QChar c1, QChar c2 )
+{
+    return c1.ucs <= c2.ucs;
+}
+
+inline bool operator>=( QChar c, char ch ) { return ch <= c; }
+inline bool operator>=( char ch, QChar c ) { return c <= ch; }
+inline bool operator>=( QChar c1, QChar c2 ) { return c2 <= c1; }
+inline bool operator<( QChar c, char ch ) { return !(ch<=c); }
+inline bool operator<( char ch, QChar c ) { return !(c<=ch); }
+inline bool operator<( QChar c1, QChar c2 ) { return !(c2<=c1); }
+inline bool operator>( QChar c, char ch ) { return !(ch>=c); }
+inline bool operator>( char ch, QChar c ) { return !(c>=ch); }
+inline bool operator>( QChar c1, QChar c2 ) { return !(c2>=c1); }
+
+// internal
+struct Q_EXPORT QStringData : public QShared {
+    QStringData() :
+        QShared(), unicode(0), ascii(0), len(0), issimpletext(TRUE), maxl(0), islatin1(FALSE) { ref(); }
+    QStringData(QChar *u, uint l, uint m) :
+        QShared(), unicode(u), ascii(0), len(l), issimpletext(FALSE), maxl(m), islatin1(FALSE) { }
+    ~QStringData() { if ( unicode ) delete[] ((char*)unicode);
+                     if ( ascii ) delete[] ascii; }
+
+    void deleteSelf();
+    QChar *unicode;
+    char *ascii;
+    void setDirty() {
+	if ( ascii ) {
+	    delete [] ascii;
+	    ascii = 0;
+	}
+	issimpletext = FALSE;
+    }
+#ifdef Q_OS_MAC9
+    uint len;
+#else
+    uint len : 30;
+#endif
+    uint issimpletext : 1;
+#ifdef Q_OS_MAC9
+    uint maxl;
+#else
+    uint maxl : 30;
+#endif
+    uint islatin1 : 1;
+
+private:
+#if defined(Q_DISABLE_COPY)
+    QStringData( const QStringData& );
+    QStringData& operator=( const QStringData& );
+#endif
+};
+
+
+class Q_EXPORT QString
+{
+public:
+    QString();                                  // make null string
+    QString( QChar );                           // one-char string
+    QString( const QString & );                 // impl-shared copy
+    QString( const QByteArray& );               // deep copy
+    QString( const QChar* unicode, uint length ); // deep copy
+#ifndef QT_NO_CAST_ASCII
+    QString( const char *str );                 // deep copy
+#endif
+#ifndef QT_NO_STL
+    QString( const std::string& );                   // deep copy
+#endif
+    ~QString();
+
+    QString    &operator=( const QString & );   // impl-shared copy
+    QString    &operator=( const char * );      // deep copy
+#ifndef QT_NO_STL
+    QString    &operator=( const std::string& );     // deep copy
+#endif
+    QString    &operator=( const QCString& );   // deep copy
+    QString    &operator=( QChar c );
+    QString    &operator=( char c );
+
+    QT_STATIC_CONST QString null;
+
+    bool        isNull()        const;
+    bool        isEmpty()       const;
+    uint        length()        const;
+    void        truncate( uint pos );
+
+    QString &   fill( QChar c, int len = -1 );
+
+    QString     copy()  const;
+
+    QString arg( long a, int fieldWidth = 0, int base = 10 ) const;
+    QString arg( ulong a, int fieldWidth = 0, int base = 10 ) const;
+    QString arg( Q_LLONG a, int fieldwidth=0, int base=10 ) const;
+    QString arg( Q_ULLONG a, int fieldwidth=0, int base=10 ) const;
+    QString arg( int a, int fieldWidth = 0, int base = 10 ) const;
+    QString arg( uint a, int fieldWidth = 0, int base = 10 ) const;
+    QString arg( short a, int fieldWidth = 0, int base = 10 ) const;
+    QString arg( ushort a, int fieldWidth = 0, int base = 10 ) const;
+    QString arg( double a, int fieldWidth = 0, char fmt = 'g',
+		 int prec = -1 ) const;
+    QString arg( char a, int fieldWidth = 0 ) const;
+    QString arg( QChar a, int fieldWidth = 0 ) const;
+    QString arg( const QString& a, int fieldWidth = 0 ) const;
+    QString arg( const QString& a1, const QString& a2 ) const;
+    QString arg( const QString& a1, const QString& a2,
+		 const QString& a3 ) const;
+    QString arg( const QString& a1, const QString& a2, const QString& a3,
+		 const QString& a4 ) const;
+
+#ifndef QT_NO_SPRINTF
+    QString    &sprintf( const char* format, ... )
+#if defined(Q_CC_GNU) && !defined(__INSURE__)
+        __attribute__ ((format (printf, 2, 3)))
+#endif
+        ;
+#endif
+
+    int         find( QChar c, int index=0, bool cs=TRUE ) const;
+    int         find( char c, int index=0, bool cs=TRUE ) const;
+    int         find( const QString &str, int index=0, bool cs=TRUE ) const;
+#ifndef QT_NO_REGEXP
+    int         find( const QRegExp &, int index=0 ) const;
+#endif
+#ifndef QT_NO_CAST_ASCII
+    int         find( const char* str, int index=0 ) const;
+#endif
+    int         findRev( QChar c, int index=-1, bool cs=TRUE) const;
+    int         findRev( char c, int index=-1, bool cs=TRUE) const;
+    int         findRev( const QString &str, int index=-1, bool cs=TRUE) const;
+#ifndef QT_NO_REGEXP
+    int         findRev( const QRegExp &, int index=-1 ) const;
+#endif
+#ifndef QT_NO_CAST_ASCII
+    int         findRev( const char* str, int index=-1 ) const;
+#endif
+    int         contains( QChar c, bool cs=TRUE ) const;
+    int         contains( char c, bool cs=TRUE ) const
+                    { return contains(QChar(c), cs); }
+#ifndef QT_NO_CAST_ASCII
+    int         contains( const char* str, bool cs=TRUE ) const;
+#endif
+    int         contains( const QString &str, bool cs=TRUE ) const;
+#ifndef QT_NO_REGEXP
+    int         contains( const QRegExp & ) const;
+#endif
+
+    enum SectionFlags {
+	SectionDefault             = 0x00,
+	SectionSkipEmpty           = 0x01,
+	SectionIncludeLeadingSep   = 0x02,
+	SectionIncludeTrailingSep  = 0x04,
+	SectionCaseInsensitiveSeps = 0x08
+    };
+    QString     section( QChar sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
+    QString     section( char sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
+#ifndef QT_NO_CAST_ASCII
+    QString      section( const char *in_sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
+#endif
+    QString     section( const QString &in_sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
+#ifndef QT_NO_REGEXP
+    QString     section( const QRegExp &reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
+#endif
+
+    QString     left( uint len )  const;
+    QString     right( uint len ) const;
+    QString     mid( uint index, uint len=0xffffffff) const;
+
+    QString     leftJustify( uint width, QChar fill=' ', bool trunc=FALSE)const;
+    QString     rightJustify( uint width, QChar fill=' ',bool trunc=FALSE)const;
+
+    QString     lower() const;
+    QString     upper() const;
+
+    QString     stripWhiteSpace()       const;
+    QString     simplifyWhiteSpace()    const;
+
+    QString    &insert( uint index, const QString & );
+#ifndef QT_NO_CAST_ASCII
+    QString    &insert( uint index, const QByteArray & );
+    QString    &insert( uint index, const char * );
+#endif
+    QString    &insert( uint index, const QChar*, uint len );
+    QString    &insert( uint index, QChar );
+    QString    &insert( uint index, char c ) { return insert(index,QChar(c)); }
+    QString    &append( char );
+    QString    &append( QChar );
+    QString    &append( const QString & );
+#ifndef QT_NO_CAST_ASCII
+    QString    &append( const QByteArray & );
+    QString    &append( const char * );
+#endif
+#if !defined(QT_NO_STL) && !defined(QT_NO_CAST_ASCII)
+    QString    &append( const std::string& );
+#endif
+    QString    &prepend( char );
+    QString    &prepend( QChar );
+    QString    &prepend( const QString & );
+#ifndef QT_NO_CAST_ASCII
+    QString    &prepend( const QByteArray & );
+    QString    &prepend( const char * );
+#endif
+#if !defined(QT_NO_STL) && !defined(QT_NO_CAST_ASCII)
+    QString    &prepend( const std::string& );
+#endif
+    QString    &remove( uint index, uint len );
+#if defined(Q_QDOC)
+    QString    &remove( const QString & str, bool cs = TRUE );
+#else
+    // ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
+    QString    &remove( const QString & );
+    QString    &remove( const QString &, bool cs );
+#endif
+    QString    &remove( QChar c );
+    QString    &remove( char c )
+    { return remove( QChar(c) ); }
+#ifndef QT_NO_CAST_ASCII
+    QString    &remove( const char * );
+#endif
+#ifndef QT_NO_REGEXP
+    QString    &remove( const QRegExp & );
+#endif
+    QString    &replace( uint index, uint len, const QString & );
+    QString    &replace( uint index, uint len, const QChar*, uint clen );
+    QString    &replace( uint index, uint len, QChar );
+    QString    &replace( uint index, uint len, char c )
+    { return replace( index, len, QChar(c) ); }
+#if defined(Q_QDOC)
+    QString    &replace( QChar c, const QString & after, bool cs = TRUE );
+    QString    &replace( char c, const QString & after, bool cs = TRUE );
+    QString    &replace( const QString & before, const QString & after,
+			 bool cs = TRUE );
+#else
+    // ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
+    QString    &replace( QChar c, const QString & );
+    QString    &replace( QChar c, const QString &, bool );
+
+    // ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
+    QString    &replace( char c, const QString & after )
+    { return replace( QChar(c), after, TRUE ); }
+    QString    &replace( char c, const QString & after, bool cs )
+    { return replace( QChar(c), after, cs ); }
+
+    // ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
+    QString    &replace( const QString &, const QString & );
+    QString    &replace( const QString &, const QString &, bool );
+#endif
+#ifndef QT_NO_REGEXP_CAPTURE
+    QString    &replace( const QRegExp &, const QString & );
+#endif
+    QString    &replace( QChar, QChar );
+
+    short       toShort( bool *ok=0, int base=10 )      const;
+    ushort      toUShort( bool *ok=0, int base=10 )     const;
+    int         toInt( bool *ok=0, int base=10 )        const;
+    uint        toUInt( bool *ok=0, int base=10 )       const;
+    long        toLong( bool *ok=0, int base=10 )       const;
+    ulong       toULong( bool *ok=0, int base=10 )      const;
+    Q_LLONG     toLongLong( bool *ok=0, int base=10 )   const;
+    Q_ULLONG    toULongLong( bool *ok=0, int base=10 )  const;
+    float       toFloat( bool *ok=0 )   const;
+    double      toDouble( bool *ok=0 )  const;
+
+    QString    &setNum( short, int base=10 );
+    QString    &setNum( ushort, int base=10 );
+    QString    &setNum( int, int base=10 );
+    QString    &setNum( uint, int base=10 );
+    QString    &setNum( long, int base=10 );
+    QString    &setNum( ulong, int base=10 );
+    QString    &setNum( Q_LLONG, int base=10 );
+    QString    &setNum( Q_ULLONG, int base=10 );
+    QString    &setNum( float, char f='g', int prec=6 );
+    QString    &setNum( double, char f='g', int prec=6 );
+
+    static QString number( long, int base=10 );
+    static QString number( ulong, int base=10);
+    static QString number( Q_LLONG, int base=10 );
+    static QString number( Q_ULLONG, int base=10);
+    static QString number( int, int base=10 );
+    static QString number( uint, int base=10);
+    static QString number( double, char f='g', int prec=6 );
+
+    void        setExpand( uint index, QChar c );
+
+    QString    &operator+=( const QString &str );
+#ifndef QT_NO_CAST_ASCII
+    QString    &operator+=( const QByteArray &str );
+    QString    &operator+=( const char *str );
+#endif
+#if !defined(QT_NO_STL) && !defined(QT_NO_CAST_ASCII)
+    QString    &operator+=( const std::string& );
+#endif
+    QString    &operator+=( QChar c );
+    QString    &operator+=( char c );
+
+    QChar at( uint i ) const
+        { return i < d->len ? d->unicode[i] : QChar::null; }
+    QChar operator[]( int i ) const { return at((uint)i); }
+    QCharRef at( uint i );
+    QCharRef operator[]( int i );
+
+    QChar constref(uint i) const
+        { return at(i); }
+    QChar& ref(uint i)
+        { // Optimized for easy-inlining by simple compilers.
+            if ( d->count != 1 || i >= d->len )
+                subat( i );
+            d->setDirty();
+            return d->unicode[i];
+        }
+
+    const QChar* unicode() const { return d->unicode; }
+    const char* ascii() const;
+    static QString fromAscii(const char*, int len=-1);
+    const char* latin1() const;
+    static QString fromLatin1(const char*, int len=-1);
+    QCString utf8() const;
+    static QString fromUtf8(const char*, int len=-1);
+    QCString local8Bit() const;
+    static QString fromLocal8Bit(const char*, int len=-1);
+    bool operator!() const;
+#ifndef QT_NO_ASCII_CAST
+    operator const char *() const { return ascii(); }
+#endif
+#ifndef QT_NO_STL
+    operator std::string() const { return ascii() ? ascii() : ""; }
+#endif
+
+    static QString fromUcs2( const unsigned short *ucs2 );
+    const unsigned short *ucs2() const;
+
+    QString &setUnicode( const QChar* unicode, uint len );
+    QString &setUnicodeCodes( const ushort* unicode_as_ushorts, uint len );
+    QString &setAscii( const char*, int len=-1 );
+    QString &setLatin1( const char*, int len=-1 );
+
+    int compare( const QString& s ) const;
+    static int compare( const QString& s1, const QString& s2 )
+    { return s1.compare( s2 ); }
+
+    int localeAwareCompare( const QString& s ) const;
+    static int localeAwareCompare( const QString& s1, const QString& s2 )
+    { return s1.localeAwareCompare( s2 ); }
+
+#ifndef QT_NO_DATASTREAM
+    friend Q_EXPORT QDataStream &operator>>( QDataStream &, QString & );
+#endif
+
+    void compose();
+
+#ifndef QT_NO_COMPAT
+    const char* data() const { return ascii(); }
+#endif
+
+#if defined(Q_QDOC)
+    bool startsWith( const QString& str, bool cs = TRUE ) const;
+    bool endsWith( const QString& str, bool cs = TRUE ) const;
+#else
+    // ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
+    bool startsWith( const QString& str ) const;
+    bool startsWith( const QString& str, bool cs ) const;
+
+    // ### Qt 4.0: merge these two into one, and remove Q_QDOC hack
+    bool endsWith( const QString& str ) const;
+    bool endsWith( const QString& str, bool cs ) const;
+#endif
+
+    void setLength( uint newLength );
+
+    uint capacity() const;
+    void reserve( uint minCapacity );
+    void squeeze();
+
+    bool simpleText() const { if ( !d->issimpletext ) checkSimpleText(); return (bool)d->issimpletext; }
+    bool isRightToLeft() const;
+
+
+private:
+    QString( int size, bool /* dummy */ );	// allocate size incl. \0
+
+    void deref();
+    void real_detach();
+    void subat( uint );
+    QString multiArg( int numArgs, const QString& a1, const QString& a2,
+		      const QString& a3 = QString::null,
+		      const QString& a4 = QString::null ) const;
+
+    void checkSimpleText() const;
+    void grow( uint newLength );
+#ifndef QT_NO_CAST_ASCII
+    QString &insertHelper( uint index, const char *s, uint len=UINT_MAX );
+    QString &operatorPlusEqHelper( const char *s, uint len2=UINT_MAX );
+#endif
+
+    static QChar* latin1ToUnicode( const char*, uint * len, uint maxlen=(uint)-1 );
+    static QChar* latin1ToUnicode( const QByteArray&, uint * len );
+    static char* unicodeToLatin1( const QChar*, uint len );
+
+    QStringData *d;
+    static QStringData* shared_null;
+    static QStringData* makeSharedNull();
+
+    friend class QConstString;
+    friend class QTextStream;
+    QString( QStringData* dd, bool /* dummy */ ) : d(dd) { }
+
+    // needed for QDeepCopy
+    void detach();
+    friend class QDeepCopy<QString>;
+};
+
+class Q_EXPORT QCharRef {
+    friend class QString;
+    QString& s;
+    uint p;
+    QCharRef(QString* str, uint pos) : s(*str), p(pos) { }
+
+public:
+    // most QChar operations repeated here
+
+    // all this is not documented: We just say "like QChar" and let it be.
+#ifndef Q_QDOC
+    ushort unicode() const { return s.constref(p).unicode(); }
+    char latin1() const { return s.constref(p).latin1(); }
+
+    // An operator= for each QChar cast constructors
+    QCharRef operator=(char c ) { s.ref(p)=c; return *this; }
+    QCharRef operator=(uchar c ) { s.ref(p)=c; return *this; }
+    QCharRef operator=(QChar c ) { s.ref(p)=c; return *this; }
+    QCharRef operator=(const QCharRef& c ) { s.ref(p)=c.unicode(); return *this; }
+    QCharRef operator=(ushort rc ) { s.ref(p)=rc; return *this; }
+    QCharRef operator=(short rc ) { s.ref(p)=rc; return *this; }
+    QCharRef operator=(uint rc ) { s.ref(p)=rc; return *this; }
+    QCharRef operator=(int rc ) { s.ref(p)=rc; return *this; }
+
+    operator QChar () const { return s.constref(p); }
+
+    // each function...
+    bool isNull() const { return unicode()==0; }
+    bool isPrint() const { return s.constref(p).isPrint(); }
+    bool isPunct() const { return s.constref(p).isPunct(); }
+    bool isSpace() const { return s.constref(p).isSpace(); }
+    bool isMark() const { return s.constref(p).isMark(); }
+    bool isLetter() const { return s.constref(p).isLetter(); }
+    bool isNumber() const { return s.constref(p).isNumber(); }
+    bool isLetterOrNumber() { return s.constref(p).isLetterOrNumber(); }
+    bool isDigit() const { return s.constref(p).isDigit(); }
+
+    int digitValue() const { return s.constref(p).digitValue(); }
+    QChar lower() const { return s.constref(p).lower(); }
+    QChar upper() const { return s.constref(p).upper(); }
+
+    QChar::Category category() const { return s.constref(p).category(); }
+    QChar::Direction direction() const { return s.constref(p).direction(); }
+    QChar::Joining joining() const { return s.constref(p).joining(); }
+    bool mirrored() const { return s.constref(p).mirrored(); }
+    QChar mirroredChar() const { return s.constref(p).mirroredChar(); }
+    const QString &decomposition() const { return s.constref(p).decomposition(); }
+    QChar::Decomposition decompositionTag() const { return s.constref(p).decompositionTag(); }
+    unsigned char combiningClass() const { return s.constref(p).combiningClass(); }
+
+    // Not the non-const ones of these.
+    uchar cell() const { return s.constref(p).cell(); }
+    uchar row() const { return s.constref(p).row(); }
+#endif
+};
+
+inline QCharRef QString::at( uint i ) { return QCharRef(this,i); }
+inline QCharRef QString::operator[]( int i ) { return at((uint)i); }
+
+
+class Q_EXPORT QConstString : private QString {
+public:
+    QConstString( const QChar* unicode, uint length );
+    ~QConstString();
+    const QString& string() const { return *this; }
+};
+
+
+/*****************************************************************************
+  QString stream functions
+ *****************************************************************************/
+#ifndef QT_NO_DATASTREAM
+Q_EXPORT QDataStream &operator<<( QDataStream &, const QString & );
+Q_EXPORT QDataStream &operator>>( QDataStream &, QString & );
+#endif
+
+/*****************************************************************************
+  QString inline functions
+ *****************************************************************************/
+
+// These two move code into makeSharedNull() and deletesData()
+// to improve cache-coherence (and reduce code bloat), while
+// keeping the common cases fast.
+//
+// No safe way to pre-init shared_null on ALL compilers/linkers.
+inline QString::QString() :
+    d(shared_null ? shared_null : makeSharedNull())
+{
+    d->ref();
+}
+//
+inline QString::~QString()
+{
+    if ( d->deref() ) {
+        if ( d != shared_null )
+	    d->deleteSelf();
+    }
+}
+
+// needed for QDeepCopy
+inline void QString::detach()
+{ real_detach(); }
+
+inline QString QString::section( QChar sep, int start, int end, int flags ) const
+{ return section(QString(sep), start, end, flags); }
+
+inline QString QString::section( char sep, int start, int end, int flags ) const
+{ return section(QChar(sep), start, end, flags); }
+
+#ifndef QT_NO_CAST_ASCII
+inline QString QString::section( const char *in_sep, int start, int end, int flags ) const
+{ return section(QString(in_sep), start, end, flags); }
+#endif
+
+inline QString &QString::operator=( QChar c )
+{ *this = QString(c); return *this; }
+
+inline QString &QString::operator=( char c )
+{ *this = QString(QChar(c)); return *this; }
+
+inline bool QString::isNull() const
+{ return unicode() == 0; }
+
+inline bool QString::operator!() const
+{ return isNull(); }
+
+inline uint QString::length() const
+{ return d->len; }
+
+inline uint QString::capacity() const
+{ return d->maxl; }
+
+inline bool QString::isEmpty() const
+{ return length() == 0; }
+
+inline QString QString::copy() const
+{ return QString( *this ); }
+
+#ifndef QT_NO_CAST_ASCII
+inline QString &QString::insert( uint index, const char *s )
+{ return insertHelper( index, s ); }
+
+inline QString &QString::insert( uint index, const QByteArray &s )
+{
+    int pos = s.find( 0 );
+    return insertHelper( index, s, pos==-1 ? s.size() : pos );
+}
+#endif
+
+inline QString &QString::prepend( const QString & s )
+{ return insert(0,s); }
+
+inline QString &QString::prepend( QChar c )
+{ return insert(0,c); }
+
+inline QString &QString::prepend( char c )
+{ return insert(0,c); }
+
+#ifndef QT_NO_CAST_ASCII
+inline QString &QString::prepend( const QByteArray & s )
+{ return insert(0,s); }
+#endif
+
+#ifndef QT_NO_CAST_ASCII
+inline QString &QString::operator+=( const QByteArray &s )
+{
+    int pos = s.find( 0 );
+    return operatorPlusEqHelper( s, pos==-1 ? s.size() : pos );
+}
+#endif
+
+inline QString &QString::append( const QString & s )
+{ return operator+=(s); }
+
+#ifndef QT_NO_CAST_ASCII
+inline QString &QString::append( const QByteArray &s )
+{ return operator+=(s); }
+
+inline QString &QString::append( const char * s )
+{ return operator+=(s); }
+#endif
+
+inline QString &QString::append( QChar c )
+{ return operator+=(c); }
+
+inline QString &QString::append( char c )
+{ return operator+=(c); }
+
+#ifndef QT_NO_STL
+inline QString &QString::operator=( const std::string& str )
+{ return operator=(str.c_str()); }
+#ifndef QT_NO_CAST_ASCII
+inline QString &QString::operator+=( const std::string& s )
+{ return operator+=(s.c_str()); }
+inline QString &QString::append( const std::string& s )
+{ return operator+=(s); }
+inline QString &QString::prepend( const std::string& s )
+{ return insert(0, s); }
+#endif
+#endif
+
+inline QString &QString::setNum( short n, int base )
+{ return setNum((Q_LLONG)n, base); }
+
+inline QString &QString::setNum( ushort n, int base )
+{ return setNum((Q_ULLONG)n, base); }
+
+inline QString &QString::setNum( int n, int base )
+{ return setNum((Q_LLONG)n, base); }
+
+inline QString &QString::setNum( uint n, int base )
+{ return setNum((Q_ULLONG)n, base); }
+
+inline QString &QString::setNum( float n, char f, int prec )
+{ return setNum((double)n,f,prec); }
+
+inline QString QString::arg( int a, int fieldWidth, int base ) const
+{ return arg( (Q_LLONG)a, fieldWidth, base ); }
+
+inline QString QString::arg( uint a, int fieldWidth, int base ) const
+{ return arg( (Q_ULLONG)a, fieldWidth, base ); }
+
+inline QString QString::arg( short a, int fieldWidth, int base ) const
+{ return arg( (Q_LLONG)a, fieldWidth, base ); }
+
+inline QString QString::arg( ushort a, int fieldWidth, int base ) const
+{ return arg( (Q_ULLONG)a, fieldWidth, base ); }
+
+inline QString QString::arg( const QString& a1, const QString& a2 ) const {
+    return multiArg( 2, a1, a2 );
+}
+
+inline QString QString::arg( const QString& a1, const QString& a2,
+			     const QString& a3 ) const {
+    return multiArg( 3, a1, a2, a3 );
+}
+
+inline QString QString::arg( const QString& a1, const QString& a2,
+			     const QString& a3, const QString& a4 ) const {
+    return multiArg( 4, a1, a2, a3, a4 );
+}
+
+inline int QString::find( char c, int index, bool cs ) const
+{ return find(QChar(c), index, cs); }
+
+inline int QString::findRev( char c, int index, bool cs ) const
+{ return findRev( QChar(c), index, cs ); }
+
+#ifndef QT_NO_CAST_ASCII
+inline int QString::find( const char* str, int index ) const
+{ return find(QString::fromAscii(str), index); }
+
+inline int QString::findRev( const char* str, int index ) const
+{ return findRev(QString::fromAscii(str), index); }
+#endif
+
+
+/*****************************************************************************
+  QString non-member operators
+ *****************************************************************************/
+
+Q_EXPORT bool operator!=( const QString &s1, const QString &s2 );
+Q_EXPORT bool operator<( const QString &s1, const QString &s2 );
+Q_EXPORT bool operator<=( const QString &s1, const QString &s2 );
+Q_EXPORT bool operator==( const QString &s1, const QString &s2 );
+Q_EXPORT bool operator>( const QString &s1, const QString &s2 );
+Q_EXPORT bool operator>=( const QString &s1, const QString &s2 );
+#ifndef QT_NO_CAST_ASCII
+Q_EXPORT bool operator!=( const QString &s1, const char *s2 );
+Q_EXPORT bool operator<( const QString &s1, const char *s2 );
+Q_EXPORT bool operator<=( const QString &s1, const char *s2 );
+Q_EXPORT bool operator==( const QString &s1, const char *s2 );
+Q_EXPORT bool operator>( const QString &s1, const char *s2 );
+Q_EXPORT bool operator>=( const QString &s1, const char *s2 );
+Q_EXPORT bool operator!=( const char *s1, const QString &s2 );
+Q_EXPORT bool operator<( const char *s1, const QString &s2 );
+Q_EXPORT bool operator<=( const char *s1, const QString &s2 );
+Q_EXPORT bool operator==( const char *s1, const QString &s2 );
+//Q_EXPORT bool operator>( const char *s1, const QString &s2 ); // MSVC++
+Q_EXPORT bool operator>=( const char *s1, const QString &s2 );
+#endif
+
+Q_EXPORT inline const QString operator+( const QString &s1, const QString &s2 )
+{
+    QString tmp( s1 );
+    tmp += s2;
+    return tmp;
+}
+
+#ifndef QT_NO_CAST_ASCII
+Q_EXPORT inline const QString operator+( const QString &s1, const char *s2 )
+{
+    QString tmp( s1 );
+    tmp += QString::fromAscii(s2);
+    return tmp;
+}
+
+Q_EXPORT inline const QString operator+( const char *s1, const QString &s2 )
+{
+    QString tmp = QString::fromAscii( s1 );
+    tmp += s2;
+    return tmp;
+}
+#endif
+
+Q_EXPORT inline const QString operator+( const QString &s1, QChar c2 )
+{
+    QString tmp( s1 );
+    tmp += c2;
+    return tmp;
+}
+
+Q_EXPORT inline const QString operator+( const QString &s1, char c2 )
+{
+    QString tmp( s1 );
+    tmp += c2;
+    return tmp;
+}
+
+Q_EXPORT inline const QString operator+( QChar c1, const QString &s2 )
+{
+    QString tmp;
+    tmp += c1;
+    tmp += s2;
+    return tmp;
+}
+
+Q_EXPORT inline const QString operator+( char c1, const QString &s2 )
+{
+    QString tmp;
+    tmp += c1;
+    tmp += s2;
+    return tmp;
+}
+
+#ifndef QT_NO_STL
+Q_EXPORT inline const QString operator+(const QString& s1, const std::string& s2)
+{
+    return s1 + QString(s2);
+}
+
+Q_EXPORT inline const QString operator+(const std::string& s1, const QString& s2)
+{
+    QString tmp(s2);
+    return QString(tmp.prepend(s1));
+}
+#endif
+
+
+#if defined(Q_OS_WIN32)
+extern Q_EXPORT QString qt_winQString(void*);
+extern Q_EXPORT const void* qt_winTchar(const QString& str, bool addnul);
+extern Q_EXPORT void* qt_winTchar_new(const QString& str);
+extern Q_EXPORT QCString qt_winQString2MB( const QString& s, int len=-1 );
+extern Q_EXPORT QString qt_winMB2QString( const char* mb, int len=-1 );
+#endif
+
+#define Q_DEFINED_QSTRING
+#include "qwinexport.h"
+#endif // QSTRING_H