src/corelib/tools/qstring.h

   1 /****************************************************************************
   2 **
   3 ** Copyright (C) 2011 Nokia Corporation and/or its subsidiary(-ies).
   4 ** All rights reserved.
   5 ** Contact: Nokia Corporation (qt-info@nokia.com)
   6 **
   7 ** This file is part of the QtCore module of the Qt Toolkit.
   8 **
   9 ** $QT_BEGIN_LICENSE:LGPL$
  10 ** GNU Lesser General Public License Usage
  11 ** This file may be used under the terms of the GNU Lesser General Public
  12 ** License version 2.1 as published by the Free Software Foundation and
  13 ** appearing in the file LICENSE.LGPL included in the packaging of this
  14 ** file. Please review the following information to ensure the GNU Lesser
  15 ** General Public License version 2.1 requirements will be met:
  16 ** http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html.
  17 **
  18 ** In addition, as a special exception, Nokia gives you certain additional
  19 ** rights. These rights are described in the Nokia Qt LGPL Exception
  20 ** version 1.1, included in the file LGPL_EXCEPTION.txt in this package.
  21 **
  22 ** GNU General Public License Usage
  23 ** Alternatively, this file may be used under the terms of the GNU General
  24 ** Public License version 3.0 as published by the Free Software Foundation
  25 ** and appearing in the file LICENSE.GPL included in the packaging of this
  26 ** file. Please review the following information to ensure the GNU General
  27 ** Public License version 3.0 requirements will be met:
  28 ** http://www.gnu.org/copyleft/gpl.html.
  29 **
  30 ** Other Usage
  31 ** Alternatively, this file may be used in accordance with the terms and
  32 ** conditions contained in a signed written agreement between you and Nokia.
  33 **
  34 **
  35 **
  36 **
  37 **
  38 ** $QT_END_LICENSE$
  39 **
  40 ****************************************************************************/
  41
  42 #ifndef QSTRING_H
  43 #define QSTRING_H
  44
  45 #include <QtCore/qchar.h>
  46 #include <QtCore/qbytearray.h>
  47 #include <QtCore/qrefcount.h>
  48 #include <QtCore/qnamespace.h>
  49
  50 #ifndef QT_NO_STL
  51 #  include <string>
  52
  53 #  ifndef QT_NO_STL_WCHAR
  54 // workaround for some headers not typedef'ing std::wstring
  55 typedef std::basic_string<wchar_t> QStdWString;
  56 #  endif // QT_NO_STL_WCHAR
  57
  58 #endif // QT_NO_STL
  59
  60 #include <stdarg.h>
  61
  62 #ifdef truncate
  63 #error qstring.h must be included before any header file that defines truncate
  64 #endif
  65
  66 QT_BEGIN_HEADER
  67
  68 QT_BEGIN_NAMESPACE
  69
  70 QT_MODULE(Core)
  71
  72 class QCharRef;
  73 class QRegExp;
  74 class QStringList;
  75 class QTextCodec;
  76 class QLatin1String;
  77 class QStringRef;
  78 template <typename T> class QVector;
  79
  80 struct QStringData {
  81     QtPrivate::RefCount ref;
  82     int size;
  83     uint alloc : 31;
  84     uint capacityReserved : 1;
  85     union {
  86         qptrdiff offset; // will always work as we add/subtract from a ushort ptr
  87         ushort d[sizeof(qptrdiff)/sizeof(ushort)];
  88     };
  89     inline ushort *data() { return d + sizeof(qptrdiff)/sizeof(ushort) + offset; }
  90     inline const ushort *data() const { return d + sizeof(qptrdiff)/sizeof(ushort) + offset; }
  91 };
  92
  93 template<int N> struct QConstStringData;
  94 template<int N> struct QConstStringDataPtr
  95 {
  96     const QConstStringData<N> *ptr;
  97 };
  98
  99 #if defined(Q_COMPILER_UNICODE_STRINGS)
 100 template<int N> struct QConstStringData
 101 {
 102     const QStringData str;
 103     const char16_t data[N + 1];
 104 };
 105
 106 #define QT_UNICODE_LITERAL_II(str) u"" str
 107
 108 #elif defined(Q_OS_WIN) || (defined(__SIZEOF_WCHAR_T__) && __SIZEOF_WCHAR_T__ == 2) || defined(WCHAR_MAX) && (WCHAR_MAX - 0 < 65536)
 109 // wchar_t is 2 bytes
 110 template<int N> struct QConstStringData
 111 {
 112     const QStringData str;
 113     const wchar_t data[N + 1];
 114 };
 115
 116 #if defined(Q_CC_MSVC)
 117 #    define QT_UNICODE_LITERAL_II(str) L##str
 118 #else
 119 #    define QT_UNICODE_LITERAL_II(str) L"" str
 120 #endif
 121
 122 #else
 123 template<int N> struct QConstStringData
 124 {
 125     const QStringData str;
 126     const ushort data[N + 1];
 127 };
 128 #endif
 129
 130 #if defined(QT_UNICODE_LITERAL_II)
 131 #  define QT_UNICODE_LITERAL(str) QT_UNICODE_LITERAL_II(str)
 132 # if defined(Q_COMPILER_LAMBDA)
 133 #  define QStringLiteral(str) ([]() -> QConstStringDataPtr<sizeof(QT_UNICODE_LITERAL(str))/2 - 1> { \
 134         enum { Size = sizeof(QT_UNICODE_LITERAL(str))/2 - 1 }; \
 135         static const QConstStringData<Size> qstring_literal = \
 136         { { Q_REFCOUNT_INITIALIZER(-1), Size, 0, 0, { 0 } }, QT_UNICODE_LITERAL(str) }; \
 137         QConstStringDataPtr<Size> holder = { &qstring_literal }; \
 138     return holder; }())
 139
 140 # elif defined(Q_CC_GNU)
 141 // We need to create a QStringData in the .rodata section of memory
 142 // and the only way to do that is to create a "static const" variable.
 143 // To do that, we need the __extension__ {( )} trick which only GCC supports
 144
 145 #  define QStringLiteral(str) \
 146     __extension__ ({ \
 147         enum { Size = sizeof(QT_UNICODE_LITERAL(str))/2 - 1 }; \
 148         static const QConstStringData<Size> qstring_literal = \
 149         { { Q_REFCOUNT_INITIALIZER(-1), Size, 0, 0, { 0 } }, QT_UNICODE_LITERAL(str) }; \
 150         QConstStringDataPtr<Size> holder = { &qstring_literal }; \
 151         holder; })
 152 # endif
 153 #endif
 154
 155 #ifndef QStringLiteral
 156 // no lambdas, not GCC, or GCC in C++98 mode with 4-byte wchar_t
 157 // fallback, uses QLatin1String as next best options
 158
 159 # define QStringLiteral(str) QLatin1String(str)
 160 #endif
 161
 162 class Q_CORE_EXPORT QString
 163 {
 164 public:
 165     typedef QStringData Data;
 166
 167     inline QString();
 168     QString(const QChar *unicode, int size); // Qt5: don't cap size < 0
 169     explicit QString(const QChar *unicode); // Qt5: merge with the above
 170     QString(QChar c);
 171     QString(int size, QChar c);
 172     inline QString(const QLatin1String &latin1);
 173     inline QString(const QString &);
 174     inline ~QString();
 175     QString &operator=(QChar c);
 176     QString &operator=(const QString &);
 177     inline QString &operator=(const QLatin1String &);
 178 #ifdef Q_COMPILER_RVALUE_REFS
 179     inline QString &operator=(QString &&other)
 180     { qSwap(d, other.d); return *this; }
 181 #endif
 182     inline void swap(QString &other) { qSwap(d, other.d); }
 183     inline int size() const { return d->size; }
 184     inline int count() const { return d->size; }
 185     inline int length() const;
 186     inline bool isEmpty() const;
 187     void resize(int size);
 188
 189     QString &fill(QChar c, int size = -1);
 190     void truncate(int pos);
 191     void chop(int n);
 192
 193     int capacity() const;
 194     inline void reserve(int size);
 195     inline void squeeze();
 196
 197     inline const QChar *unicode() const;
 198     inline QChar *data();
 199     inline const QChar *data() const;
 200     inline const QChar *constData() const;
 201
 202     inline void detach();
 203     inline bool isDetached() const;
 204     inline bool isSharedWith(const QString &other) const { return d == other.d; }
 205     void clear();
 206
 207     inline const QChar at(int i) const;
 208     const QChar operator[](int i) const;
 209     QCharRef operator[](int i);
 210     const QChar operator[](uint i) const;
 211     QCharRef operator[](uint i);
 212
 213     QString arg(qlonglong a, int fieldwidth=0, int base=10,
 214                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 215     QString arg(qulonglong a, int fieldwidth=0, int base=10,
 216                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 217     QString arg(long a, int fieldwidth=0, int base=10,
 218                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 219     QString arg(ulong a, int fieldwidth=0, int base=10,
 220                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 221     QString arg(int a, int fieldWidth = 0, int base = 10,
 222                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 223     QString arg(uint a, int fieldWidth = 0, int base = 10,
 224                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 225     QString arg(short a, int fieldWidth = 0, int base = 10,
 226                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 227     QString arg(ushort a, int fieldWidth = 0, int base = 10,
 228                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 229     QString arg(double a, int fieldWidth = 0, char fmt = 'g', int prec = -1,
 230                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 231     QString arg(char a, int fieldWidth = 0,
 232                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 233     QString arg(QChar a, int fieldWidth = 0,
 234                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 235     QString arg(const QString &a, int fieldWidth = 0,
 236                 QChar fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
 237     QString arg(const QString &a1, const QString &a2) const Q_REQUIRED_RESULT;
 238     QString arg(const QString &a1, const QString &a2, const QString &a3) const Q_REQUIRED_RESULT;
 239     QString arg(const QString &a1, const QString &a2, const QString &a3,
 240                 const QString &a4) const Q_REQUIRED_RESULT;
 241     QString arg(const QString &a1, const QString &a2, const QString &a3,
 242                 const QString &a4, const QString &a5) const Q_REQUIRED_RESULT;
 243     QString arg(const QString &a1, const QString &a2, const QString &a3,
 244                 const QString &a4, const QString &a5, const QString &a6) const Q_REQUIRED_RESULT;
 245     QString arg(const QString &a1, const QString &a2, const QString &a3,
 246                 const QString &a4, const QString &a5, const QString &a6,
 247                 const QString &a7) const Q_REQUIRED_RESULT;
 248     QString arg(const QString &a1, const QString &a2, const QString &a3,
 249                 const QString &a4, const QString &a5, const QString &a6,
 250                 const QString &a7, const QString &a8) const Q_REQUIRED_RESULT;
 251     QString arg(const QString &a1, const QString &a2, const QString &a3,
 252                 const QString &a4, const QString &a5, const QString &a6,
 253                 const QString &a7, const QString &a8, const QString &a9) const Q_REQUIRED_RESULT;
 254
 255     QString    &vsprintf(const char *format, va_list ap)
 256 #if defined(Q_CC_GNU) && !defined(__INSURE__)
 257         __attribute__ ((format (printf, 2, 0)))
 258 #endif
 259         ;
 260     QString    &sprintf(const char *format, ...)
 261 #if defined(Q_CC_GNU) && !defined(__INSURE__)
 262         __attribute__ ((format (printf, 2, 3)))
 263 #endif
 264         ;
 265
 266     int indexOf(QChar c, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 267     int indexOf(const QString &s, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 268     int indexOf(const QLatin1String &s, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 269     int indexOf(const QStringRef &s, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 270     int lastIndexOf(QChar c, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 271     int lastIndexOf(const QString &s, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 272     int lastIndexOf(const QLatin1String &s, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 273     int lastIndexOf(const QStringRef &s, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 274
 275     inline QBool contains(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 276     inline QBool contains(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 277     inline QBool contains(const QStringRef &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 278     int count(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 279     int count(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 280     int count(const QStringRef &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 281
 282 #ifndef QT_NO_REGEXP
 283     int indexOf(const QRegExp &, int from = 0) const;
 284     int lastIndexOf(const QRegExp &, int from = -1) const;
 285     inline QBool contains(const QRegExp &rx) const { return QBool(indexOf(rx) != -1); }
 286     int count(const QRegExp &) const;
 287
 288     int indexOf(QRegExp &, int from = 0) const;
 289     int lastIndexOf(QRegExp &, int from = -1) const;
 290     inline QBool contains(QRegExp &rx) const { return QBool(indexOf(rx) != -1); }
 291 #endif
 292
 293     enum SectionFlag {
 294         SectionDefault             = 0x00,
 295         SectionSkipEmpty           = 0x01,
 296         SectionIncludeLeadingSep   = 0x02,
 297         SectionIncludeTrailingSep  = 0x04,
 298         SectionCaseInsensitiveSeps = 0x08
 299     };
 300     Q_DECLARE_FLAGS(SectionFlags, SectionFlag)
 301
 302     QString section(QChar sep, int start, int end = -1, SectionFlags flags = SectionDefault) const;
 303     QString section(const QString &in_sep, int start, int end = -1, SectionFlags flags = SectionDefault) const;
 304 #ifndef QT_NO_REGEXP
 305     QString section(const QRegExp &reg, int start, int end = -1, SectionFlags flags = SectionDefault) const;
 306 #endif
 307
 308     QString left(int n) const Q_REQUIRED_RESULT;
 309     QString right(int n) const Q_REQUIRED_RESULT;
 310     QString mid(int position, int n = -1) const Q_REQUIRED_RESULT;
 311     QStringRef leftRef(int n) const Q_REQUIRED_RESULT;
 312     QStringRef rightRef(int n) const Q_REQUIRED_RESULT;
 313     QStringRef midRef(int position, int n = -1) const Q_REQUIRED_RESULT;
 314
 315     bool startsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 316     bool startsWith(const QStringRef &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 317     bool startsWith(const QLatin1String &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 318     bool startsWith(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 319     bool endsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 320     bool endsWith(const QStringRef &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 321     bool endsWith(const QLatin1String &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 322     bool endsWith(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 323
 324     QString leftJustified(int width, QChar fill = QLatin1Char(' '), bool trunc = false) const Q_REQUIRED_RESULT;
 325     QString rightJustified(int width, QChar fill = QLatin1Char(' '), bool trunc = false) const Q_REQUIRED_RESULT;
 326
 327     QString toLower() const Q_REQUIRED_RESULT;
 328     QString toUpper() const Q_REQUIRED_RESULT;
 329     QString toCaseFolded() const Q_REQUIRED_RESULT;
 330
 331     QString trimmed() const Q_REQUIRED_RESULT;
 332     QString simplified() const Q_REQUIRED_RESULT;
 333     QString toHtmlEscaped() const Q_REQUIRED_RESULT;
 334
 335     QString &insert(int i, QChar c);
 336     QString &insert(int i, const QChar *uc, int len);
 337     inline QString &insert(int i, const QString &s) { return insert(i, s.constData(), s.length()); }
 338     QString &insert(int i, const QLatin1String &s);
 339     QString &append(QChar c);
 340     QString &append(const QString &s);
 341     QString &append(const QStringRef &s);
 342     QString &append(const QLatin1String &s);
 343     inline QString &prepend(QChar c) { return insert(0, c); }
 344     inline QString &prepend(const QString &s) { return insert(0, s); }
 345     inline QString &prepend(const QLatin1String &s) { return insert(0, s); }
 346
 347     inline QString &operator+=(QChar c) {
 348         if (d->ref != 1 || d->size + 1 > int(d->alloc))
 349             realloc(grow(d->size + 1));
 350         d->data()[d->size++] = c.unicode();
 351         d->data()[d->size] = '\0';
 352         return *this;
 353     }
 354
 355     inline QString &operator+=(QChar::SpecialCharacter c) { return append(QChar(c)); }
 356     inline QString &operator+=(const QString &s) { return append(s); }
 357     inline QString &operator+=(const QStringRef &s) { return append(s); }
 358     inline QString &operator+=(const QLatin1String &s) { return append(s); }
 359
 360     QString &remove(int i, int len);
 361     QString &remove(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 362     QString &remove(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 363     QString &replace(int i, int len, QChar after);
 364     QString &replace(int i, int len, const QChar *s, int slen);
 365     QString &replace(int i, int len, const QString &after);
 366     QString &replace(QChar before, QChar after, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 367     QString &replace(const QChar *before, int blen, const QChar *after, int alen, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 368     QString &replace(const QLatin1String &before, const QLatin1String &after, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 369     QString &replace(const QLatin1String &before, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 370     QString &replace(const QString &before, const QLatin1String &after, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 371     QString &replace(const QString &before, const QString &after,
 372                      Qt::CaseSensitivity cs = Qt::CaseSensitive);
 373     QString &replace(QChar c, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 374     QString &replace(QChar c, const QLatin1String &after, Qt::CaseSensitivity cs = Qt::CaseSensitive);
 375 #ifndef QT_NO_REGEXP
 376     QString &replace(const QRegExp &rx, const QString &after);
 377     inline QString &remove(const QRegExp &rx)
 378     { return replace(rx, QString()); }
 379 #endif
 380
 381     enum SplitBehavior { KeepEmptyParts, SkipEmptyParts };
 382
 383     QStringList split(const QString &sep, SplitBehavior behavior = KeepEmptyParts,
 384                       Qt::CaseSensitivity cs = Qt::CaseSensitive) const Q_REQUIRED_RESULT;
 385     QStringList split(QChar sep, SplitBehavior behavior = KeepEmptyParts,
 386                       Qt::CaseSensitivity cs = Qt::CaseSensitive) const Q_REQUIRED_RESULT;
 387 #ifndef QT_NO_REGEXP
 388     QStringList split(const QRegExp &sep, SplitBehavior behavior = KeepEmptyParts) const Q_REQUIRED_RESULT;
 389 #endif
 390
 391     enum NormalizationForm {
 392         NormalizationForm_D,
 393         NormalizationForm_C,
 394         NormalizationForm_KD,
 395         NormalizationForm_KC
 396     };
 397     QString normalized(NormalizationForm mode) const Q_REQUIRED_RESULT;
 398     QString normalized(NormalizationForm mode, QChar::UnicodeVersion version) const Q_REQUIRED_RESULT;
 399
 400     QString repeated(int times) const;
 401
 402     const ushort *utf16() const;
 403
 404     QByteArray toAscii() const Q_REQUIRED_RESULT;
 405     QByteArray toLatin1() const Q_REQUIRED_RESULT;
 406     QByteArray toUtf8() const Q_REQUIRED_RESULT;
 407     QByteArray toLocal8Bit() const Q_REQUIRED_RESULT;
 408     QVector<uint> toUcs4() const Q_REQUIRED_RESULT;
 409
 410     static QString fromAscii(const char *, int size = -1);
 411     static QString fromLatin1(const char *, int size = -1);
 412     static QString fromUtf8(const char *, int size = -1);
 413     static QString fromLocal8Bit(const char *, int size = -1);
 414     static QString fromUtf16(const ushort *, int size = -1);
 415     static QString fromUcs4(const uint *, int size = -1);
 416     static QString fromRawData(const QChar *, int size);
 417
 418     inline int toWCharArray(wchar_t *array) const;
 419     static inline QString fromWCharArray(const wchar_t *string, int size = -1) Q_REQUIRED_RESULT;
 420
 421     QString &setRawData(const QChar *unicode, int size);
 422     QString &setUnicode(const QChar *unicode, int size);
 423     inline QString &setUtf16(const ushort *utf16, int size);
 424
 425     int compare(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 426     int compare(const QLatin1String &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 427
 428     static inline int compare(const QString &s1, const QString &s2, Qt::CaseSensitivity cs = Qt::CaseSensitive)
 429     { return s1.compare(s2, cs); }
 430
 431     static inline int compare(const QString& s1, const QLatin1String &s2,
 432                               Qt::CaseSensitivity cs = Qt::CaseSensitive)
 433     { return s1.compare(s2, cs); }
 434     static inline int compare(const QLatin1String& s1, const QString &s2,
 435                               Qt::CaseSensitivity cs = Qt::CaseSensitive)
 436     { return -s2.compare(s1, cs); }
 437
 438     int compare(const QStringRef &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
 439     static int compare(const QString &s1, const QStringRef &s2,
 440                        Qt::CaseSensitivity = Qt::CaseSensitive);
 441
 442     int localeAwareCompare(const QString& s) const;
 443     static int localeAwareCompare(const QString& s1, const QString& s2)
 444     { return s1.localeAwareCompare(s2); }
 445
 446     int localeAwareCompare(const QStringRef &s) const;
 447     static int localeAwareCompare(const QString& s1, const QStringRef& s2);
 448
 449     short  toShort(bool *ok=0, int base=10) const;
 450     ushort toUShort(bool *ok=0, int base=10) const;
 451     int toInt(bool *ok=0, int base=10) const;
 452     uint toUInt(bool *ok=0, int base=10) const;
 453     long toLong(bool *ok=0, int base=10) const;
 454     ulong toULong(bool *ok=0, int base=10) const;
 455     qlonglong toLongLong(bool *ok=0, int base=10) const;
 456     qulonglong toULongLong(bool *ok=0, int base=10) const;
 457     float toFloat(bool *ok=0) const;
 458     double toDouble(bool *ok=0) const;
 459
 460     QString &setNum(short, int base=10);
 461     QString &setNum(ushort, int base=10);
 462     QString &setNum(int, int base=10);
 463     QString &setNum(uint, int base=10);
 464     QString &setNum(long, int base=10);
 465     QString &setNum(ulong, int base=10);
 466     QString &setNum(qlonglong, int base=10);
 467     QString &setNum(qulonglong, int base=10);
 468     QString &setNum(float, char f='g', int prec=6);
 469     QString &setNum(double, char f='g', int prec=6);
 470
 471     static QString number(int, int base=10);
 472     static QString number(uint, int base=10);
 473     static QString number(long, int base=10);
 474     static QString number(ulong, int base=10);
 475     static QString number(qlonglong, int base=10);
 476     static QString number(qulonglong, int base=10);
 477     static QString number(double, char f='g', int prec=6);
 478
 479     bool operator==(const QString &s) const;
 480     bool operator<(const QString &s) const;
 481     inline bool operator>(const QString &s) const { return s < *this; }
 482     inline bool operator!=(const QString &s) const { return !operator==(s); }
 483     inline bool operator<=(const QString &s) const { return !operator>(s); }
 484     inline bool operator>=(const QString &s) const { return !operator<(s); }
 485
 486     bool operator==(const QLatin1String &s) const;
 487     bool operator<(const QLatin1String &s) const;
 488     bool operator>(const QLatin1String &s) const;
 489     inline bool operator!=(const QLatin1String &s) const { return !operator==(s); }
 490     inline bool operator<=(const QLatin1String &s) const { return !operator>(s); }
 491     inline bool operator>=(const QLatin1String &s) const { return !operator<(s); }
 492
 493     // ASCII compatibility
 494 #ifndef QT_NO_CAST_FROM_ASCII
 495     inline QT_ASCII_CAST_WARN_CONSTRUCTOR QString(const char *ch) : d(fromAscii_helper(ch))
 496     {}
 497     inline QT_ASCII_CAST_WARN_CONSTRUCTOR QString(const QByteArray &a)
 498         : d(fromAscii_helper(a.constData(), qstrnlen(a.constData(), a.size())))
 499     {}
 500     inline QT_ASCII_CAST_WARN QString &operator=(const char *ch)
 501     { return (*this = fromAscii(ch)); }
 502     inline QT_ASCII_CAST_WARN QString &operator=(const QByteArray &a)
 503     { return (*this = fromAscii(a.constData(), qstrnlen(a.constData(), a.size()))); }
 504     inline QT_ASCII_CAST_WARN QString &operator=(char c)
 505     { return (*this = QChar::fromAscii(c)); }
 506
 507     // these are needed, so it compiles with STL support enabled
 508     inline QT_ASCII_CAST_WARN QString &prepend(const char *s)
 509     { return prepend(QString::fromAscii(s)); }
 510     inline QT_ASCII_CAST_WARN QString &prepend(const QByteArray &s)
 511     { return prepend(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }
 512     inline QT_ASCII_CAST_WARN QString &append(const char *s)
 513     { return append(QString::fromAscii(s)); }
 514     inline QT_ASCII_CAST_WARN QString &append(const QByteArray &s)
 515     { return append(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }
 516     inline QT_ASCII_CAST_WARN QString &operator+=(const char *s)
 517     { return append(QString::fromAscii(s)); }
 518     inline QT_ASCII_CAST_WARN QString &operator+=(const QByteArray &s)
 519     { return append(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }
 520     inline QT_ASCII_CAST_WARN QString &operator+=(char c)
 521     { return append(QChar::fromAscii(c)); }
 522
 523     inline QT_ASCII_CAST_WARN bool operator==(const char *s) const;
 524     inline QT_ASCII_CAST_WARN bool operator!=(const char *s) const;
 525     inline QT_ASCII_CAST_WARN bool operator<(const char *s) const;
 526     inline QT_ASCII_CAST_WARN bool operator<=(const char *s2) const;
 527     inline QT_ASCII_CAST_WARN bool operator>(const char *s2) const;
 528     inline QT_ASCII_CAST_WARN bool operator>=(const char *s2) const;
 529
 530     inline QT_ASCII_CAST_WARN bool operator==(const QByteArray &s) const;
 531     inline QT_ASCII_CAST_WARN bool operator!=(const QByteArray &s) const;
 532     inline QT_ASCII_CAST_WARN bool operator<(const QByteArray &s) const
 533     { return *this < QString::fromAscii(s.constData(), s.size()); }
 534     inline QT_ASCII_CAST_WARN bool operator>(const QByteArray &s) const
 535     { return *this > QString::fromAscii(s.constData(), s.size()); }
 536     inline QT_ASCII_CAST_WARN bool operator<=(const QByteArray &s) const
 537     { return *this <= QString::fromAscii(s.constData(), s.size()); }
 538     inline QT_ASCII_CAST_WARN bool operator>=(const QByteArray &s) const
 539     { return *this >= QString::fromAscii(s.constData(), s.size()); }
 540 #endif
 541
 542     typedef QChar *iterator;
 543     typedef const QChar *const_iterator;
 544     typedef iterator Iterator;
 545     typedef const_iterator ConstIterator;
 546     iterator begin();
 547     const_iterator begin() const;
 548     const_iterator constBegin() const;
 549     iterator end();
 550     const_iterator end() const;
 551     const_iterator constEnd() const;
 552
 553     // STL compatibility
 554     typedef const QChar & const_reference;
 555     typedef QChar & reference;
 556     typedef QChar value_type;
 557     inline void push_back(QChar c) { append(c); }
 558     inline void push_back(const QString &s) { append(s); }
 559     inline void push_front(QChar c) { prepend(c); }
 560     inline void push_front(const QString &s) { prepend(s); }
 561
 562 #ifndef QT_NO_STL
 563     static inline QString fromStdString(const std::string &s);
 564     inline std::string toStdString() const;
 565 # ifdef qdoc
 566     static inline QString fromStdWString(const std::wstring &s);
 567     inline std::wstring toStdWString() const;
 568 # else
 569 #  ifndef QT_NO_STL_WCHAR
 570     static inline QString fromStdWString(const QStdWString &s);
 571     inline QStdWString toStdWString() const;
 572 #  endif // QT_NO_STL_WCHAR
 573 # endif // qdoc
 574 #endif
 575
 576     // compatibility
 577     struct Null { };
 578     static const Null null;
 579     inline QString(const Null &): d(const_cast<Data *>(&shared_null.str)) {}
 580     inline QString &operator=(const Null &) { *this = QString(); return *this; }
 581     inline bool isNull() const { return d == &shared_null.str; }
 582
 583
 584     bool isSimpleText() const;
 585     bool isRightToLeft() const;
 586
 587     QString(int size, Qt::Initialization);
 588     template <int n>
 589     inline QString(const QConstStringData<n> &dd) : d(const_cast<QStringData *>(&dd.str)) {}
 590     template <int N>
 591     Q_DECL_CONSTEXPR inline QString(QConstStringDataPtr<N> dd) : d(const_cast<QStringData *>(&dd.ptr->str)) {}
 592
 593 private:
 594 #if defined(QT_NO_CAST_FROM_ASCII) && !defined(Q_NO_DECLARED_NOT_DEFINED)
 595     QString &operator+=(const char *s);
 596     QString &operator+=(const QByteArray &s);
 597     QString(const char *ch);
 598     QString(const QByteArray &a);
 599     QString &operator=(const char  *ch);
 600     QString &operator=(const QByteArray &a);
 601 #endif
 602
 603     static const QConstStringData<1> shared_null;
 604     static const QConstStringData<1> shared_empty;
 605     Data *d;
 606     inline QString(Data *dd, int /*dummy*/) : d(dd) {}
 607
 608 #ifndef QT_NO_TEXTCODEC
 609     static QTextCodec *codecForCStrings;
 610 #endif
 611     static int grow(int);
 612     static void free(Data *);
 613     void realloc();
 614     void realloc(int alloc);
 615     void expand(int i);
 616     void updateProperties() const;
 617     QString multiArg(int numArgs, const QString **args) const;
 618     static int compare_helper(const QChar *data1, int length1,
 619                               const QChar *data2, int length2,
 620                               Qt::CaseSensitivity cs = Qt::CaseSensitive);
 621     static int compare_helper(const QChar *data1, int length1,
 622                               QLatin1String s2,
 623                               Qt::CaseSensitivity cs = Qt::CaseSensitive);
 624     static int localeAwareCompare_helper(const QChar *data1, int length1,
 625                                          const QChar *data2, int length2);
 626     static Data *fromLatin1_helper(const char *str, int size = -1);
 627     static Data *fromAscii_helper(const char *str, int size = -1);
 628     static int toUcs4_helper(const ushort *uc, int length, uint *out);
 629     void replace_helper(uint *indices, int nIndices, int blen, const QChar *after, int alen);
 630     friend class QCharRef;
 631     friend class QTextCodec;
 632     friend class QStringRef;
 633     friend struct QAbstractConcatenable;
 634     friend inline bool qStringComparisonHelper(const QString &s1, const char *s2);
 635     friend inline bool qStringComparisonHelper(const QStringRef &s1, const char *s2);
 636 public:
 637     typedef Data * DataPtr;
 638     inline DataPtr &data_ptr() { return d; }
 639 };
 640
 641
 642 class QLatin1String
 643 {
 644 public:
 645     Q_DECL_CONSTEXPR inline explicit QLatin1String(const char *s) : m_size(s ? int(strlen(s)) : 0), m_data(s) {}
 646
 647     inline const char *latin1() const { return m_data; }
 648     inline int size() const { return m_size; }
 649     inline const char *data() const { return m_data; }
 650
 651     inline bool operator==(const QString &s) const
 652     { return s == *this; }
 653     inline bool operator!=(const QString &s) const
 654     { return s != *this; }
 655     inline bool operator>(const QString &s) const
 656     { return s < *this; }
 657     inline bool operator<(const QString &s) const
 658     { return s > *this; }
 659     inline bool operator>=(const QString &s) const
 660     { return s <= *this; }
 661     inline bool operator<=(const QString &s) const
 662     { return s >= *this; }
 663
 664     inline QT_ASCII_CAST_WARN bool operator==(const char *s) const
 665         { return QString::fromAscii(s) == *this; }
 666     inline QT_ASCII_CAST_WARN bool operator!=(const char *s) const
 667         { return QString::fromAscii(s) != *this; }
 668     inline QT_ASCII_CAST_WARN bool operator<(const char *s) const
 669         { return QString::fromAscii(s) > *this; }
 670     inline QT_ASCII_CAST_WARN bool operator>(const char *s) const
 671         { return QString::fromAscii(s) < *this; }
 672     inline QT_ASCII_CAST_WARN bool operator<=(const char *s) const
 673         { return QString::fromAscii(s) >= *this; }
 674     inline QT_ASCII_CAST_WARN bool operator>=(const char *s) const
 675         { return QString::fromAscii(s) <= *this; }
 676 private:
 677     int m_size;
 678     const char *m_data;
 679 };
 680
 681 // Qt 4.x compatibility
 682 typedef QLatin1String QLatin1Literal;
 683
 684
 685 inline QString::QString(const QLatin1String &aLatin1) : d(fromLatin1_helper(aLatin1.latin1()))
 686 { }
 687 inline int QString::length() const
 688 { return d->size; }
 689 inline const QChar QString::at(int i) const
 690 { Q_ASSERT(uint(i) < uint(size())); return d->data()[i]; }
 691 inline const QChar QString::operator[](int i) const
 692 { Q_ASSERT(uint(i) < uint(size())); return d->data()[i]; }
 693 inline const QChar QString::operator[](uint i) const
 694 { Q_ASSERT(i < uint(size())); return d->data()[i]; }
 695 inline bool QString::isEmpty() const
 696 { return d->size == 0; }
 697 inline const QChar *QString::unicode() const
 698 { return reinterpret_cast<const QChar*>(d->data()); }
 699 inline const QChar *QString::data() const
 700 { return reinterpret_cast<const QChar*>(d->data()); }
 701 inline QChar *QString::data()
 702 { detach(); return reinterpret_cast<QChar*>(d->data()); }
 703 inline const QChar *QString::constData() const
 704 { return reinterpret_cast<const QChar*>(d->data()); }
 705 inline void QString::detach()
 706 { if (d->ref != 1 || d->offset) realloc(); }
 707 inline bool QString::isDetached() const
 708 { return d->ref == 1; }
 709 inline QString &QString::operator=(const QLatin1String &s)
 710 {
 711     *this = fromLatin1(s.latin1());
 712     return *this;
 713 }
 714 inline void QString::clear()
 715 { if (!isNull()) *this = QString(); }
 716 inline QString::QString(const QString &other) : d(other.d)
 717 { Q_ASSERT(&other != this); d->ref.ref(); }
 718 inline int QString::capacity() const
 719 { return d->alloc; }
 720 inline QString &QString::setNum(short n, int base)
 721 { return setNum(qlonglong(n), base); }
 722 inline QString &QString::setNum(ushort n, int base)
 723 { return setNum(qulonglong(n), base); }
 724 inline QString &QString::setNum(int n, int base)
 725 { return setNum(qlonglong(n), base); }
 726 inline QString &QString::setNum(uint n, int base)
 727 { return setNum(qulonglong(n), base); }
 728 inline QString &QString::setNum(long n, int base)
 729 { return setNum(qlonglong(n), base); }
 730 inline QString &QString::setNum(ulong n, int base)
 731 { return setNum(qulonglong(n), base); }
 732 inline QString &QString::setNum(float n, char f, int prec)
 733 { return setNum(double(n),f,prec); }
 734 inline QString QString::arg(int a, int fieldWidth, int base, QChar fillChar) const
 735 { return arg(qlonglong(a), fieldWidth, base, fillChar); }
 736 inline QString QString::arg(uint a, int fieldWidth, int base, QChar fillChar) const
 737 { return arg(qulonglong(a), fieldWidth, base, fillChar); }
 738 inline QString QString::arg(long a, int fieldWidth, int base, QChar fillChar) const
 739 { return arg(qlonglong(a), fieldWidth, base, fillChar); }
 740 inline QString QString::arg(ulong a, int fieldWidth, int base, QChar fillChar) const
 741 { return arg(qulonglong(a), fieldWidth, base, fillChar); }
 742 inline QString QString::arg(short a, int fieldWidth, int base, QChar fillChar) const
 743 { return arg(qlonglong(a), fieldWidth, base, fillChar); }
 744 inline QString QString::arg(ushort a, int fieldWidth, int base, QChar fillChar) const
 745 { return arg(qulonglong(a), fieldWidth, base, fillChar); }
 746 inline QString QString::arg(const QString &a1, const QString &a2) const
 747 { const QString *args[2] = { &a1, &a2 }; return multiArg(2, args); }
 748 inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3) const
 749 { const QString *args[3] = { &a1, &a2, &a3 }; return multiArg(3, args); }
 750 inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
 751                             const QString &a4) const
 752 { const QString *args[4] = { &a1, &a2, &a3, &a4 }; return multiArg(4, args); }
 753 inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
 754                             const QString &a4, const QString &a5) const
 755 { const QString *args[5] = { &a1, &a2, &a3, &a4, &a5 }; return multiArg(5, args); }
 756 inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
 757                             const QString &a4, const QString &a5, const QString &a6) const
 758 { const QString *args[6] = { &a1, &a2, &a3, &a4, &a5, &a6 }; return multiArg(6, args); }
 759 inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
 760                             const QString &a4, const QString &a5, const QString &a6,
 761                             const QString &a7) const
 762 { const QString *args[7] = { &a1, &a2, &a3, &a4, &a5, &a6,  &a7 }; return multiArg(7, args); }
 763 inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
 764                             const QString &a4, const QString &a5, const QString &a6,
 765                             const QString &a7, const QString &a8) const
 766 { const QString *args[8] = { &a1, &a2, &a3, &a4, &a5, &a6,  &a7, &a8 }; return multiArg(8, args); }
 767 inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
 768                             const QString &a4, const QString &a5, const QString &a6,
 769                             const QString &a7, const QString &a8, const QString &a9) const
 770 { const QString *args[9] = { &a1, &a2, &a3, &a4, &a5, &a6,  &a7, &a8, &a9 }; return multiArg(9, args); }
 771
 772 inline QString QString::section(QChar asep, int astart, int aend, SectionFlags aflags) const
 773 { return section(QString(asep), astart, aend, aflags); }
 774
 775 inline int QString::toWCharArray(wchar_t *array) const
 776 {
 777     if (sizeof(wchar_t) == sizeof(QChar)) {
 778         qMemCopy(array, d->data(), sizeof(QChar) * size());
 779         return size();
 780     }
 781     return toUcs4_helper(d->data(), size(), reinterpret_cast<uint *>(array));
 782 }
 783 inline QString QString::fromWCharArray(const wchar_t *string, int size)
 784 {
 785     return sizeof(wchar_t) == sizeof(QChar) ? fromUtf16((const ushort *)string, size)
 786                                             : fromUcs4((uint *)string, size);
 787 }
 788
 789
 790 class Q_CORE_EXPORT QCharRef {
 791     QString &s;
 792     int i;
 793     inline QCharRef(QString &str, int idx)
 794         : s(str),i(idx) {}
 795     friend class QString;
 796 public:
 797
 798     // most QChar operations repeated here
 799
 800     // all this is not documented: We just say "like QChar" and let it be.
 801     inline operator QChar() const
 802     { return i < s.d->size ? s.d->data()[i] : 0; }
 803     inline QCharRef &operator=(QChar c)
 804     { if (i >= s.d->size) s.expand(i); else s.detach();
 805       s.d->data()[i] = c.unicode(); return *this; }
 806
 807     // An operator= for each QChar cast constructors
 808 #ifndef QT_NO_CAST_FROM_ASCII
 809     inline QT_ASCII_CAST_WARN QCharRef &operator=(char c)
 810     { return operator=(QChar::fromAscii(c)); }
 811     inline QT_ASCII_CAST_WARN QCharRef &operator=(uchar c)
 812     { return operator=(QChar::fromAscii(c)); }
 813 #endif
 814     inline QCharRef &operator=(const QCharRef &c) { return operator=(QChar(c)); }
 815     inline QCharRef &operator=(ushort rc) { return operator=(QChar(rc)); }
 816     inline QCharRef &operator=(short rc) { return operator=(QChar(rc)); }
 817     inline QCharRef &operator=(uint rc) { return operator=(QChar(rc)); }
 818     inline QCharRef &operator=(int rc) { return operator=(QChar(rc)); }
 819
 820     // each function...
 821     inline bool isNull() const { return QChar(*this).isNull(); }
 822     inline bool isPrint() const { return QChar(*this).isPrint(); }
 823     inline bool isPunct() const { return QChar(*this).isPunct(); }
 824     inline bool isSpace() const { return QChar(*this).isSpace(); }
 825     inline bool isMark() const { return QChar(*this).isMark(); }
 826     inline bool isLetter() const { return QChar(*this).isLetter(); }
 827     inline bool isNumber() const { return QChar(*this).isNumber(); }
 828     inline bool isLetterOrNumber() { return QChar(*this).isLetterOrNumber(); }
 829     inline bool isDigit() const { return QChar(*this).isDigit(); }
 830     inline bool isLower() const { return QChar(*this).isLower(); }
 831     inline bool isUpper() const { return QChar(*this).isUpper(); }
 832     inline bool isTitleCase() const { return QChar(*this).isTitleCase(); }
 833
 834     inline int digitValue() const { return QChar(*this).digitValue(); }
 835     QChar toLower() const { return QChar(*this).toLower(); }
 836     QChar toUpper() const { return QChar(*this).toUpper(); }
 837     QChar toTitleCase () const { return QChar(*this).toTitleCase(); }
 838
 839     QChar::Category category() const { return QChar(*this).category(); }
 840     QChar::Direction direction() const { return QChar(*this).direction(); }
 841     QChar::Joining joining() const { return QChar(*this).joining(); }
 842     bool hasMirrored() const { return QChar(*this).hasMirrored(); }
 843     QChar mirroredChar() const { return QChar(*this).mirroredChar(); }
 844     QString decomposition() const { return QChar(*this).decomposition(); }
 845     QChar::Decomposition decompositionTag() const { return QChar(*this).decompositionTag(); }
 846     uchar combiningClass() const { return QChar(*this).combiningClass(); }
 847
 848     QChar::UnicodeVersion unicodeVersion() const { return QChar(*this).unicodeVersion(); }
 849
 850     inline uchar cell() const { return QChar(*this).cell(); }
 851     inline uchar row() const { return QChar(*this).row(); }
 852     inline void setCell(uchar cell);
 853     inline void setRow(uchar row);
 854
 855     char toAscii() const { return QChar(*this).toAscii(); }
 856     char toLatin1() const { return QChar(*this).toLatin1(); }
 857     ushort unicode() const { return QChar(*this).unicode(); }
 858     ushort& unicode() { return s.data()[i].unicode(); }
 859
 860 };
 861
 862 inline void QCharRef::setRow(uchar arow) { QChar(*this).setRow(arow); }
 863 inline void QCharRef::setCell(uchar acell) { QChar(*this).setCell(acell); }
 864
 865
 866 inline QString::QString() : d(const_cast<Data *>(&shared_null.str)) {}
 867 inline QString::~QString() { if (!d->ref.deref()) free(d); }
 868
 869 inline void QString::reserve(int asize)
 870 {
 871     if (d->ref != 1 || asize > int(d->alloc))
 872         realloc(asize);
 873
 874     if (!d->capacityReserved) {
 875         // cannot set unconditionally, since d could be the shared_null/shared_empty (which is const)
 876         d->capacityReserved = true;
 877     }
 878 }
 879
 880 inline void QString::squeeze()
 881 {
 882     if (d->ref > 1 || d->size < int(d->alloc))
 883         realloc();
 884
 885     if (d->capacityReserved) {
 886         // cannot set unconditionally, since d could be the shared_null/shared_empty (which is const)
 887         d->capacityReserved = false;
 888     }
 889 }
 890
 891 inline QString &QString::setUtf16(const ushort *autf16, int asize)
 892 { return setUnicode(reinterpret_cast<const QChar *>(autf16), asize); }
 893 inline QCharRef QString::operator[](int i)
 894 { Q_ASSERT(i >= 0); return QCharRef(*this, i); }
 895 inline QCharRef QString::operator[](uint i)
 896 { return QCharRef(*this, i); }
 897 inline QString::iterator QString::begin()
 898 { detach(); return reinterpret_cast<QChar*>(d->data()); }
 899 inline QString::const_iterator QString::begin() const
 900 { return reinterpret_cast<const QChar*>(d->data()); }
 901 inline QString::const_iterator QString::constBegin() const
 902 { return reinterpret_cast<const QChar*>(d->data()); }
 903 inline QString::iterator QString::end()
 904 { detach(); return reinterpret_cast<QChar*>(d->data() + d->size); }
 905 inline QString::const_iterator QString::end() const
 906 { return reinterpret_cast<const QChar*>(d->data() + d->size); }
 907 inline QString::const_iterator QString::constEnd() const
 908 { return reinterpret_cast<const QChar*>(d->data() + d->size); }
 909 inline QBool QString::contains(const QString &s, Qt::CaseSensitivity cs) const
 910 { return QBool(indexOf(s, 0, cs) != -1); }
 911 inline QBool QString::contains(const QStringRef &s, Qt::CaseSensitivity cs) const
 912 { return QBool(indexOf(s, 0, cs) != -1); }
 913 inline QBool QString::contains(QChar c, Qt::CaseSensitivity cs) const
 914 { return QBool(indexOf(c, 0, cs) != -1); }
 915
 916
 917 inline bool operator==(QString::Null, QString::Null) { return true; }
 918 inline bool operator==(QString::Null, const QString &s) { return s.isNull(); }
 919 inline bool operator==(const QString &s, QString::Null) { return s.isNull(); }
 920 inline bool operator!=(QString::Null, QString::Null) { return false; }
 921 inline bool operator!=(QString::Null, const QString &s) { return !s.isNull(); }
 922 inline bool operator!=(const QString &s, QString::Null) { return !s.isNull(); }
 923
 924 #ifndef QT_NO_CAST_FROM_ASCII
 925 inline bool qStringComparisonHelper(const QString &s1, const char *s2)
 926 {
 927 #  ifndef QT_NO_TEXTCODEC
 928     if (QString::codecForCStrings) return (s1 == QString::fromAscii(s2));
 929 #  endif
 930     return (s1 == QLatin1String(s2));
 931 }
 932 inline bool QString::operator==(const char *s) const
 933 { return qStringComparisonHelper(*this, s); }
 934 inline bool QString::operator!=(const char *s) const
 935 { return !qStringComparisonHelper(*this, s); }
 936 inline bool QString::operator<(const char *s) const
 937 { return *this < QString::fromAscii(s); }
 938 inline bool QString::operator>(const char *s) const
 939 { return *this > QString::fromAscii(s); }
 940 inline bool QString::operator<=(const char *s) const
 941 { return *this <= QString::fromAscii(s); }
 942 inline bool QString::operator>=(const char *s) const
 943 { return *this >= QString::fromAscii(s); }
 944
 945 inline QT_ASCII_CAST_WARN bool operator==(const char *s1, const QString &s2)
 946 { return qStringComparisonHelper(s2, s1); }
 947 inline QT_ASCII_CAST_WARN bool operator!=(const char *s1, const QString &s2)
 948 { return !qStringComparisonHelper(s2, s1); }
 949 inline QT_ASCII_CAST_WARN bool operator<(const char *s1, const QString &s2)
 950 { return (QString::fromAscii(s1) < s2); }
 951 inline QT_ASCII_CAST_WARN bool operator>(const char *s1, const QString &s2)
 952 { return (QString::fromAscii(s1) > s2); }
 953 inline QT_ASCII_CAST_WARN bool operator<=(const char *s1, const QString &s2)
 954 { return (QString::fromAscii(s1) <= s2); }
 955 inline QT_ASCII_CAST_WARN bool operator>=(const char *s1, const QString &s2)
 956 { return (QString::fromAscii(s1) >= s2); }
 957
 958 inline QT_ASCII_CAST_WARN bool operator==(const char *s1, const QLatin1String &s2)
 959 { return QString::fromAscii(s1) == s2; }
 960 inline QT_ASCII_CAST_WARN bool operator!=(const char *s1, const QLatin1String &s2)
 961 { return QString::fromAscii(s1) != s2; }
 962 inline QT_ASCII_CAST_WARN bool operator<(const char *s1, const QLatin1String &s2)
 963 { return (QString::fromAscii(s1) < s2); }
 964 inline QT_ASCII_CAST_WARN bool operator>(const char *s1, const QLatin1String &s2)
 965 { return (QString::fromAscii(s1) > s2); }
 966 inline QT_ASCII_CAST_WARN bool operator<=(const char *s1, const QLatin1String &s2)
 967 { return (QString::fromAscii(s1) <= s2); }
 968 inline QT_ASCII_CAST_WARN bool operator>=(const char *s1, const QLatin1String &s2)
 969 { return (QString::fromAscii(s1) >= s2); }
 970
 971 inline bool operator==(const QLatin1String &s1, const QLatin1String &s2)
 972 { return (qstrcmp(s1.latin1(), s2.latin1()) == 0); }
 973 inline bool operator!=(const QLatin1String &s1, const QLatin1String &s2)
 974 { return (qstrcmp(s1.latin1(), s2.latin1()) != 0); }
 975 inline bool operator<(const QLatin1String &s1, const QLatin1String &s2)
 976 { return (qstrcmp(s1.latin1(), s2.latin1()) < 0); }
 977 inline bool operator<=(const QLatin1String &s1, const QLatin1String &s2)
 978 { return (qstrcmp(s1.latin1(), s2.latin1()) <= 0); }
 979 inline bool operator>(const QLatin1String &s1, const QLatin1String &s2)
 980 { return (qstrcmp(s1.latin1(), s2.latin1()) > 0); }
 981 inline bool operator>=(const QLatin1String &s1, const QLatin1String &s2)
 982 { return (qstrcmp(s1.latin1(), s2.latin1()) >= 0); }
 983
 984
 985 inline bool QString::operator==(const QByteArray &s) const
 986 { return qStringComparisonHelper(*this, s.constData()); }
 987 inline bool QString::operator!=(const QByteArray &s) const
 988 { return !qStringComparisonHelper(*this, s.constData()); }
 989
 990 inline bool QByteArray::operator==(const QString &s) const
 991 { return qStringComparisonHelper(s, constData()); }
 992 inline bool QByteArray::operator!=(const QString &s) const
 993 { return !qStringComparisonHelper(s, constData()); }
 994 inline bool QByteArray::operator<(const QString &s) const
 995 { return QString::fromAscii(constData(), size()) < s; }
 996 inline bool QByteArray::operator>(const QString &s) const
 997 { return QString::fromAscii(constData(), size()) > s; }
 998 inline bool QByteArray::operator<=(const QString &s) const
 999 { return QString::fromAscii(constData(), size()) <= s; }
1000 inline bool QByteArray::operator>=(const QString &s) const
1001 { return QString::fromAscii(constData(), size()) >= s; }
1002 #endif   // QT_NO_CAST_FROM_ASCII
1003
1004 #ifndef QT_NO_CAST_TO_ASCII
1005 inline QByteArray &QByteArray::append(const QString &s)
1006 { return append(s.toAscii()); }
1007 inline QByteArray &QByteArray::insert(int i, const QString &s)
1008 { return insert(i, s.toAscii()); }
1009 inline QByteArray &QByteArray::replace(char c, const QString &after)
1010 { return replace(c, after.toAscii()); }
1011 inline QByteArray &QByteArray::replace(const QString &before, const char *after)
1012 { return replace(before.toAscii(), after); }
1013 inline QByteArray &QByteArray::replace(const QString &before, const QByteArray &after)
1014 { return replace(before.toAscii(), after); }
1015 inline QByteArray &QByteArray::operator+=(const QString &s)
1016 { return operator+=(s.toAscii()); }
1017 inline int QByteArray::indexOf(const QString &s, int from) const
1018 { return indexOf(s.toAscii(), from); }
1019 inline int QByteArray::lastIndexOf(const QString &s, int from) const
1020 { return lastIndexOf(s.toAscii(), from); }
1021 #endif // QT_NO_CAST_TO_ASCII
1022
1023 #if !defined(QT_USE_FAST_OPERATOR_PLUS) && !defined(QT_USE_QSTRINGBUILDER)
1024 inline const QString operator+(const QString &s1, const QString &s2)
1025 { QString t(s1); t += s2; return t; }
1026 inline const QString operator+(const QString &s1, QChar s2)
1027 { QString t(s1); t += s2; return t; }
1028 inline const QString operator+(QChar s1, const QString &s2)
1029 { QString t(s1); t += s2; return t; }
1030 #  ifndef QT_NO_CAST_FROM_ASCII
1031 inline QT_ASCII_CAST_WARN const QString operator+(const QString &s1, const char *s2)
1032 { QString t(s1); t += QString::fromAscii(s2); return t; }
1033 inline QT_ASCII_CAST_WARN const QString operator+(const char *s1, const QString &s2)
1034 { QString t = QString::fromAscii(s1); t += s2; return t; }
1035 inline QT_ASCII_CAST_WARN const QString operator+(char c, const QString &s)
1036 { QString t = s; t.prepend(QChar::fromAscii(c)); return t; }
1037 inline QT_ASCII_CAST_WARN const QString operator+(const QString &s, char c)
1038 { QString t = s; t += QChar::fromAscii(c); return t; }
1039 inline QT_ASCII_CAST_WARN const QString operator+(const QByteArray &ba, const QString &s)
1040 { QString t = QString::fromAscii(ba.constData(), qstrnlen(ba.constData(), ba.size())); t += s; return t; }
1041 inline QT_ASCII_CAST_WARN const QString operator+(const QString &s, const QByteArray &ba)
1042 { QString t(s); t += QString::fromAscii(ba.constData(), qstrnlen(ba.constData(), ba.size())); return t; }
1043 #  endif // QT_NO_CAST_FROM_ASCII
1044 #endif // QT_USE_QSTRINGBUILDER
1045
1046 #ifndef QT_NO_STL
1047 inline std::string QString::toStdString() const
1048 { const QByteArray asc = toAscii(); return std::string(asc.constData(), asc.length()); }
1049
1050 inline QString QString::fromStdString(const std::string &s)
1051 { return fromAscii(s.data(), int(s.size())); }
1052
1053 # ifndef QT_NO_STL_WCHAR
1054 inline QStdWString QString::toStdWString() const
1055 {
1056     QStdWString str;
1057     str.resize(length());
1058
1059 #if defined(_MSC_VER) && _MSC_VER >= 1400
1060     // VS2005 crashes if the string is empty
1061     if (!length())
1062         return str;
1063 #endif
1064
1065     str.resize(toWCharArray(&(*str.begin())));
1066     return str;
1067 }
1068 inline QString QString::fromStdWString(const QStdWString &s)
1069 { return fromWCharArray(s.data(), int(s.size())); }
1070 # endif
1071 #endif
1072
1073 #if !defined(QT_NO_DATASTREAM) || (defined(QT_BOOTSTRAPPED) && !defined(QT_BUILD_QMAKE))
1074 Q_CORE_EXPORT QDataStream &operator<<(QDataStream &, const QString &);
1075 Q_CORE_EXPORT QDataStream &operator>>(QDataStream &, QString &);
1076 #endif
1077
1078 Q_DECLARE_TYPEINFO(QString, Q_MOVABLE_TYPE);
1079 Q_DECLARE_SHARED(QString)
1080 Q_DECLARE_OPERATORS_FOR_FLAGS(QString::SectionFlags)
1081
1082
1083 class Q_CORE_EXPORT QStringRef {
1084     const QString *m_string;
1085     int m_position;
1086     int m_size;
1087 public:
1088     inline QStringRef():m_string(0), m_position(0), m_size(0){}
1089     inline QStringRef(const QString *string, int position, int size);
1090     inline QStringRef(const QString *string);
1091     inline QStringRef(const QStringRef &other)
1092         :m_string(other.m_string), m_position(other.m_position), m_size(other.m_size)
1093         {}
1094
1095     inline ~QStringRef(){}
1096     inline const QString *string() const { return m_string; }
1097     inline int position() const { return m_position; }
1098     inline int size() const { return m_size; }
1099     inline int count() const { return m_size; }
1100     inline int length() const { return m_size; }
1101
1102     inline QStringRef &operator=(const QStringRef &other) {
1103         m_string = other.m_string; m_position = other.m_position;
1104         m_size = other.m_size; return *this;
1105     }
1106
1107     int indexOf(const QString &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1108     int indexOf(QChar ch, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1109     int indexOf(QLatin1String str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1110     int indexOf(const QStringRef &str, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1111     int lastIndexOf(const QString &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1112     int lastIndexOf(QChar ch, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1113     int lastIndexOf(QLatin1String str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1114     int lastIndexOf(const QStringRef &str, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1115
1116     inline QBool contains(const QString &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1117     inline QBool contains(QChar ch, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1118     inline QBool contains(QLatin1String str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1119     inline QBool contains(const QStringRef &str, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1120
1121     int count(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1122     int count(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1123     int count(const QStringRef &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1124
1125     bool startsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1126     bool startsWith(QLatin1String s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1127     bool startsWith(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1128     bool startsWith(const QStringRef &c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1129
1130     bool endsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1131     bool endsWith(QLatin1String s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1132     bool endsWith(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1133     bool endsWith(const QStringRef &c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1134
1135     inline QStringRef &operator=(const QString *string);
1136
1137     inline const QChar *unicode() const {
1138         if (!m_string)
1139             return reinterpret_cast<const QChar *>(QString::shared_null.str.data());
1140         return m_string->unicode() + m_position;
1141     }
1142     inline const QChar *data() const { return unicode(); }
1143     inline const QChar *constData() const {  return unicode(); }
1144
1145     QByteArray toAscii() const Q_REQUIRED_RESULT;
1146     QByteArray toLatin1() const Q_REQUIRED_RESULT;
1147     QByteArray toUtf8() const Q_REQUIRED_RESULT;
1148     QByteArray toLocal8Bit() const Q_REQUIRED_RESULT;
1149     QVector<uint> toUcs4() const Q_REQUIRED_RESULT;
1150
1151     inline void clear() { m_string = 0; m_position = m_size = 0; }
1152     QString toString() const;
1153     inline bool isEmpty() const { return m_size == 0; }
1154     inline bool isNull() const { return m_string == 0 || m_string->isNull(); }
1155
1156     QStringRef appendTo(QString *string) const;
1157
1158     inline const QChar at(int i) const
1159         { Q_ASSERT(i >= 0 && i < size()); return m_string->at(i + m_position); }
1160
1161     int compare(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1162     int compare(const QStringRef &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1163     int compare(QLatin1String s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
1164     static int compare(const QStringRef &s1, const QString &s2,
1165                        Qt::CaseSensitivity = Qt::CaseSensitive);
1166     static int compare(const QStringRef &s1, const QStringRef &s2,
1167                        Qt::CaseSensitivity = Qt::CaseSensitive);
1168     static int compare(const QStringRef &s1, QLatin1String s2,
1169                        Qt::CaseSensitivity cs = Qt::CaseSensitive);
1170
1171     int localeAwareCompare(const QString &s) const;
1172     int localeAwareCompare(const QStringRef &s) const;
1173     static int localeAwareCompare(const QStringRef &s1, const QString &s2);
1174     static int localeAwareCompare(const QStringRef &s1, const QStringRef &s2);
1175 };
1176
1177 inline QStringRef &QStringRef::operator=(const QString *aString)
1178 { m_string = aString; m_position = 0; m_size = aString?aString->size():0; return *this; }
1179
1180 inline QStringRef::QStringRef(const QString *aString, int aPosition, int aSize)
1181         :m_string(aString), m_position(aPosition), m_size(aSize){}
1182
1183 inline QStringRef::QStringRef(const QString *aString)
1184     :m_string(aString), m_position(0), m_size(aString?aString->size() : 0){}
1185
1186 Q_CORE_EXPORT bool operator==(const QStringRef &s1,const QStringRef &s2);
1187 inline bool operator!=(const QStringRef &s1,const QStringRef &s2)
1188 { return !(s1 == s2); }
1189 Q_CORE_EXPORT bool operator==(const QString &s1,const QStringRef &s2);
1190 inline bool operator!=(const QString &s1,const QStringRef &s2)
1191 { return !(s1 == s2); }
1192 inline bool operator==(const QStringRef &s1,const QString &s2)
1193 { return s2 == s1; }
1194 inline bool operator!=(const QStringRef &s1,const QString &s2)
1195 { return s2 != s1; }
1196 Q_CORE_EXPORT bool operator==(const QLatin1String &s1, const QStringRef &s2);
1197 inline bool operator!=(const QLatin1String &s1,const QStringRef &s2)
1198 { return !(s1 == s2); }
1199 inline bool operator==(const QStringRef &s1,const QLatin1String &s2)
1200 { return s2 == s1; }
1201 inline bool operator!=(const QStringRef &s1,const QLatin1String &s2)
1202 { return s2 != s1; }
1203
1204 Q_CORE_EXPORT bool operator<(const QStringRef &s1,const QStringRef &s2);
1205 inline bool operator>(const QStringRef &s1, const QStringRef &s2)
1206 { return s2 < s1; }
1207 inline bool operator<=(const QStringRef &s1, const QStringRef &s2)
1208 { return !(s1 > s2); }
1209 inline bool operator>=(const QStringRef &s1, const QStringRef &s2)
1210 { return !(s1 < s2); }
1211
1212 inline bool qStringComparisonHelper(const QStringRef &s1, const char *s2)
1213 {
1214 #  ifndef QT_NO_TEXTCODEC
1215     if (QString::codecForCStrings) return (s1 == QString::fromAscii(s2));
1216 #  endif
1217     return (s1 == QLatin1String(s2));
1218 }
1219
1220 inline QT_ASCII_CAST_WARN bool operator==(const char *s1, const QStringRef &s2)
1221 { return qStringComparisonHelper(s2, s1); }
1222 inline QT_ASCII_CAST_WARN bool operator==(const QStringRef &s1, const char *s2)
1223 { return qStringComparisonHelper(s1, s2); }
1224 inline QT_ASCII_CAST_WARN bool operator!=(const char *s1, const QStringRef &s2)
1225 { return !qStringComparisonHelper(s2, s1); }
1226 inline QT_ASCII_CAST_WARN bool operator!=(const QStringRef &s1, const char *s2)
1227 { return !qStringComparisonHelper(s1, s2); }
1228
1229 inline int QString::compare(const QStringRef &s, Qt::CaseSensitivity cs) const
1230 { return QString::compare_helper(constData(), length(), s.constData(), s.length(), cs); }
1231 inline int QString::compare(const QString &s1, const QStringRef &s2, Qt::CaseSensitivity cs)
1232 { return QString::compare_helper(s1.constData(), s1.length(), s2.constData(), s2.length(), cs); }
1233 inline int QStringRef::compare(const QString &s, Qt::CaseSensitivity cs) const
1234 { return QString::compare_helper(constData(), length(), s.constData(), s.length(), cs); }
1235 inline int QStringRef::compare(const QStringRef &s, Qt::CaseSensitivity cs) const
1236 { return QString::compare_helper(constData(), length(), s.constData(), s.length(), cs); }
1237 inline int QStringRef::compare(QLatin1String s, Qt::CaseSensitivity cs) const
1238 { return QString::compare_helper(constData(), length(), s, cs); }
1239 inline int QStringRef::compare(const QStringRef &s1, const QString &s2, Qt::CaseSensitivity cs)
1240 { return QString::compare_helper(s1.constData(), s1.length(), s2.constData(), s2.length(), cs); }
1241 inline int QStringRef::compare(const QStringRef &s1, const QStringRef &s2, Qt::CaseSensitivity cs)
1242 { return QString::compare_helper(s1.constData(), s1.length(), s2.constData(), s2.length(), cs); }
1243 inline int QStringRef::compare(const QStringRef &s1, QLatin1String s2, Qt::CaseSensitivity cs)
1244 { return QString::compare_helper(s1.constData(), s1.length(), s2, cs); }
1245
1246 inline int QString::localeAwareCompare(const QStringRef &s) const
1247 { return localeAwareCompare_helper(constData(), length(), s.constData(), s.length()); }
1248 inline int QString::localeAwareCompare(const QString& s1, const QStringRef& s2)
1249 { return localeAwareCompare_helper(s1.constData(), s1.length(), s2.constData(), s2.length()); }
1250 inline int QStringRef::localeAwareCompare(const QString &s) const
1251 { return QString::localeAwareCompare_helper(constData(), length(), s.constData(), s.length()); }
1252 inline int QStringRef::localeAwareCompare(const QStringRef &s) const
1253 { return QString::localeAwareCompare_helper(constData(), length(), s.constData(), s.length()); }
1254 inline int QStringRef::localeAwareCompare(const QStringRef &s1, const QString &s2)
1255 { return QString::localeAwareCompare_helper(s1.constData(), s1.length(), s2.constData(), s2.length()); }
1256 inline int QStringRef::localeAwareCompare(const QStringRef &s1, const QStringRef &s2)
1257 { return QString::localeAwareCompare_helper(s1.constData(), s1.length(), s2.constData(), s2.length()); }
1258
1259 inline QBool QStringRef::contains(const QString &s, Qt::CaseSensitivity cs) const
1260 { return QBool(indexOf(s, 0, cs) != -1); }
1261 inline QBool QStringRef::contains(QLatin1String s, Qt::CaseSensitivity cs) const
1262 { return QBool(indexOf(s, 0, cs) != -1); }
1263 inline QBool QStringRef::contains(QChar c, Qt::CaseSensitivity cs) const
1264 { return QBool(indexOf(c, 0, cs) != -1); }
1265 inline QBool QStringRef::contains(const QStringRef &s, Qt::CaseSensitivity cs) const
1266 { return QBool(indexOf(s, 0, cs) != -1); }
1267
1268 namespace Qt {
1269 #if QT_DEPRECATED_SINCE(5, 0)
1270 QT_DEPRECATED inline QString escape(const QString &plain) {
1271     return plain.toHtmlEscaped();
1272 }
1273 #endif
1274 }
1275
1276 QT_END_NAMESPACE
1277
1278 QT_END_HEADER
1279
1280 #if defined(QT_USE_FAST_OPERATOR_PLUS) || defined(QT_USE_QSTRINGBUILDER)
1281 #include <QtCore/qstringbuilder.h>
1282 #endif
1283
1284 #endif // QSTRING_H