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