开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 系统编程 > 查看源码
qstring.h
资源名称：rootfs-7-9.tar.gz　[点击查看]
上传用户：detong
上传日期：2022-06-22
资源大小：20675k
文件大小：52k
源码类别：

系统编程

开发平台：

Unix_Linux

qstring.h：源码内容
  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtCore module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  38. #ifndef QSTRING_H
  39. #define QSTRING_H
  41. #include <QtCore/qchar.h>
  42. #include <QtCore/qbytearray.h>
  43. #include <QtCore/qatomic.h>
  44. #include <QtCore/qnamespace.h>
  45. #ifdef QT_INCLUDE_COMPAT
  46. #include <Qt3Support/q3cstring.h>
  47. #endif
  49. #ifndef QT_NO_STL
  50. #  if defined (Q_CC_MSVC_NET) && _MSC_VER < 1310 // Avoids nasty warning for xlocale, line 450
  51. #    pragma warning (push)
  52. #    pragma warning (disable : 4189)
  53. #    include <string>
  54. #    pragma warning (pop)
  55. #  else
  56. #    include <string>
  57. #  endif
  59. #  ifndef QT_NO_STL_WCHAR
  60. // workaround for some headers not typedef'ing std::wstring
  61. typedef std::basic_string<wchar_t> QStdWString;
  62. #  endif // QT_NO_STL_WCHAR
  64. #endif // QT_NO_STL
  66. #include <stdarg.h>
  68. #ifdef truncate
  69. #error qstring.h must be included before any header file that defines truncate
  70. #endif
  72. QT_BEGIN_HEADER
  74. QT_BEGIN_NAMESPACE
  76. QT_MODULE(Core)
  78. class QCharRef;
  79. class QRegExp;
  80. class QStringList;
  81. class QTextCodec;
  82. class QLatin1String;
  83. class QStringRef;
  84. template <typename T> class QVector;
  86. class Q_CORE_EXPORT QString
  87. {
  88. public:
  89.     inline QString();
  90.     QString(const QChar *unicode, int size);
  91.     QString(QChar c);
  92.     QString(int size, QChar c);
  93.     inline QString(const QLatin1String &latin1);
  94.     inline QString(const QString &);
  95.     inline ~QString();
  96.     QString &operator=(QChar c);
  97.     QString &operator=(const QString &);
  98.     inline QString &operator=(const QLatin1String &);
  100.     inline int size() const { return d->size; }
  101.     inline int count() const { return d->size; }
  102.     inline int length() const;
  103.     inline bool isEmpty() const;
  104.     void resize(int size);
  106.     QString &fill(QChar c, int size = -1);
  107.     void truncate(int pos);
  108.     void chop(int n);
  110.     int capacity() const;
  111.     inline void reserve(int size);
  112.     inline void squeeze() { if (d->size < d->alloc) realloc(); d->capacity = 0;}
  114.     inline const QChar *unicode() const;
  115.     inline QChar *data();
  116.     inline const QChar *data() const;
  117.     inline const QChar *constData() const;
  119.     inline void detach();
  120.     inline bool isDetached() const;
  121.     void clear();
  123.     inline const QChar at(int i) const;
  124.     const QChar operator[](int i) const;
  125.     QCharRef operator[](int i);
  126.     const QChar operator[](uint i) const;
  127.     QCharRef operator[](uint i);
  129.     QString arg(qlonglong a, int fieldwidth=0, int base=10,
  130.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  131.     QString arg(qulonglong a, int fieldwidth=0, int base=10,
  132.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  133.     QString arg(long a, int fieldwidth=0, int base=10,
  134.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  135.     QString arg(ulong a, int fieldwidth=0, int base=10,
  136.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  137.     QString arg(int a, int fieldWidth = 0, int base = 10,
  138.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  139.     QString arg(uint a, int fieldWidth = 0, int base = 10,
  140.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  141.     QString arg(short a, int fieldWidth = 0, int base = 10,
  142.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  143.     QString arg(ushort a, int fieldWidth = 0, int base = 10,
  144.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  145.     QString arg(double a, int fieldWidth = 0, char fmt = 'g', int prec = -1,
  146.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  147.     QString arg(char a, int fieldWidth = 0,
  148.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  149.     QString arg(QChar a, int fieldWidth = 0,
  150.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  151.     QString arg(const QString &a, int fieldWidth = 0,
  152.                 const QChar &fillChar = QLatin1Char(' ')) const Q_REQUIRED_RESULT;
  153.     QString arg(const QString &a1, const QString &a2) const Q_REQUIRED_RESULT;
  154.     QString arg(const QString &a1, const QString &a2, const QString &a3) const Q_REQUIRED_RESULT;
  155.     QString arg(const QString &a1, const QString &a2, const QString &a3,
  156.                 const QString &a4) const Q_REQUIRED_RESULT;
  157.     QString arg(const QString &a1, const QString &a2, const QString &a3,
  158.                 const QString &a4, const QString &a5) const Q_REQUIRED_RESULT;
  159.     QString arg(const QString &a1, const QString &a2, const QString &a3,
  160.                 const QString &a4, const QString &a5, const QString &a6) const Q_REQUIRED_RESULT;
  161.     QString arg(const QString &a1, const QString &a2, const QString &a3,
  162.                 const QString &a4, const QString &a5, const QString &a6,
  163.                 const QString &a7) const Q_REQUIRED_RESULT;
  164.     QString arg(const QString &a1, const QString &a2, const QString &a3,
  165.                 const QString &a4, const QString &a5, const QString &a6,
  166.                 const QString &a7, const QString &a8) const Q_REQUIRED_RESULT;
  167.     QString arg(const QString &a1, const QString &a2, const QString &a3,
  168.                 const QString &a4, const QString &a5, const QString &a6,
  169.                 const QString &a7, const QString &a8, const QString &a9) const Q_REQUIRED_RESULT;
  171.     QString    &vsprintf(const char *format, va_list ap);
  172.     QString    &sprintf(const char *format, ...)
  173. #if defined(Q_CC_GNU) && !defined(__INSURE__)
  174.         __attribute__ ((format (printf, 2, 3)))
  175. #endif
  176.         ;
  178.     int indexOf(QChar c, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  179.     int indexOf(const QString &s, int from = 0, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  180.     int lastIndexOf(QChar c, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  181.     int lastIndexOf(const QString &s, int from = -1, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  183.     inline QBool contains(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  184.     inline QBool contains(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  185.     int count(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  186.     int count(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  188. #ifndef QT_NO_REGEXP
  189.     int indexOf(const QRegExp &, int from = 0) const;
  190.     int lastIndexOf(const QRegExp &, int from = -1) const;
  191.     inline QBool contains(const QRegExp &rx) const { return QBool(indexOf(rx) != -1); }
  192.     int count(const QRegExp &) const;
  193. #endif
  195.     enum SectionFlag {
  196.         SectionDefault             = 0x00,
  197.         SectionSkipEmpty           = 0x01,
  198.         SectionIncludeLeadingSep   = 0x02,
  199.         SectionIncludeTrailingSep  = 0x04,
  200.         SectionCaseInsensitiveSeps = 0x08
  201.     };
  202.     Q_DECLARE_FLAGS(SectionFlags, SectionFlag)
  204.     QString section(QChar sep, int start, int end = -1, SectionFlags flags = SectionDefault) const;
  205.     QString section(const QString &in_sep, int start, int end = -1, SectionFlags flags = SectionDefault) const;
  206. #ifndef QT_NO_REGEXP
  207.     QString section(const QRegExp &reg, int start, int end = -1, SectionFlags flags = SectionDefault) const;
  208. #endif
  210.     QString left(int n) const Q_REQUIRED_RESULT;
  211.     QString right(int n) const Q_REQUIRED_RESULT;
  212.     QString mid(int position, int n = -1) const Q_REQUIRED_RESULT;
  213.     QStringRef leftRef(int n) const Q_REQUIRED_RESULT;
  214.     QStringRef rightRef(int n) const Q_REQUIRED_RESULT;
  215.     QStringRef midRef(int position, int n = -1) const Q_REQUIRED_RESULT;
  217.     bool startsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  218.     bool startsWith(const QLatin1String &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  219.     bool startsWith(const QChar &c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  220.     bool endsWith(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  221.     bool endsWith(const QLatin1String &s, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  222.     bool endsWith(const QChar &c, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  224.     QString leftJustified(int width, QChar fill = QLatin1Char(' '), bool trunc = false) const Q_REQUIRED_RESULT;
  225.     QString rightJustified(int width, QChar fill = QLatin1Char(' '), bool trunc = false) const Q_REQUIRED_RESULT;
  227.     QString toLower() const Q_REQUIRED_RESULT;
  228.     QString toUpper() const Q_REQUIRED_RESULT;
  229.     QString toCaseFolded() const Q_REQUIRED_RESULT;
  231.     QString trimmed() const Q_REQUIRED_RESULT;
  232.     QString simplified() const Q_REQUIRED_RESULT;
  234.     QString &insert(int i, QChar c);
  235.     QString &insert(int i, const QChar *uc, int len);
  236.     inline QString &insert(int i, const QString &s) { return insert(i, s.constData(), s.length()); }
  237.     QString &insert(int i, const QLatin1String &s);
  238.     QString &append(QChar c);
  239.     QString &append(const QString &s);
  240.     QString &append(const QStringRef &s);
  241.     QString &append(const QLatin1String &s);
  242.     inline QString &prepend(QChar c) { return insert(0, c); }
  243.     inline QString &prepend(const QString &s) { return insert(0, s); }
  244.     inline QString &prepend(const QLatin1String &s) { return insert(0, s); }
  246.     inline QString &operator+=(QChar c) {
  247.         if (d->ref != 1 || d->size + 1 > d->alloc)
  248.             realloc(grow(d->size + 1));
  249.         d->data[d->size++] = c.unicode();
  250.         d->data[d->size] = '';
  251.         return *this;
  252.     }
  254.     inline QString &operator+=(QChar::SpecialCharacter c) { return append(QChar(c)); }
  255.     inline QString &operator+=(const QString &s) { return append(s); }
  256.     inline QString &operator+=(const QStringRef &s) { return append(s); }
  257.     inline QString &operator+=(const QLatin1String &s) { return append(s); }
  259.     QString &remove(int i, int len);
  260.     QString &remove(QChar c, Qt::CaseSensitivity cs = Qt::CaseSensitive);
  261.     QString &remove(const QString &s, Qt::CaseSensitivity cs = Qt::CaseSensitive);
  262.     QString &replace(int i, int len, QChar after);
  263.     QString &replace(int i, int len, const QChar *s, int slen);
  264.     QString &replace(int i, int len, const QString &after);
  265.     QString &replace(QChar before, QChar after, Qt::CaseSensitivity cs = Qt::CaseSensitive);
  266.     QString &replace(QChar c, const QString &after, Qt::CaseSensitivity cs = Qt::CaseSensitive);
  267.     QString &replace(const QString &before, const QString &after,
  268.                      Qt::CaseSensitivity cs = Qt::CaseSensitive);
  269. #ifndef QT_NO_REGEXP
  270.     QString &replace(const QRegExp &rx, const QString &after);
  271.     inline QString &remove(const QRegExp &rx)
  272.     { return replace(rx, QString()); }
  273. #endif
  275.     enum SplitBehavior { KeepEmptyParts, SkipEmptyParts };
  277.     QStringList split(const QString &sep, SplitBehavior behavior = KeepEmptyParts,
  278.                       Qt::CaseSensitivity cs = Qt::CaseSensitive) const Q_REQUIRED_RESULT;
  279.     QStringList split(const QChar &sep, SplitBehavior behavior = KeepEmptyParts,
  280.                       Qt::CaseSensitivity cs = Qt::CaseSensitive) const Q_REQUIRED_RESULT;
  281. #ifndef QT_NO_REGEXP
  282.     QStringList split(const QRegExp &sep, SplitBehavior behavior = KeepEmptyParts) const Q_REQUIRED_RESULT;
  283. #endif
  285.     enum NormalizationForm {
  286.         NormalizationForm_D,
  287.         NormalizationForm_C,
  288.         NormalizationForm_KD,
  289.         NormalizationForm_KC
  290.     };
  291.     QString normalized(NormalizationForm mode) const Q_REQUIRED_RESULT;
  292.     QString normalized(NormalizationForm mode, QChar::UnicodeVersion version) const Q_REQUIRED_RESULT;
  294.     const ushort *utf16() const;
  296.     QByteArray toAscii() const Q_REQUIRED_RESULT;
  297.     QByteArray toLatin1() const Q_REQUIRED_RESULT;
  298.     QByteArray toUtf8() const Q_REQUIRED_RESULT;
  299.     QByteArray toLocal8Bit() const Q_REQUIRED_RESULT;
  300.     QVector<uint> toUcs4() const Q_REQUIRED_RESULT;
  302.     static QString fromAscii(const char *, int size = -1);
  303.     static QString fromLatin1(const char *, int size = -1);
  304.     static QString fromUtf8(const char *, int size = -1);
  305.     static QString fromLocal8Bit(const char *, int size = -1);
  306.     static QString fromUtf16(const ushort *, int size = -1);
  307.     static QString fromUcs4(const uint *, int size = -1);
  308.     static QString fromRawData(const QChar *, int size);
  310.     int toWCharArray(wchar_t *array) const;
  311.     static QString fromWCharArray(const wchar_t *, int size = -1);
  313.     QString &setUnicode(const QChar *unicode, int size);
  314.     inline QString &setUtf16(const ushort *utf16, int size);
  316.     // ### Qt 5: merge these two functions
  317.     int compare(const QString &s) const;
  318.     int compare(const QString &s, Qt::CaseSensitivity cs) const;
  320.     int compare(const QLatin1String &other, Qt::CaseSensitivity cs = Qt::CaseSensitive) const;
  322.     // ### Qt 5: merge these two functions
  323.     static inline int compare(const QString &s1, const QString &s2)
  324.     { return s1.compare(s2); }
  325.     static inline int compare(const QString &s1, const QString &s2, Qt::CaseSensitivity cs)
  326.     { return s1.compare(s2, cs); }
  328.     static inline int compare(const QString& s1, const QLatin1String &s2,
  329.                               Qt::CaseSensitivity cs = Qt::CaseSensitive)
  330.     { return s1.compare(s2, cs); }
  331.     static inline int compare(const QLatin1String& s1, const QString &s2,
  332.                               Qt::CaseSensitivity cs = Qt::CaseSensitive)
  333.     { return -s2.compare(s1, cs); }
  335.     int localeAwareCompare(const QString& s) const;
  336.     static int localeAwareCompare(const QString& s1, const QString& s2)
  337.     { return s1.localeAwareCompare(s2); }
  339.     short  toShort(bool *ok=0, int base=10) const;
  340.     ushort toUShort(bool *ok=0, int base=10) const;
  341.     int toInt(bool *ok=0, int base=10) const;
  342.     uint toUInt(bool *ok=0, int base=10) const;
  343.     long toLong(bool *ok=0, int base=10) const;
  344.     ulong toULong(bool *ok=0, int base=10) const;
  345.     qlonglong toLongLong(bool *ok=0, int base=10) const;
  346.     qulonglong toULongLong(bool *ok=0, int base=10) const;
  347.     float toFloat(bool *ok=0) const;
  348.     double toDouble(bool *ok=0) const;
  350.     QString &setNum(short, int base=10);
  351.     QString &setNum(ushort, int base=10);
  352.     QString &setNum(int, int base=10);
  353.     QString &setNum(uint, int base=10);
  354.     QString &setNum(long, int base=10);
  355.     QString &setNum(ulong, int base=10);
  356.     QString &setNum(qlonglong, int base=10);
  357.     QString &setNum(qulonglong, int base=10);
  358.     QString &setNum(float, char f='g', int prec=6);
  359.     QString &setNum(double, char f='g', int prec=6);
  361.     static QString number(int, int base=10);
  362.     static QString number(uint, int base=10);
  363.     static QString number(long, int base=10);
  364.     static QString number(ulong, int base=10);
  365.     static QString number(qlonglong, int base=10);
  366.     static QString number(qulonglong, int base=10);
  367.     static QString number(double, char f='g', int prec=6);
  369.     bool operator==(const QString &s) const;
  370.     bool operator<(const QString &s) const;
  371.     inline bool operator>(const QString &s) const { return s < *this; }
  372.     inline bool operator!=(const QString &s) const { return !operator==(s); }
  373.     inline bool operator<=(const QString &s) const { return !operator>(s); }
  374.     inline bool operator>=(const QString &s) const { return !operator<(s); }
  376.     bool operator==(const QLatin1String &s) const;
  377.     bool operator<(const QLatin1String &s) const;
  378.     bool operator>(const QLatin1String &s) const;
  379.     inline bool operator!=(const QLatin1String &s) const { return !operator==(s); }
  380.     inline bool operator<=(const QLatin1String &s) const { return !operator>(s); }
  381.     inline bool operator>=(const QLatin1String &s) const { return !operator<(s); }
  383.     // ASCII compatibility
  384. #ifndef QT_NO_CAST_FROM_ASCII
  385.     inline QT_ASCII_CAST_WARN_CONSTRUCTOR QString(const char *ch) : d(fromAscii_helper(ch))
  386.     {}
  387.     inline QT_ASCII_CAST_WARN_CONSTRUCTOR QString(const QByteArray &a)
  388.         : d(fromAscii_helper(a.constData(), qstrnlen(a.constData(), a.size())))
  389.     {}
  390.     inline QT_ASCII_CAST_WARN QString &operator=(const char *ch)
  391.     { return (*this = fromAscii(ch)); }
  392.     inline QT_ASCII_CAST_WARN QString &operator=(const QByteArray &a)
  393.     { return (*this = fromAscii(a.constData(), qstrnlen(a.constData(), a.size()))); }
  394.     inline QT_ASCII_CAST_WARN QString &operator=(char c)
  395.     { return (*this = QChar::fromAscii(c)); }
  397.     // these are needed, so it compiles with STL support enabled
  398.     inline QT_ASCII_CAST_WARN QString &prepend(const char *s)
  399.     { return prepend(QString::fromAscii(s)); }
  400.     inline QT_ASCII_CAST_WARN QString &prepend(const QByteArray &s)
  401.     { return prepend(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }
  402.     inline QT_ASCII_CAST_WARN QString &append(const char *s)
  403.     { return append(QString::fromAscii(s)); }
  404.     inline QT_ASCII_CAST_WARN QString &append(const QByteArray &s)
  405.     { return append(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }
  406.     inline QT_ASCII_CAST_WARN QString &operator+=(const char *s)
  407.     { return append(QString::fromAscii(s)); }
  408.     inline QT_ASCII_CAST_WARN QString &operator+=(const QByteArray &s)
  409.     { return append(QString::fromAscii(s.constData(), qstrnlen(s.constData(), s.size()))); }
  410.     inline QT_ASCII_CAST_WARN QString &operator+=(char c)
  411.     { return append(QChar::fromAscii(c)); }
  413.     inline QT_ASCII_CAST_WARN bool operator==(const char *s) const;
  414.     inline QT_ASCII_CAST_WARN bool operator!=(const char *s) const;
  415.     inline QT_ASCII_CAST_WARN bool operator<(const char *s) const;
  416.     inline QT_ASCII_CAST_WARN bool operator<=(const char *s2) const;
  417.     inline QT_ASCII_CAST_WARN bool operator>(const char *s2) const;
  418.     inline QT_ASCII_CAST_WARN bool operator>=(const char *s2) const;
  420.     inline QT_ASCII_CAST_WARN bool operator==(const QByteArray &s) const;
  421.     inline QT_ASCII_CAST_WARN bool operator!=(const QByteArray &s) const;
  422.     inline QT_ASCII_CAST_WARN bool operator<(const QByteArray &s) const
  423.     { return *this < QString::fromAscii(s.constData(), s.size()); }
  424.     inline QT_ASCII_CAST_WARN bool operator>(const QByteArray &s) const
  425.     { return *this > QString::fromAscii(s.constData(), s.size()); }
  426.     inline QT_ASCII_CAST_WARN bool operator<=(const QByteArray &s) const
  427.     { return *this <= QString::fromAscii(s.constData(), s.size()); }
  428.     inline QT_ASCII_CAST_WARN bool operator>=(const QByteArray &s) const
  429.     { return *this >= QString::fromAscii(s.constData(), s.size()); }
  430. #endif
  432.     typedef QChar *iterator;
  433.     typedef const QChar *const_iterator;
  434.     typedef iterator Iterator;
  435.     typedef const_iterator ConstIterator;
  436.     iterator begin();
  437.     const_iterator begin() const;
  438.     const_iterator constBegin() const;
  439.     iterator end();
  440.     const_iterator end() const;
  441.     const_iterator constEnd() const;
  443.     // STL compatibility
  444.     inline void push_back(QChar c) { append(c); }
  445.     inline void push_back(const QString &s) { append(s); }
  446.     inline void push_front(QChar c) { prepend(c); }
  447.     inline void push_front(const QString &s) { prepend(s); }
  449. #ifndef QT_NO_STL
  450.     static inline QString fromStdString(const std::string &s);
  451.     inline std::string toStdString() const;
  452. # ifdef qdoc
  453.     static inline QString fromStdWString(const std::wstring &s);
  454.     inline std::wstring toStdWString() const;
  455. # else
  456. #  ifndef QT_NO_STL_WCHAR
  457.     static inline QString fromStdWString(const QStdWString &s);
  458.     inline QStdWString toStdWString() const;
  459. #  endif // QT_NO_STL_WCHAR
  460. # endif // qdoc
  461. #endif
  463.     // compatibility
  464.     struct Null { };
  465.     static const Null null;
  466.     inline QString(const Null &): d(&shared_null) { d->ref.ref(); }
  467.     inline QString &operator=(const Null &) { *this = QString(); return *this; }
  468.     inline bool isNull() const { return d == &shared_null; }
  470. #ifdef QT3_SUPPORT
  471.     inline QT3_SUPPORT const char *ascii() const { return ascii_helper(); }
  472.     inline QT3_SUPPORT const char *latin1() const { return latin1_helper(); }
  473.     inline QT3_SUPPORT QByteArray utf8() const { return toUtf8(); }
  474.     inline QT3_SUPPORT QByteArray local8Bit() const{ return toLocal8Bit(); }
  475.     inline QT3_SUPPORT void setLength(int nl) { resize(nl); }
  476.     inline QT3_SUPPORT QString copy() const { return *this; }
  477.     inline QT3_SUPPORT QString &remove(QChar c, bool cs)
  478.     { return remove(c, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  479.     inline QT3_SUPPORT QString &remove(const QString  &s, bool cs)
  480.     { return remove(s, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  481.     inline QT3_SUPPORT QString &replace(QChar c, const QString  &after, bool cs)
  482.     { return replace(c, after, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  483.     inline QT3_SUPPORT QString &replace(const QString &before, const QString &after, bool cs)
  484.     { return replace(before, after, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  485. #ifndef QT_NO_CAST_FROM_ASCII
  486.     inline QT3_SUPPORT QString &replace(char c, const QString &after, bool cs)
  487.     { return replace(QChar::fromAscii(c), after, cs ? Qt::CaseSensitive : Qt::CaseInsensitive); }
  488.     // strange overload, required to avoid GCC 3.3 error
  489.     inline QT3_SUPPORT QString &replace(char c, const QString &after, Qt::CaseSensitivity cs)
  490.     { return replace(QChar::fromAscii(c), after, cs ? Qt::CaseSensitive : Qt::CaseInsensitive); }
  491. #endif
  492.     inline QT3_SUPPORT int find(QChar c, int i = 0, bool cs = true) const
  493.     { return indexOf(c, i, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  494.     inline QT3_SUPPORT int find(const QString &s, int i = 0, bool cs = true) const
  495.     { return indexOf(s, i, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  496.     inline QT3_SUPPORT int findRev(QChar c, int i = -1, bool cs = true) const
  497.     { return lastIndexOf(c, i, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  498.     inline QT3_SUPPORT int findRev(const QString &s, int i = -1, bool cs = true) const
  499.     { return lastIndexOf(s, i, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  500. #ifndef QT_NO_REGEXP
  501.     inline QT3_SUPPORT int find(const QRegExp &rx, int i=0) const
  502.     { return indexOf(rx, i); }
  503.     inline QT3_SUPPORT int findRev(const QRegExp &rx, int i=-1) const
  504.     { return lastIndexOf(rx, i); }
  505. #endif
  506.     inline QT3_SUPPORT QBool contains(QChar c, bool cs) const
  507.     { return contains(c, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  508.     inline QT3_SUPPORT QBool contains(const QString &s, bool cs) const
  509.     { return contains(s, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  510.     inline QT3_SUPPORT bool startsWith(const QString &s, bool cs) const
  511.     { return startsWith(s, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  512.     inline QT3_SUPPORT bool endsWith(const QString &s, bool cs) const
  513.     { return endsWith(s, cs?Qt::CaseSensitive:Qt::CaseInsensitive); }
  514.     inline QT3_SUPPORT QChar constref(uint i) const
  515.     { return at(i); }
  516.     QT3_SUPPORT QChar &ref(uint i);
  517.     inline QT3_SUPPORT QString leftJustify(int width, QChar aFill = QLatin1Char(' '), bool trunc=false) const
  518.     { return leftJustified(width, aFill, trunc); }
  519.     inline QT3_SUPPORT QString rightJustify(int width, QChar aFill = QLatin1Char(' '), bool trunc=false) const
  520.     { return rightJustified(width, aFill, trunc); }
  521.     inline QT3_SUPPORT QString lower() const { return toLower(); }
  522.     inline QT3_SUPPORT QString upper() const { return toUpper(); }
  523.     inline QT3_SUPPORT QString stripWhiteSpace() const { return trimmed(); }
  524.     inline QT3_SUPPORT QString simplifyWhiteSpace() const { return simplified(); }
  525.     inline QT3_SUPPORT QString &setUnicodeCodes(const ushort *unicode_as_ushorts, int aSize)
  526.     { return setUtf16(unicode_as_ushorts, aSize); }
  527.     inline QT3_SUPPORT const ushort *ucs2() const { return utf16(); }
  528.     inline static QT3_SUPPORT QString fromUcs2(const ushort *unicode, int size = -1)
  529.     { return fromUtf16(unicode, size); }
  530.     inline QT3_SUPPORT QString &setAscii(const char *str, int len = -1)
  531.     { *this = fromAscii(str, len); return *this; }
  532.     inline QT3_SUPPORT QString &setLatin1(const char *str, int len = -1)
  533.     { *this = fromLatin1(str, len); return *this; }
  534. protected:
  535.     friend class QObject;
  536.     const char *ascii_helper() const;
  537.     const char *latin1_helper() const;
  538. public:
  539. #ifndef QT_NO_CAST_TO_ASCII
  540.     inline QT3_SUPPORT operator const char *() const { return ascii_helper(); }
  541. private:
  542.     QT3_SUPPORT operator QNoImplicitBoolCast() const;
  543. public:
  544. #endif
  545. #endif
  547.     bool isSimpleText() const { if (!d->clean) updateProperties(); return d->simpletext; }
  548.     bool isRightToLeft() const { if (!d->clean) updateProperties(); return d->righttoleft; }
  550. private:
  551. #if defined(QT_NO_CAST_FROM_ASCII) && !defined(Q_NO_DECLARED_NOT_DEFINED)
  552.     QString &operator+=(const char *s);
  553.     QString &operator+=(const QByteArray &s);
  554.     QString(const char *ch);
  555.     QString(const QByteArray &a);
  556.     QString &operator=(const char  *ch);
  557.     QString &operator=(const QByteArray &a);
  558. #endif
  560.     struct Data {
  561.         QBasicAtomicInt ref;
  562.         int alloc, size;
  563.         ushort *data;
  564.         ushort clean : 1;
  565.         ushort simpletext : 1;
  566.         ushort righttoleft : 1;
  567.         ushort asciiCache : 1;
  568.         ushort capacity : 1;
  569.         ushort reserved : 11;
  570.         ushort array[1];
  571.     };
  572.     static Data shared_null;
  573.     static Data shared_empty;
  574.     Data *d;
  575.     QString(Data *dd, int /*dummy*/) : d(dd) {}
  576. #ifndef QT_NO_TEXTCODEC
  577.     static QTextCodec *codecForCStrings;
  578. #endif
  579.     static int grow(int);
  580.     static void free(Data *);
  581.     void realloc();
  582.     void realloc(int alloc);
  583.     void expand(int i);
  584.     void updateProperties() const;
  585.     QString multiArg(int numArgs, const QString **args) const;
  586.     static Data *fromLatin1_helper(const char *str, int size = -1);
  587.     static Data *fromAscii_helper(const char *str, int size = -1);
  588.     friend class QCharRef;
  589.     friend class QTextCodec;
  590.     friend class QStringRef;
  591.     friend inline bool qStringComparisonHelper(const QString &s1, const char *s2);
  592.     friend inline bool qStringComparisonHelper(const QStringRef &s1, const char *s2);
  593. public:
  594.     typedef Data * DataPtr;
  595.     inline DataPtr &data_ptr() { return d; }
  596. };
  599. class Q_CORE_EXPORT QLatin1String
  600. {
  601. public:
  602.     inline explicit QLatin1String(const char *s) : chars(s) {}
  603.     inline QLatin1String &operator=(const QLatin1String &other)
  604.     { chars = other.chars; return *this; }
  606.     inline const char *latin1() const { return chars; }
  608.     inline bool operator==(const QString &s) const
  609.     { return s == *this; }
  610.     inline bool operator!=(const QString &s) const
  611.     { return s != *this; }
  612.     inline bool operator>(const QString &s) const
  613.     { return s < *this; }
  614.     inline bool operator<(const QString &s) const
  615.     { return s > *this; }
  616.     inline bool operator>=(const QString &s) const
  617.     { return s <= *this; }
  618.     inline bool operator<=(const QString &s) const
  619.     { return s >= *this; }
  621.     inline QT_ASCII_CAST_WARN bool operator==(const char *s) const
  622.         { return QString::fromAscii(s) == *this; }
  623.     inline QT_ASCII_CAST_WARN bool operator!=(const char *s) const
  624.         { return QString::fromAscii(s) != *this; }
  625.     inline QT_ASCII_CAST_WARN bool operator<(const char *s) const
  626.         { return QString::fromAscii(s) > *this; }
  627.     inline QT_ASCII_CAST_WARN bool operator>(const char *s) const
  628.         { return QString::fromAscii(s) < *this; }
  629.     inline QT_ASCII_CAST_WARN bool operator<=(const char *s) const
  630.         { return QString::fromAscii(s) >= *this; }
  631.     inline QT_ASCII_CAST_WARN bool operator>=(const char *s) const
  632.         { return QString::fromAscii(s) <= *this; }
  633. private:
  634.     const char *chars;
  635. };
  639. inline QString::QString(const QLatin1String &aLatin1) : d(fromLatin1_helper(aLatin1.latin1()))
  640. { }
  641. inline int QString::length() const
  642. { return d->size; }
  643. inline const QChar QString::at(int i) const
  644. { Q_ASSERT(i >= 0 && i < size()); return d->data[i]; }
  645. inline const QChar QString::operator[](int i) const
  646. { Q_ASSERT(i >= 0 && i < size()); return d->data[i]; }
  647. inline const QChar QString::operator[](uint i) const
  648. { Q_ASSERT(i < uint(size())); return d->data[i]; }
  649. inline bool QString::isEmpty() const
  650. { return d->size == 0; }
  651. inline const QChar *QString::unicode() const
  652. { return reinterpret_cast<const QChar*>(d->data); }
  653. inline const QChar *QString::data() const
  654. { return reinterpret_cast<const QChar*>(d->data); }
  655. inline QChar *QString::data()
  656. { detach(); return reinterpret_cast<QChar*>(d->data); }
  657. inline const QChar *QString::constData() const
  658. { return reinterpret_cast<const QChar*>(d->data); }
  659. inline void QString::detach()
  660. { if (d->ref != 1 || d->data != d->array) realloc(); }
  661. inline bool QString::isDetached() const
  662. { return d->ref == 1; }
  663. inline QString &QString::operator=(const QLatin1String &s)
  664. {
  665.     *this = fromLatin1(s.latin1());
  666.     return *this;
  667. }
  668. inline void QString::clear()
  669. { if (!isNull()) *this = QString(); }
  670. inline QString::QString(const QString &other) : d(other.d)
  671. { Q_ASSERT(&other != this); d->ref.ref(); }
  672. inline int QString::capacity() const
  673. { return d->alloc; }
  674. inline QString &QString::setNum(short n, int base)
  675. { return setNum(qlonglong(n), base); }
  676. inline QString &QString::setNum(ushort n, int base)
  677. { return setNum(qulonglong(n), base); }
  678. inline QString &QString::setNum(int n, int base)
  679. { return setNum(qlonglong(n), base); }
  680. inline QString &QString::setNum(uint n, int base)
  681. { return setNum(qulonglong(n), base); }
  682. inline QString &QString::setNum(long n, int base)
  683. { return setNum(qlonglong(n), base); }
  684. inline QString &QString::setNum(ulong n, int base)
  685. { return setNum(qulonglong(n), base); }
  686. inline QString &QString::setNum(float n, char f, int prec)
  687. { return setNum(double(n),f,prec); }
  688. inline QString QString::arg(int a, int fieldWidth, int base, const QChar &fillChar) const
  689. { return arg(qlonglong(a), fieldWidth, base, fillChar); }
  690. inline QString QString::arg(uint a, int fieldWidth, int base, const QChar &fillChar) const
  691. { return arg(qulonglong(a), fieldWidth, base, fillChar); }
  692. inline QString QString::arg(long a, int fieldWidth, int base, const QChar &fillChar) const
  693. { return arg(qlonglong(a), fieldWidth, base, fillChar); }
  694. inline QString QString::arg(ulong a, int fieldWidth, int base, const QChar &fillChar) const
  695. { return arg(qulonglong(a), fieldWidth, base, fillChar); }
  696. inline QString QString::arg(short a, int fieldWidth, int base, const QChar &fillChar) const
  697. { return arg(qlonglong(a), fieldWidth, base, fillChar); }
  698. inline QString QString::arg(ushort a, int fieldWidth, int base, const QChar &fillChar) const
  699. { return arg(qulonglong(a), fieldWidth, base, fillChar); }
  700. inline QString QString::arg(const QString &a1, const QString &a2) const
  701. { const QString *args[2] = { &a1, &a2 }; return multiArg(2, args); }
  702. inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3) const
  703. { const QString *args[3] = { &a1, &a2, &a3 }; return multiArg(3, args); }
  704. inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
  705.                             const QString &a4) const
  706. { const QString *args[4] = { &a1, &a2, &a3, &a4 }; return multiArg(4, args); }
  707. inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
  708.                             const QString &a4, const QString &a5) const
  709. { const QString *args[5] = { &a1, &a2, &a3, &a4, &a5 }; return multiArg(5, args); }
  710. inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
  711.                             const QString &a4, const QString &a5, const QString &a6) const
  712. { const QString *args[6] = { &a1, &a2, &a3, &a4, &a5, &a6 }; return multiArg(6, args); }
  713. inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
  714.                             const QString &a4, const QString &a5, const QString &a6,
  715.                             const QString &a7) const
  716. { const QString *args[7] = { &a1, &a2, &a3, &a4, &a5, &a6,  &a7 }; return multiArg(7, args); }
  717. inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
  718.                             const QString &a4, const QString &a5, const QString &a6,
  719.                             const QString &a7, const QString &a8) const
  720. { const QString *args[8] = { &a1, &a2, &a3, &a4, &a5, &a6,  &a7, &a8 }; return multiArg(8, args); }
  721. inline QString QString::arg(const QString &a1, const QString &a2, const QString &a3,
  722.                             const QString &a4, const QString &a5, const QString &a6,
  723.                             const QString &a7, const QString &a8, const QString &a9) const
  724. { const QString *args[9] = { &a1, &a2, &a3, &a4, &a5, &a6,  &a7, &a8, &a9 }; return multiArg(9, args); }
  726. inline QString QString::section(QChar asep, int astart, int aend, SectionFlags aflags) const
  727. { return section(QString(asep), astart, aend, aflags); }
  730. class Q_CORE_EXPORT QCharRef {
  731.     QString &s;
  732.     int i;
  733.     inline QCharRef(QString &str, int idx)
  734.         : s(str),i(idx) {}
  735.     friend class QString;
  736. public:
  738.     // most QChar operations repeated here
  740.     // all this is not documented: We just say "like QChar" and let it be.
  741.     inline operator QChar() const
  742.         { return i < s.d->size ? s.d->data[i] : 0; }
  743.     inline QCharRef &operator=(const QChar &c)
  744.         { if (s.d->ref != 1 || i >= s.d->size) s.expand(i);
  745.           s.d->data[i] = c.unicode();  return *this; }
  747.     // An operator= for each QChar cast constructors
  748. #ifndef QT_NO_CAST_FROM_ASCII
  749.     inline QT_ASCII_CAST_WARN QCharRef &operator=(char c)
  750.     { return operator=(QChar::fromAscii(c)); }
  751.     inline QT_ASCII_CAST_WARN QCharRef &operator=(uchar c)
  752.     { return operator=(QChar::fromAscii(c)); }
  753. #endif
  754.     inline QCharRef &operator=(const QCharRef &c) { return operator=(QChar(c)); }
  755.     inline QCharRef &operator=(ushort rc) { return operator=(QChar(rc)); }
  756.     inline QCharRef &operator=(short rc) { return operator=(QChar(rc)); }
  757.     inline QCharRef &operator=(uint rc) { return operator=(QChar(rc)); }
  758.     inline QCharRef &operator=(int rc) { return operator=(QChar(rc)); }
  760.     // each function...
  761.     inline bool isNull() const { return QChar(*this).isNull(); }
  762.     inline bool isPrint() const { return QChar(*this).isPrint(); }
  763.     inline bool isPunct() const { return QChar(*this).isPunct(); }
  764.     inline bool isSpace() const { return QChar(*this).isSpace(); }
  765.     inline bool isMark() const { return QChar(*this).isMark(); }
  766.     inline bool isLetter() const { return QChar(*this).isLetter(); }
  767.     inline bool isNumber() const { return QChar(*this).isNumber(); }
  768.     inline bool isLetterOrNumber() { return QChar(*this).isLetterOrNumber(); }
  769.     inline bool isDigit() const { return QChar(*this).isDigit(); }
  770.     inline bool isLower() const { return QChar(*this).isLower(); }
  771.     inline bool isUpper() const { return QChar(*this).isUpper(); }
  772.     inline bool isTitleCase() const { return QChar(*this).isTitleCase(); }
  774.     inline int digitValue() const { return QChar(*this).digitValue(); }
  775.     QChar toLower() const { return QChar(*this).toLower(); }
  776.     QChar toUpper() const { return QChar(*this).toUpper(); }
  777.     QChar toTitleCase () const { return QChar(*this).toTitleCase(); }
  779.     QChar::Category category() const { return QChar(*this).category(); }
  780.     QChar::Direction direction() const { return QChar(*this).direction(); }
  781.     QChar::Joining joining() const { return QChar(*this).joining(); }
  782.     bool hasMirrored() const { return QChar(*this).hasMirrored(); }
  783.     QChar mirroredChar() const { return QChar(*this).mirroredChar(); }
  784.     QString decomposition() const { return QChar(*this).decomposition(); }
  785.     QChar::Decomposition decompositionTag() const { return QChar(*this).decompositionTag(); }
  786.     uchar combiningClass() const { return QChar(*this).combiningClass(); }
  788.     QChar::UnicodeVersion unicodeVersion() const { return QChar(*this).unicodeVersion(); }
  790.     inline uchar cell() const { return QChar(*this).cell(); }
  791.     inline uchar row() const { return QChar(*this).row(); }
  792.     inline void setCell(uchar cell);
  793.     inline void setRow(uchar row);
  795. #ifdef Q_COMPILER_MANGLES_RETURN_TYPE
  796.     const char toAscii() const { return QChar(*this).toAscii(); }
  797.     const char toLatin1() const { return QChar(*this).toLatin1(); }
  798.     const ushort unicode() const { return QChar(*this).unicode(); }
  799. #else
  800.     char toAscii() const { return QChar(*this).toAscii(); }
  801.     char toLatin1() const { return QChar(*this).toLatin1(); }
  802.     ushort unicode() const { return QChar(*this).unicode(); }
  803. #endif
  804.     ushort& unicode() { return s.data()[i].unicode(); }
  806. #ifdef QT3_SUPPORT
  807.     inline QT3_SUPPORT bool mirrored() const { return hasMirrored(); }
  808.     inline QT3_SUPPORT QChar lower() const { return QChar(*this).toLower(); }
  809.     inline QT3_SUPPORT QChar upper() const { return QChar(*this).toUpper(); }
  810. #ifdef Q_COMPILER_MANGLES_RETURN_TYPE
  811.     const QT3_SUPPORT char latin1() const { return QChar(*this).toLatin1(); }
  812.     const QT3_SUPPORT char ascii() const { return QChar(*this).toAscii(); }
  813. #else
  814.     QT3_SUPPORT char latin1() const { return QChar(*this).toLatin1(); }
  815.     QT3_SUPPORT char ascii() const { return QChar(*this).toAscii(); }
  816. #endif
  817. #endif
  818. };
  820. inline void QCharRef::setRow(uchar arow) { QChar(*this).setRow(arow); }
  821. inline void QCharRef::setCell(uchar acell) { QChar(*this).setCell(acell); }
  824. inline QString::QString() : d(&shared_null) { d->ref.ref(); }
  825. inline QString::~QString() { if (!d->ref.deref()) free(d); }
  826. inline void QString::reserve(int asize) { if (d->ref != 1 || asize > d->alloc) realloc(asize); d->capacity = 1;}
  827. inline QString &QString::setUtf16(const ushort *autf16, int asize)
  828. { return setUnicode(reinterpret_cast<const QChar *>(autf16), asize); }
  829. inline QCharRef QString::operator[](int i)
  830. { Q_ASSERT(i >= 0); return QCharRef(*this, i); }
  831. inline QCharRef QString::operator[](uint i)
  832. { return QCharRef(*this, i); }
  833. inline QString::iterator QString::begin()
  834. { detach(); return reinterpret_cast<QChar*>(d->data); }
  835. inline QString::const_iterator QString::begin() const
  836. { return reinterpret_cast<const QChar*>(d->data); }
  837. inline QString::const_iterator QString::constBegin() const
  838. { return reinterpret_cast<const QChar*>(d->data); }
  839. inline QString::iterator QString::end()
  840. { detach(); return reinterpret_cast<QChar*>(d->data + d->size); }
  841. inline QString::const_iterator QString::end() const
  842. { return reinterpret_cast<const QChar*>(d->data + d->size); }
  843. inline QString::const_iterator QString::constEnd() const
  844. { return reinterpret_cast<const QChar*>(d->data + d->size); }
  845. inline QBool QString::contains(const QString &s, Qt::CaseSensitivity cs) const
  846. { return QBool(indexOf(s, 0, cs) != -1); }
  847. inline QBool QString::contains(QChar c, Qt::CaseSensitivity cs) const
  848. { return QBool(indexOf(c, 0, cs) != -1); }
  851. inline bool operator==(QString::Null, QString::Null) { return true; }
  852. inline bool operator==(QString::Null, const QString &s) { return s.isNull(); }
  853. inline bool operator==(const QString &s, QString::Null) { return s.isNull(); }
  854. inline bool operator!=(QString::Null, QString::Null) { return false; }
  855. inline bool operator!=(QString::Null, const QString &s) { return !s.isNull(); }
  856. inline bool operator!=(const QString &s, QString::Null) { return !s.isNull(); }
  858. #ifndef QT_NO_CAST_FROM_ASCII
  859. inline bool qStringComparisonHelper(const QString &s1, const char *s2)
  860. {
  861. #  ifndef QT_NO_TEXTCODEC
  862.     if (QString::codecForCStrings) return (s1 == QString::fromAscii(s2));
  863. #  endif
  864.     return (s1 == QLatin1String(s2));
  865. }
  866. inline bool QString::operator==(const char *s) const
  867. { return qStringComparisonHelper(*this, s); }
  868. inline bool QString::operator!=(const char *s) const
  869. { return !qStringComparisonHelper(*this, s); }
  870. inline bool QString::operator<(const char *s) const
  871. { return *this < QString::fromAscii(s); }
  872. inline bool QString::operator>(const char *s) const
  873. { return *this > QString::fromAscii(s); }
  874. inline bool QString::operator<=(const char *s) const
  875. { return *this <= QString::fromAscii(s); }
  876. inline bool QString::operator>=(const char *s) const
  877. { return *this >= QString::fromAscii(s); }
  879. inline QT_ASCII_CAST_WARN bool operator==(const char *s1, const QString &s2)
  880. { return qStringComparisonHelper(s2, s1); }
  881. inline QT_ASCII_CAST_WARN bool operator!=(const char *s1, const QString &s2)
  882. { return !qStringComparisonHelper(s2, s1); }
  883. inline QT_ASCII_CAST_WARN bool operator<(const char *s1, const QString &s2)
  884. { return (QString::fromAscii(s1) < s2); }
  885. inline QT_ASCII_CAST_WARN bool operator>(const char *s1, const QString &s2)
  886. { return (QString::fromAscii(s1) > s2); }
  887. inline QT_ASCII_CAST_WARN bool operator<=(const char *s1, const QString &s2)
  888. { return (QString::fromAscii(s1) <= s2); }
  889. inline QT_ASCII_CAST_WARN bool operator>=(const char *s1, const QString &s2)
  890. { return (QString::fromAscii(s1) >= s2); }
  892. inline QT_ASCII_CAST_WARN bool operator==(const char *s1, const QLatin1String &s2)
  893. { return QString::fromAscii(s1) == s2; }
  894. inline QT_ASCII_CAST_WARN bool operator!=(const char *s1, const QLatin1String &s2)
  895. { return QString::fromAscii(s1) != s2; }
  896. inline QT_ASCII_CAST_WARN bool operator<(const char *s1, const QLatin1String &s2)
  897. { return (QString::fromAscii(s1) < s2); }
  898. inline QT_ASCII_CAST_WARN bool operator>(const char *s1, const QLatin1String &s2)
  899. { return (QString::fromAscii(s1) > s2); }
  900. inline QT_ASCII_CAST_WARN bool operator<=(const char *s1, const QLatin1String &s2)
  901. { return (QString::fromAscii(s1) <= s2); }
  902. inline QT_ASCII_CAST_WARN bool operator>=(const char *s1, const QLatin1String &s2)
  903. { return (QString::fromAscii(s1) >= s2); }
  905. inline bool operator==(const QLatin1String &s1, const QLatin1String &s2)
  906. { return (qstrcmp(s1.latin1(), s2.latin1()) == 0); }
  907. inline bool operator!=(const QLatin1String &s1, const QLatin1String &s2)
  908. { return (qstrcmp(s1.latin1(), s2.latin1()) != 0); }
  909. inline bool operator<(const QLatin1String &s1, const QLatin1String &s2)
  910. { return (qstrcmp(s1.latin1(), s2.latin1()) < 0); }
  911. inline bool operator<=(const QLatin1String &s1, const QLatin1String &s2)
  912. { return (qstrcmp(s1.latin1(), s2.latin1()) <= 0); }
  913. inline bool operator>(const QLatin1String &s1, const QLatin1String &s2)
  914. { return (qstrcmp(s1.latin1(), s2.latin1()) > 0); }
  915. inline bool operator>=(const QLatin1String &s1, const QLatin1String &s2)
  916. { return (qstrcmp(s1.latin1(), s2.latin1()) >= 0); }
  919. inline bool QString::operator==(const QByteArray &s) const
  920. { return qStringComparisonHelper(*this, s.constData()); }
  921. inline bool QString::operator!=(const QByteArray &s) const
  922. { return !qStringComparisonHelper(*this, s.constData()); }
  924. inline bool QByteArray::operator==(const QString &s) const
  925. { return qStringComparisonHelper(s, constData()); }
  926. inline bool QByteArray::operator!=(const QString &s) const
  927. { return !qStringComparisonHelper(s, constData()); }
  928. inline bool QByteArray::operator<(const QString &s) const
  929. { return QString::fromAscii(constData(), size()) < s; }
  930. inline bool QByteArray::operator>(const QString &s) const
  931. { return QString::fromAscii(constData(), size()) > s; }
  932. inline bool QByteArray::operator<=(const QString &s) const
  933. { return QString::fromAscii(constData(), size()) <= s; }
  934. inline bool QByteArray::operator>=(const QString &s) const
  935. { return QString::fromAscii(constData(), size()) >= s; }
  936. #endif   // QT_NO_CAST_FROM_ASCII
  938. #ifndef QT_NO_CAST_TO_ASCII
  939. inline QByteArray &QByteArray::append(const QString &s)
  940. { return append(s.toAscii()); }
  941. inline QByteArray &QByteArray::insert(int i, const QString &s)
  942. { return insert(i, s.toAscii()); }
  943. inline QByteArray &QByteArray::replace(char c, const QString &after)
  944. { return replace(c, after.toAscii()); }
  945. inline QByteArray &QByteArray::replace(const QString &before, const char *after)
  946. { return replace(before.toAscii(), after); }
  947. inline QByteArray &QByteArray::replace(const QString &before, const QByteArray &after)
  948. { return replace(before.toAscii(), after); }
  949. inline QByteArray &QByteArray::operator+=(const QString &s)
  950. { return operator+=(s.toAscii()); }
  951. inline int QByteArray::indexOf(const QString &s, int from) const
  952. { return indexOf(s.toAscii(), from); }
  953. inline int QByteArray::lastIndexOf(const QString &s, int from) const
  954. { return lastIndexOf(s.toAscii(), from); }
  955. #  ifdef QT3_SUPPORT
  956. inline int QByteArray::find(const QString &s, int from) const
  957. { return indexOf(s.toAscii(), from); }
  958. inline int QByteArray::findRev(const QString &s, int from) const
  959. { return lastIndexOf(s.toAscii(), from); }
  960. #  endif // QT3_SUPPORT
  961. #endif // QT_NO_CAST_TO_ASCII
  963. inline const QString operator+(const QString &s1, const QString &s2)
  964. { QString t(s1); t += s2; return t; }
  965. inline const QString operator+(const QString &s1, QChar s2)
  966. { QString t(s1); t += s2; return t; }
  967. inline const QString operator+(QChar s1, const QString &s2)
  968. { QString t(s1); t += s2; return t; }
  969. #ifndef QT_NO_CAST_FROM_ASCII
  970. inline QT_ASCII_CAST_WARN const QString operator+(const QString &s1, const char *s2)
  971. { QString t(s1); t += QString::fromAscii(s2); return t; }
  972. inline QT_ASCII_CAST_WARN const QString operator+(const char *s1, const QString &s2)
  973. { QString t = QString::fromAscii(s1); t += s2; return t; }
  974. inline QT_ASCII_CAST_WARN const QString operator+(char c, const QString &s)
  975. { QString t = s; t.prepend(QChar::fromAscii(c)); return t; }
  976. inline QT_ASCII_CAST_WARN const QString operator+(const QString &s, char c)
  977. { QString t = s; t += QChar::fromAscii(c); return t; }
  978. inline QT_ASCII_CAST_WARN const QString operator+(const QByteArray &ba, const QString &s)
  979. { QString t = QString::fromAscii(ba.constData(), qstrnlen(ba.constData(), ba.size())); t += s; return t; }
  980. inline QT_ASCII_CAST_WARN const QString operator+(const QString &s, const QByteArray &ba)
  981. { QString t(s); t += QString::fromAscii(ba.constData(), qstrnlen(ba.constData(), ba.size())); return t; }
  982. #endif
  984. #ifndef QT_NO_STL
  985. inline std::string QString::toStdString() const
  986. { const QByteArray asc = toAscii(); return std::string(asc.constData(), asc.length()); }
  988. inline QString QString::fromStdString(const std::string &s)
  989. { return fromAscii(s.data(), int(s.size())); }
  991. # ifndef QT_NO_STL_WCHAR
  992. inline QStdWString QString::toStdWString() const
  993. {
  994.     QStdWString str;
  995.     str.resize(length());
  997. #if defined(_MSC_VER) && _MSC_VER >= 1400
  998.     // VS2005 crashes if the string is empty
  999.     if (!length())
  1000.         return str;
  1001. #endif
  1003.     str.resize(toWCharArray(&(*str.begin())));
  1004.     return str;
  1005. }
  1006. inline QString QString::fromStdWString(const QStdWString &s)
  1007. { return fromWCharArray(s.data(), int(s.size())); }
  1008. # endif
  1009. #endif
  1011. #ifdef QT3_SUPPORT
  1012. inline QChar &QString::ref(uint i)
  1013. {
  1014.     if (int(i) > d->size || d->ref != 1)
  1015.         resize(qMax(int(i), d->size));
  1016.     return reinterpret_cast<QChar&>(d->data[i]);
  1017. }
  1018. #endif
  1020. #ifndef QT_NO_DATASTREAM
  1021. Q_CORE_EXPORT QDataStream &operator<<(QDataStream &, const QString &);
  1022. Q_CORE_EXPORT QDataStream &operator>>(QDataStream &, QString &);
  1023. #endif
  1025. #ifdef QT3_SUPPORT
  1026. class QConstString : public QString
  1027. {
  1028. public:
  1029.     inline QT3_SUPPORT_CONSTRUCTOR QConstString(const QChar *aUnicode, int aSize)
  1030.         :QString(aUnicode, aSize){} // cannot use fromRawData() due to changed semantics
  1031.     inline QT3_SUPPORT const QString &string() const { return *this; }
  1032. };
  1033. #endif
  1035. Q_DECLARE_TYPEINFO(QString, Q_MOVABLE_TYPE);
  1036. Q_DECLARE_SHARED(QString)
  1037. Q_DECLARE_OPERATORS_FOR_FLAGS(QString::SectionFlags)
  1039. #if defined(Q_OS_WIN32) || defined(Q_OS_WINCE)
  1040. extern Q_CORE_EXPORT QByteArray qt_winQString2MB(const QString& s, int len=-1);
  1041. extern Q_CORE_EXPORT QByteArray qt_winQString2MB(const QChar *ch, int len);
  1042. extern Q_CORE_EXPORT QString qt_winMB2QString(const char* mb, int len=-1);
  1043. #endif
  1046. class Q_CORE_EXPORT QStringRef {
  1047.     const QString *m_string;
  1048.     int m_position;
  1049.     int m_size;
  1050. public:
  1051.     inline QStringRef():m_string(0), m_position(0), m_size(0){}
  1052.     inline QStringRef(const QString *string, int position, int size);
  1053.     inline QStringRef(const QString *string);
  1054.     inline QStringRef(const QStringRef &other)
  1055.         :m_string(other.m_string), m_position(other.m_position), m_size(other.m_size)
  1056.         {}
  1058.     inline ~QStringRef(){}
  1059.     inline const QString *string() const { return m_string; }
  1060.     inline int position() const { return m_position; }
  1061.     inline int size() const { return m_size; }
  1062.     inline int count() const { return m_size; }
  1063.     inline int length() const { return m_size; }
  1065.     inline QStringRef &operator=(const QStringRef &other) {
  1066.         m_string = other.m_string; m_position = other.m_position;
  1067.         m_size = other.m_size; return *this;
  1068.     }
  1070.     inline QStringRef &operator=(const QString *string);
  1072.     inline const QChar *unicode() const {
  1073.         if (!m_string)
  1074.             return reinterpret_cast<const QChar *>(QString::shared_null.data);
  1075.         return m_string->unicode() + m_position;
  1076.     }
  1077.     inline const QChar *data() const { return unicode(); }
  1078.     inline const QChar *constData() const {  return unicode(); }
  1080.     inline void clear() { m_string = 0; m_position = m_size = 0; }
  1081.     QString toString() const;
  1082.     inline bool isEmpty() const { return m_size == 0; }
  1083.     inline bool isNull() const { return m_string == 0 || m_string->isNull(); }
  1085.     QStringRef appendTo(QString *string) const;
  1087.     inline const QChar at(int i) const
  1088.         { Q_ASSERT(i >= 0 && i < size()); return m_string->at(i + m_position); }
  1090. };
  1092. inline QStringRef &QStringRef::operator=(const QString *aString)
  1093. { m_string = aString; m_position = 0; m_size = aString?aString->size():0; return *this; }
  1095. inline QStringRef::QStringRef(const QString *aString, int aPosition, int aSize)
  1096.         :m_string(aString), m_position(aPosition), m_size(aSize){}
  1098. inline QStringRef::QStringRef(const QString *aString)
  1099.     :m_string(aString), m_position(0), m_size(aString?aString->size() : 0){}
  1101. Q_CORE_EXPORT bool operator==(const QStringRef &s1,const QStringRef &s2);
  1102. inline bool operator!=(const QStringRef &s1,const QStringRef &s2)
  1103. { return !(s1 == s2); }
  1104. Q_CORE_EXPORT bool operator==(const QString &s1,const QStringRef &s2);
  1105. inline bool operator!=(const QString &s1,const QStringRef &s2)
  1106. { return !(s1 == s2); }
  1107. inline bool operator==(const QStringRef &s1,const QString &s2)
  1108. { return s2 == s1; }
  1109. inline bool operator!=(const QStringRef &s1,const QString &s2)
  1110. { return s2 != s1; }
  1111. Q_CORE_EXPORT bool operator==(const QLatin1String &s1, const QStringRef &s2);
  1112. inline bool operator!=(const QLatin1String &s1,const QStringRef &s2)
  1113. { return !(s1 == s2); }
  1114. inline bool operator==(const QStringRef &s1,const QLatin1String &s2)
  1115. { return s2 == s1; }
  1116. inline bool operator!=(const QStringRef &s1,const QLatin1String &s2)
  1117. { return s2 != s1; }
  1119. Q_CORE_EXPORT bool operator<(const QStringRef &s1,const QStringRef &s2);
  1120. inline bool operator>(const QStringRef &s1, const QStringRef &s2)
  1121. { return s2 < s1; }
  1122. inline bool operator<=(const QStringRef &s1, const QStringRef &s2)
  1123. { return !(s1 > s2); }
  1124. inline bool operator>=(const QStringRef &s1, const QStringRef &s2)
  1125. { return !(s1 < s2); }
  1127. inline bool qStringComparisonHelper(const QStringRef &s1, const char *s2)
  1128. {
  1129. #  ifndef QT_NO_TEXTCODEC
  1130.     if (QString::codecForCStrings) return (s1 == QString::fromAscii(s2));
  1131. #  endif
  1132.     return (s1 == QLatin1String(s2));
  1133. }
  1135. inline QT_ASCII_CAST_WARN bool operator==(const char *s1, const QStringRef &s2)
  1136. { return qStringComparisonHelper(s2, s1); }
  1137. inline QT_ASCII_CAST_WARN bool operator==(const QStringRef &s1, const char *s2)
  1138. { return qStringComparisonHelper(s1, s2); }
  1139. inline QT_ASCII_CAST_WARN bool operator!=(const char *s1, const QStringRef &s2)
  1140. { return !qStringComparisonHelper(s2, s1); }
  1141. inline QT_ASCII_CAST_WARN bool operator!=(const QStringRef &s1, const char *s2)
  1142. { return !qStringComparisonHelper(s1, s2); }
  1144. QT_END_NAMESPACE
  1146. QT_END_HEADER
  1148. #endif // QSTRING_H