You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tqt3/doc/html/tqstring-h.html

1160 lines
39 KiB

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
<title>tqstring.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&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;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>tqstring.h</h1>
<p>This is the verbatim text of the tqstring.h include file. It is provided only for illustration; the copyright remains with Trolltech.
<hr>
<pre>
/****************************************************************************
** $Id: qt/tqstring.h 3.3.8 edited Jan 11 14:38 $
**
** Definition of the TQString 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 TQt 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 TQt 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.TQPL
** included in the packaging of this file. Licensees holding valid TQt
** Commercial licenses may use this file in accordance with the TQt
** 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 TQSTRING_H
#define TQSTRING_H
#ifndef QT_H
#include "tqcstring.h"
#endif // QT_H
#ifndef TQT_NO_CAST_ASCII
#include &lt;limits.h&gt;
#endif
#ifndef TQT_NO_STL
#if defined ( Q_CC_MSVC_NET ) &amp;&amp; _MSC_VER &lt; 1310 // Avoids nasty warning for xlocale, line 450
# pragma warning ( push )
# pragma warning ( disable : 4189 )
# include &lt;string&gt;
# pragma warning ( pop )
#else
# include &lt;string&gt;
#endif
#if defined(Q_WRONG_SB_CTYPE_MACROS) &amp;&amp; defined(_SB_CTYPE_MACROS)
#undef _SB_CTYPE_MACROS
#endif
#endif
/*****************************************************************************
TQString class
*****************************************************************************/
class TQRegExp;
class TQString;
class TQCharRef;
template &lt;class T&gt; class TQDeepCopy;
class TQ_EXPORT TQChar {
public:
TQChar();
TQChar( char c );
TQChar( uchar c );
TQChar( uchar c, uchar r );
TQChar( const TQChar&amp; c ); // ### remove in 4.0 to allow compiler optimization
TQChar( ushort rc );
TQChar( short rc );
TQChar( uint rc );
TQChar( int rc );
static const TQChar null; // 0000
static const TQChar replacement; // FFFD
static const TQChar byteOrderMark; // FEFF
static const TQChar byteOrderSwapped; // FFFE
static const TQChar 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 TQCharRef TOO
int digitValue() const;
TQChar lower() const;
TQChar upper() const;
Category category() const;
Direction direction() const;
Joining joining() const;
bool mirrored() const;
TQChar mirroredChar() const;
const TQString &amp;decomposition() const; // ### return just TQString in 4.0
Decomposition decompositionTag() const;
unsigned char combiningClass() const;
char latin1() const { return ucs &gt; 0xff ? 0 : (char) ucs; }
ushort unicode() const { return ucs; }
#ifdef Q_NO_PACKED_REFERENCE
ushort &amp;unicode() { return *(&amp;ucs); }
#else
ushort &amp;unicode() { return ucs; }
#endif
#ifndef TQT_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 &amp; 0xff); }
uchar row() const { return ((uchar) (ucs&gt;&gt;8)&amp;0xff); }
void setCell( uchar cell ) { ucs = (ucs &amp; 0xff00) + cell; }
void setRow( uchar row ) { ucs = (((ushort) row)&lt;&lt;8) + (ucs&amp;0xff); }
static bool networkOrdered() {
int wordSize;
bool bigEndian = FALSE;
tqSysInfo( &amp;wordSize, &amp;bigEndian );
return bigEndian;
}
friend inline bool operator==( char ch, TQChar c );
friend inline bool operator==( TQChar c, char ch );
friend inline bool operator==( TQChar c1, TQChar c2 );
friend inline bool operator!=( TQChar c1, TQChar c2 );
friend inline bool operator!=( char ch, TQChar c );
friend inline bool operator!=( TQChar c, char ch );
friend inline bool operator&lt;=( TQChar c, char ch );
friend inline bool operator&lt;=( char ch, TQChar c );
friend inline bool operator&lt;=( TQChar c1, TQChar c2 );
private:
ushort ucs;
#if defined(QT_QSTRING_UCS_4)
ushort grp;
#endif
} TQ_PACKED;
inline TQChar::TQChar() : ucs( 0 )
#ifdef QT_QSTRING_UCS_4
, grp( 0 )
#endif
{
}
inline TQChar::TQChar( char c ) : ucs( (uchar)c )
#ifdef QT_QSTRING_UCS_4
, grp( 0 )
#endif
{
}
inline TQChar::TQChar( uchar c ) : ucs( c )
#ifdef QT_QSTRING_UCS_4
, grp( 0 )
#endif
{
}
inline TQChar::TQChar( uchar c, uchar r ) : ucs( (r &lt;&lt; 8) | c )
#ifdef QT_QSTRING_UCS_4
, grp( 0 )
#endif
{
}
inline TQChar::TQChar( const TQChar&amp; c ) : ucs( c.ucs )
#ifdef QT_QSTRING_UCS_4
, grp( c.grp )
#endif
{
}
inline TQChar::TQChar( ushort rc ) : ucs( rc )
#ifdef QT_QSTRING_UCS_4
, grp( 0 )
#endif
{
}
inline TQChar::TQChar( short rc ) : ucs( (ushort) rc )
#ifdef QT_QSTRING_UCS_4
, grp( 0 )
#endif
{
}
inline TQChar::TQChar( uint rc ) : ucs( (ushort ) (rc &amp; 0xffff) )
#ifdef QT_QSTRING_UCS_4
, grp( (ushort) ((rc &gt;&gt; 16) &amp; 0xffff) )
#endif
{
}
inline TQChar::TQChar( int rc ) : ucs( (ushort) (rc &amp; 0xffff) )
#ifdef QT_QSTRING_UCS_4
, grp( (ushort) ((rc &gt;&gt; 16) &amp; 0xffff) )
#endif
{
}
inline bool operator==( char ch, TQChar c )
{
return ((uchar) ch) == c.ucs;
}
inline bool operator==( TQChar c, char ch )
{
return ((uchar) ch) == c.ucs;
}
inline bool operator==( TQChar c1, TQChar c2 )
{
return c1.ucs == c2.ucs;
}
inline bool operator!=( TQChar c1, TQChar c2 )
{
return c1.ucs != c2.ucs;
}
inline bool operator!=( char ch, TQChar c )
{
return ((uchar)ch) != c.ucs;
}
inline bool operator!=( TQChar c, char ch )
{
return ((uchar) ch) != c.ucs;
}
inline bool operator&lt;=( TQChar c, char ch )
{
return c.ucs &lt;= ((uchar) ch);
}
inline bool operator&lt;=( char ch, TQChar c )
{
return ((uchar) ch) &lt;= c.ucs;
}
inline bool operator&lt;=( TQChar c1, TQChar c2 )
{
return c1.ucs &lt;= c2.ucs;
}
inline bool operator&gt;=( TQChar c, char ch ) { return ch &lt;= c; }
inline bool operator&gt;=( char ch, TQChar c ) { return c &lt;= ch; }
inline bool operator&gt;=( TQChar c1, TQChar c2 ) { return c2 &lt;= c1; }
inline bool operator&lt;( TQChar c, char ch ) { return !(ch&lt;=c); }
inline bool operator&lt;( char ch, TQChar c ) { return !(c&lt;=ch); }
inline bool operator&lt;( TQChar c1, TQChar c2 ) { return !(c2&lt;=c1); }
inline bool operator&gt;( TQChar c, char ch ) { return !(ch&gt;=c); }
inline bool operator&gt;( char ch, TQChar c ) { return !(c&gt;=ch); }
inline bool operator&gt;( TQChar c1, TQChar c2 ) { return !(c2&gt;=c1); }
// internal
struct TQ_EXPORT TQStringData : public TQShared {
TQStringData() :
TQShared(), unicode(0), ascii(0), len(0), issimpletext(TRUE), maxl(0), islatin1(FALSE) { ref(); }
TQStringData(TQChar *u, uint l, uint m) :
TQShared(), unicode(u), ascii(0), len(l), issimpletext(FALSE), maxl(m), islatin1(FALSE) { }
~TQStringData() { if ( unicode ) delete[] ((char*)unicode);
if ( ascii ) delete[] ascii; }
void deleteSelf();
TQChar *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(TQ_DISABLE_COPY)
TQStringData( const TQStringData&amp; );
TQStringData&amp; operator=( const TQStringData&amp; );
#endif
};
class TQ_EXPORT TQString
{
public:
TQString(); // make null string
TQString( TQChar ); // one-char string
TQString( const TQString &amp; ); // impl-shared copy
TQString( const TQByteArray&amp; ); // deep copy
TQString( const TQChar* unicode, uint length ); // deep copy
#ifndef TQT_NO_CAST_ASCII
TQString( const char *str ); // deep copy
#endif
#ifndef TQT_NO_STL
TQString( const std::string&amp; ); // deep copy
#endif
~TQString();
TQString &amp;operator=( const TQString &amp; ); // impl-shared copy
TQString &amp;operator=( const char * ); // deep copy
#ifndef TQT_NO_STL
TQString &amp;operator=( const std::string&amp; ); // deep copy
#endif
TQString &amp;operator=( const TQCString&amp; ); // deep copy
TQString &amp;operator=( TQChar c );
TQString &amp;operator=( char c );
static const TQString null;
bool isNull() const;
bool isEmpty() const;
uint length() const;
void truncate( uint pos );
TQString &amp; fill( TQChar c, int len = -1 );
TQString copy() const;
TQString arg( long a, int fieldWidth = 0, int base = 10 ) const;
TQString arg( ulong a, int fieldWidth = 0, int base = 10 ) const;
TQString arg( TQ_LLONG a, int fieldwidth=0, int base=10 ) const;
TQString arg( TQ_ULLONG a, int fieldwidth=0, int base=10 ) const;
TQString arg( int a, int fieldWidth = 0, int base = 10 ) const;
TQString arg( uint a, int fieldWidth = 0, int base = 10 ) const;
TQString arg( short a, int fieldWidth = 0, int base = 10 ) const;
TQString arg( ushort a, int fieldWidth = 0, int base = 10 ) const;
TQString arg( double a, int fieldWidth = 0, char fmt = 'g',
int prec = -1 ) const;
TQString arg( char a, int fieldWidth = 0 ) const;
TQString arg( TQChar a, int fieldWidth = 0 ) const;
TQString arg( const TQString&amp; a, int fieldWidth = 0 ) const;
TQString arg( const TQString&amp; a1, const TQString&amp; a2 ) const;
TQString arg( const TQString&amp; a1, const TQString&amp; a2,
const TQString&amp; a3 ) const;
TQString arg( const TQString&amp; a1, const TQString&amp; a2, const TQString&amp; a3,
const TQString&amp; a4 ) const;
#ifndef TQT_NO_SPRINTF
TQString &amp;sprintf( const char* format, ... )
#if defined(Q_CC_GNU) &amp;&amp; !defined(__INSURE__)
__attribute__ ((format (printf, 2, 3)))
#endif
;
#endif
int find( TQChar c, int index=0, bool cs=TRUE ) const;
int find( char c, int index=0, bool cs=TRUE ) const;
int find( const TQString &amp;str, int index=0, bool cs=TRUE ) const;
#ifndef TQT_NO_REGEXP
int find( const TQRegExp &amp;, int index=0 ) const;
#endif
#ifndef TQT_NO_CAST_ASCII
int find( const char* str, int index=0 ) const;
#endif
int findRev( TQChar c, int index=-1, bool cs=TRUE) const;
int findRev( char c, int index=-1, bool cs=TRUE) const;
int findRev( const TQString &amp;str, int index=-1, bool cs=TRUE) const;
#ifndef TQT_NO_REGEXP
int findRev( const TQRegExp &amp;, int index=-1 ) const;
#endif
#ifndef TQT_NO_CAST_ASCII
int findRev( const char* str, int index=-1 ) const;
#endif
int contains( TQChar c, bool cs=TRUE ) const;
int contains( char c, bool cs=TRUE ) const
{ return contains(TQChar(c), cs); }
#ifndef TQT_NO_CAST_ASCII
int contains( const char* str, bool cs=TRUE ) const;
#endif
int contains( const TQString &amp;str, bool cs=TRUE ) const;
#ifndef TQT_NO_REGEXP
int contains( const TQRegExp &amp; ) const;
#endif
enum SectionFlags {
SectionDefault = 0x00,
SectionSkipEmpty = 0x01,
SectionIncludeLeadingSep = 0x02,
SectionIncludeTrailingSep = 0x04,
SectionCaseInsensitiveSeps = 0x08
};
TQString section( TQChar sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
TQString section( char sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
#ifndef TQT_NO_CAST_ASCII
TQString section( const char *in_sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
#endif
TQString section( const TQString &amp;in_sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
#ifndef TQT_NO_REGEXP
TQString section( const TQRegExp &amp;reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const;
#endif
TQString left( uint len ) const;
TQString right( uint len ) const;
TQString mid( uint index, uint len=0xffffffff) const;
TQString leftJustify( uint width, TQChar fill=' ', bool trunc=FALSE)const;
TQString rightJustify( uint width, TQChar fill=' ',bool trunc=FALSE)const;
TQString lower() const;
TQString upper() const;
TQString stripWhiteSpace() const;
TQString simplifyWhiteSpace() const;
TQString &amp;insert( uint index, const TQString &amp; );
#ifndef TQT_NO_CAST_ASCII
TQString &amp;insert( uint index, const TQByteArray &amp; );
TQString &amp;insert( uint index, const char * );
#endif
TQString &amp;insert( uint index, const TQChar*, uint len );
TQString &amp;insert( uint index, TQChar );
TQString &amp;insert( uint index, char c ) { return insert(index,TQChar(c)); }
TQString &amp;append( char );
TQString &amp;append( TQChar );
TQString &amp;append( const TQString &amp; );
#ifndef TQT_NO_CAST_ASCII
TQString &amp;append( const TQByteArray &amp; );
TQString &amp;append( const char * );
#endif
#if !defined(TQT_NO_STL) &amp;&amp; !defined(TQT_NO_CAST_ASCII)
TQString &amp;append( const std::string&amp; );
#endif
TQString &amp;prepend( char );
TQString &amp;prepend( TQChar );
TQString &amp;prepend( const TQString &amp; );
#ifndef TQT_NO_CAST_ASCII
TQString &amp;prepend( const TQByteArray &amp; );
TQString &amp;prepend( const char * );
#endif
#if !defined(TQT_NO_STL) &amp;&amp; !defined(TQT_NO_CAST_ASCII)
TQString &amp;prepend( const std::string&amp; );
#endif
TQString &amp;remove( uint index, uint len );
#if defined(Q_QDOC)
TQString &amp;remove( const TQString &amp; str, bool cs = TRUE );
#else
// ### TQt 4.0: merge these two into one, and remove Q_QDOC hack
TQString &amp;remove( const TQString &amp; );
TQString &amp;remove( const TQString &amp;, bool cs );
#endif
TQString &amp;remove( TQChar c );
TQString &amp;remove( char c )
{ return remove( TQChar(c) ); }
#ifndef TQT_NO_CAST_ASCII
TQString &amp;remove( const char * );
#endif
#ifndef TQT_NO_REGEXP
TQString &amp;remove( const TQRegExp &amp; );
#endif
TQString &amp;replace( uint index, uint len, const TQString &amp; );
TQString &amp;replace( uint index, uint len, const TQChar*, uint clen );
TQString &amp;replace( uint index, uint len, TQChar );
TQString &amp;replace( uint index, uint len, char c )
{ return replace( index, len, TQChar(c) ); }
#if defined(Q_QDOC)
TQString &amp;replace( TQChar c, const TQString &amp; after, bool cs = TRUE );
TQString &amp;replace( char c, const TQString &amp; after, bool cs = TRUE );
TQString &amp;replace( const TQString &amp; before, const TQString &amp; after,
bool cs = TRUE );
#else
// ### TQt 4.0: merge these two into one, and remove Q_QDOC hack
TQString &amp;replace( TQChar c, const TQString &amp; );
TQString &amp;replace( TQChar c, const TQString &amp;, bool );
// ### TQt 4.0: merge these two into one, and remove Q_QDOC hack
TQString &amp;replace( char c, const TQString &amp; after )
{ return replace( TQChar(c), after, TRUE ); }
TQString &amp;replace( char c, const TQString &amp; after, bool cs )
{ return replace( TQChar(c), after, cs ); }
// ### TQt 4.0: merge these two into one, and remove Q_QDOC hack
TQString &amp;replace( const TQString &amp;, const TQString &amp; );
TQString &amp;replace( const TQString &amp;, const TQString &amp;, bool );
#endif
#ifndef TQT_NO_REGEXP_CAPTURE
TQString &amp;replace( const TQRegExp &amp;, const TQString &amp; );
#endif
TQString &amp;replace( TQChar, TQChar );
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;
TQ_LLONG toLongLong( bool *ok=0, int base=10 ) const;
TQ_ULLONG toULongLong( bool *ok=0, int base=10 ) const;
float toFloat( bool *ok=0 ) const;
double toDouble( bool *ok=0 ) const;
TQString &amp;setNum( short, int base=10 );
TQString &amp;setNum( ushort, int base=10 );
TQString &amp;setNum( int, int base=10 );
TQString &amp;setNum( uint, int base=10 );
TQString &amp;setNum( long, int base=10 );
TQString &amp;setNum( ulong, int base=10 );
TQString &amp;setNum( TQ_LLONG, int base=10 );
TQString &amp;setNum( TQ_ULLONG, int base=10 );
TQString &amp;setNum( float, char f='g', int prec=6 );
TQString &amp;setNum( double, char f='g', int prec=6 );
static TQString number( long, int base=10 );
static TQString number( ulong, int base=10);
static TQString number( TQ_LLONG, int base=10 );
static TQString number( TQ_ULLONG, int base=10);
static TQString number( int, int base=10 );
static TQString number( uint, int base=10);
static TQString number( double, char f='g', int prec=6 );
void setExpand( uint index, TQChar c );
TQString &amp;operator+=( const TQString &amp;str );
#ifndef TQT_NO_CAST_ASCII
TQString &amp;operator+=( const TQByteArray &amp;str );
TQString &amp;operator+=( const char *str );
#endif
#if !defined(TQT_NO_STL) &amp;&amp; !defined(TQT_NO_CAST_ASCII)
TQString &amp;operator+=( const std::string&amp; );
#endif
TQString &amp;operator+=( TQChar c );
TQString &amp;operator+=( char c );
TQChar at( uint i ) const
{ return i &lt; d-&gt;len ? d-&gt;unicode[i] : TQChar::null; }
TQChar operator[]( int i ) const { return at((uint)i); }
TQCharRef at( uint i );
TQCharRef operator[]( int i );
TQChar constref(uint i) const
{ return at(i); }
TQChar&amp; ref(uint i)
{ // Optimized for easy-inlining by simple compilers.
if ( d-&gt;count != 1 || i &gt;= d-&gt;len )
subat( i );
d-&gt;setDirty();
return d-&gt;unicode[i];
}
const TQChar* unicode() const { return d-&gt;unicode; }
const char* ascii() const;
static TQString fromAscii(const char*, int len=-1);
const char* latin1() const;
static TQString fromLatin1(const char*, int len=-1);
TQCString utf8() const;
static TQString fromUtf8(const char*, int len=-1);
TQCString local8Bit() const;
static TQString fromLocal8Bit(const char*, int len=-1);
bool operator!() const;
#ifndef TQT_NO_ASCII_CAST
operator const char *() const { return ascii(); }
#endif
#ifndef TQT_NO_STL
operator std::string() const { return ascii() ? ascii() : ""; }
#endif
static TQString fromUcs2( const unsigned short *ucs2 );
const unsigned short *ucs2() const;
TQString &amp;setUnicode( const TQChar* unicode, uint len );
TQString &amp;setUnicodeCodes( const ushort* unicode_as_ushorts, uint len );
TQString &amp;setAscii( const char*, int len=-1 );
TQString &amp;setLatin1( const char*, int len=-1 );
int compare( const TQString&amp; s ) const;
static int compare( const TQString&amp; s1, const TQString&amp; s2 )
{ return s1.compare( s2 ); }
int localeAwareCompare( const TQString&amp; s ) const;
static int localeAwareCompare( const TQString&amp; s1, const TQString&amp; s2 )
{ return s1.localeAwareCompare( s2 ); }
#ifndef TQT_NO_DATASTREAM
friend TQ_EXPORT TQDataStream &amp;operator&gt;&gt;( TQDataStream &amp;, TQString &amp; );
#endif
void compose();
#ifndef TQT_NO_COMPAT
const char* data() const { return ascii(); }
#endif
#if defined(Q_QDOC)
bool startsWith( const TQString&amp; str, bool cs = TRUE ) const;
bool endsWith( const TQString&amp; str, bool cs = TRUE ) const;
#else
// ### TQt 4.0: merge these two into one, and remove Q_QDOC hack
bool startsWith( const TQString&amp; str ) const;
bool startsWith( const TQString&amp; str, bool cs ) const;
// ### TQt 4.0: merge these two into one, and remove Q_QDOC hack
bool endsWith( const TQString&amp; str ) const;
bool endsWith( const TQString&amp; str, bool cs ) const;
#endif
void setLength( uint newLength );
uint capacity() const;
void reserve( uint minCapacity );
void squeeze();
bool simpleText() const { if ( !d-&gt;issimpletext ) checkSimpleText(); return (bool)d-&gt;issimpletext; }
bool isRightToLeft() const;
private:
TQString( int size, bool /* dummy */ ); // allocate size incl. \0
void deref();
void real_detach();
void subat( uint );
TQString multiArg( int numArgs, const TQString&amp; a1, const TQString&amp; a2,
const TQString&amp; a3 = TQString::null,
const TQString&amp; a4 = TQString::null ) const;
void checkSimpleText() const;
void grow( uint newLength );
#ifndef TQT_NO_CAST_ASCII
TQString &amp;insertHelper( uint index, const char *s, uint len=UINT_MAX );
TQString &amp;operatorPlusEqHelper( const char *s, uint len2=UINT_MAX );
#endif
static TQChar* latin1ToUnicode( const char*, uint * len, uint maxlen=(uint)-1 );
static TQChar* latin1ToUnicode( const TQByteArray&amp;, uint * len );
static char* unicodeToLatin1( const TQChar*, uint len );
TQStringData *d;
static TQStringData* shared_null;
static TQStringData* makeSharedNull();
friend class TQConstString;
friend class TQTextStream;
TQString( TQStringData* dd, bool /* dummy */ ) : d(dd) { }
// needed for TQDeepCopy
void detach();
friend class TQDeepCopy&lt;TQString&gt;;
};
class TQ_EXPORT TQCharRef {
friend class TQString;
TQString&amp; s;
uint p;
TQCharRef(TQString* str, uint pos) : s(*str), p(pos) { }
public:
// most TQChar operations repeated here
// all this is not documented: We just say "like TQChar" 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 TQChar cast constructors
TQCharRef operator=(char c ) { s.ref(p)=c; return *this; }
TQCharRef operator=(uchar c ) { s.ref(p)=c; return *this; }
TQCharRef operator=(TQChar c ) { s.ref(p)=c; return *this; }
TQCharRef operator=(const TQCharRef&amp; c ) { s.ref(p)=c.unicode(); return *this; }
TQCharRef operator=(ushort rc ) { s.ref(p)=rc; return *this; }
TQCharRef operator=(short rc ) { s.ref(p)=rc; return *this; }
TQCharRef operator=(uint rc ) { s.ref(p)=rc; return *this; }
TQCharRef operator=(int rc ) { s.ref(p)=rc; return *this; }
operator TQChar () 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(); }
TQChar lower() const { return s.constref(p).lower(); }
TQChar upper() const { return s.constref(p).upper(); }
TQChar::Category category() const { return s.constref(p).category(); }
TQChar::Direction direction() const { return s.constref(p).direction(); }
TQChar::Joining joining() const { return s.constref(p).joining(); }
bool mirrored() const { return s.constref(p).mirrored(); }
TQChar mirroredChar() const { return s.constref(p).mirroredChar(); }
const TQString &amp;decomposition() const { return s.constref(p).decomposition(); }
TQChar::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 TQCharRef TQString::at( uint i ) { return TQCharRef(this,i); }
inline TQCharRef TQString::operator[]( int i ) { return at((uint)i); }
class TQ_EXPORT TQConstString : private TQString {
public:
TQConstString( const TQChar* unicode, uint length );
~TQConstString();
const TQString&amp; string() const { return *this; }
};
/*****************************************************************************
TQString stream functions
*****************************************************************************/
#ifndef TQT_NO_DATASTREAM
TQ_EXPORT TQDataStream &amp;operator&lt;&lt;( TQDataStream &amp;, const TQString &amp; );
TQ_EXPORT TQDataStream &amp;operator&gt;&gt;( TQDataStream &amp;, TQString &amp; );
#endif
/*****************************************************************************
TQString 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 TQString::TQString() :
d(shared_null ? shared_null : makeSharedNull())
{
d-&gt;ref();
}
//
inline TQString::~TQString()
{
if ( d-&gt;deref() ) {
if ( d != shared_null )
d-&gt;deleteSelf();
}
}
// needed for TQDeepCopy
inline void TQString::detach()
{ real_detach(); }
inline TQString TQString::section( TQChar sep, int start, int end, int flags ) const
{ return section(TQString(sep), start, end, flags); }
inline TQString TQString::section( char sep, int start, int end, int flags ) const
{ return section(TQChar(sep), start, end, flags); }
#ifndef TQT_NO_CAST_ASCII
inline TQString TQString::section( const char *in_sep, int start, int end, int flags ) const
{ return section(TQString(in_sep), start, end, flags); }
#endif
inline TQString &amp;TQString::operator=( TQChar c )
{ *this = TQString(c); return *this; }
inline TQString &amp;TQString::operator=( char c )
{ *this = TQString(TQChar(c)); return *this; }
inline bool TQString::isNull() const
{ return unicode() == 0; }
inline bool TQString::operator!() const
{ return isNull(); }
inline uint TQString::length() const
{ return d-&gt;len; }
inline uint TQString::capacity() const
{ return d-&gt;maxl; }
inline bool TQString::isEmpty() const
{ return length() == 0; }
inline TQString TQString::copy() const
{ return TQString( *this ); }
#ifndef TQT_NO_CAST_ASCII
inline TQString &amp;TQString::insert( uint index, const char *s )
{ return insertHelper( index, s ); }
inline TQString &amp;TQString::insert( uint index, const TQByteArray &amp;s )
{
int pos = s.find( 0 );
return insertHelper( index, s, pos==-1 ? s.size() : pos );
}
#endif
inline TQString &amp;TQString::prepend( const TQString &amp; s )
{ return insert(0,s); }
inline TQString &amp;TQString::prepend( TQChar c )
{ return insert(0,c); }
inline TQString &amp;TQString::prepend( char c )
{ return insert(0,c); }
#ifndef TQT_NO_CAST_ASCII
inline TQString &amp;TQString::prepend( const TQByteArray &amp; s )
{ return insert(0,s); }
#endif
#ifndef TQT_NO_CAST_ASCII
inline TQString &amp;TQString::operator+=( const TQByteArray &amp;s )
{
int pos = s.find( 0 );
return operatorPlusEqHelper( s, pos==-1 ? s.size() : pos );
}
#endif
inline TQString &amp;TQString::append( const TQString &amp; s )
{ return operator+=(s); }
#ifndef TQT_NO_CAST_ASCII
inline TQString &amp;TQString::append( const TQByteArray &amp;s )
{ return operator+=(s); }
inline TQString &amp;TQString::append( const char * s )
{ return operator+=(s); }
#endif
inline TQString &amp;TQString::append( TQChar c )
{ return operator+=(c); }
inline TQString &amp;TQString::append( char c )
{ return operator+=(c); }
#ifndef TQT_NO_STL
inline TQString &amp;TQString::operator=( const std::string&amp; str )
{ return operator=(str.c_str()); }
#ifndef TQT_NO_CAST_ASCII
inline TQString &amp;TQString::operator+=( const std::string&amp; s )
{ return operator+=(s.c_str()); }
inline TQString &amp;TQString::append( const std::string&amp; s )
{ return operator+=(s); }
inline TQString &amp;TQString::prepend( const std::string&amp; s )
{ return insert(0, s); }
#endif
#endif
inline TQString &amp;TQString::setNum( short n, int base )
{ return setNum((TQ_LLONG)n, base); }
inline TQString &amp;TQString::setNum( ushort n, int base )
{ return setNum((TQ_ULLONG)n, base); }
inline TQString &amp;TQString::setNum( int n, int base )
{ return setNum((TQ_LLONG)n, base); }
inline TQString &amp;TQString::setNum( uint n, int base )
{ return setNum((TQ_ULLONG)n, base); }
inline TQString &amp;TQString::setNum( float n, char f, int prec )
{ return setNum((double)n,f,prec); }
inline TQString TQString::arg( int a, int fieldWidth, int base ) const
{ return arg( (TQ_LLONG)a, fieldWidth, base ); }
inline TQString TQString::arg( uint a, int fieldWidth, int base ) const
{ return arg( (TQ_ULLONG)a, fieldWidth, base ); }
inline TQString TQString::arg( short a, int fieldWidth, int base ) const
{ return arg( (TQ_LLONG)a, fieldWidth, base ); }
inline TQString TQString::arg( ushort a, int fieldWidth, int base ) const
{ return arg( (TQ_ULLONG)a, fieldWidth, base ); }
inline TQString TQString::arg( const TQString&amp; a1, const TQString&amp; a2 ) const {
return multiArg( 2, a1, a2 );
}
inline TQString TQString::arg( const TQString&amp; a1, const TQString&amp; a2,
const TQString&amp; a3 ) const {
return multiArg( 3, a1, a2, a3 );
}
inline TQString TQString::arg( const TQString&amp; a1, const TQString&amp; a2,
const TQString&amp; a3, const TQString&amp; a4 ) const {
return multiArg( 4, a1, a2, a3, a4 );
}
inline int TQString::find( char c, int index, bool cs ) const
{ return find(TQChar(c), index, cs); }
inline int TQString::findRev( char c, int index, bool cs ) const
{ return findRev( TQChar(c), index, cs ); }
#ifndef TQT_NO_CAST_ASCII
inline int TQString::find( const char* str, int index ) const
{ return find(TQString::fromAscii(str), index); }
inline int TQString::findRev( const char* str, int index ) const
{ return findRev(TQString::fromAscii(str), index); }
#endif
/*****************************************************************************
TQString non-member operators
*****************************************************************************/
TQ_EXPORT bool operator!=( const TQString &amp;s1, const TQString &amp;s2 );
TQ_EXPORT bool operator&lt;( const TQString &amp;s1, const TQString &amp;s2 );
TQ_EXPORT bool operator&lt;=( const TQString &amp;s1, const TQString &amp;s2 );
TQ_EXPORT bool operator==( const TQString &amp;s1, const TQString &amp;s2 );
TQ_EXPORT bool operator&gt;( const TQString &amp;s1, const TQString &amp;s2 );
TQ_EXPORT bool operator&gt;=( const TQString &amp;s1, const TQString &amp;s2 );
#ifndef TQT_NO_CAST_ASCII
TQ_EXPORT bool operator!=( const TQString &amp;s1, const char *s2 );
TQ_EXPORT bool operator&lt;( const TQString &amp;s1, const char *s2 );
TQ_EXPORT bool operator&lt;=( const TQString &amp;s1, const char *s2 );
TQ_EXPORT bool operator==( const TQString &amp;s1, const char *s2 );
TQ_EXPORT bool operator&gt;( const TQString &amp;s1, const char *s2 );
TQ_EXPORT bool operator&gt;=( const TQString &amp;s1, const char *s2 );
TQ_EXPORT bool operator!=( const char *s1, const TQString &amp;s2 );
TQ_EXPORT bool operator&lt;( const char *s1, const TQString &amp;s2 );
TQ_EXPORT bool operator&lt;=( const char *s1, const TQString &amp;s2 );
TQ_EXPORT bool operator==( const char *s1, const TQString &amp;s2 );
//TQ_EXPORT bool operator&gt;( const char *s1, const TQString &amp;s2 ); // MSVC++
TQ_EXPORT bool operator&gt;=( const char *s1, const TQString &amp;s2 );
#endif
TQ_EXPORT inline const TQString operator+( const TQString &amp;s1, const TQString &amp;s2 )
{
TQString tmp( s1 );
tmp += s2;
return tmp;
}
#ifndef TQT_NO_CAST_ASCII
TQ_EXPORT inline const TQString operator+( const TQString &amp;s1, const char *s2 )
{
TQString tmp( s1 );
tmp += TQString::fromAscii(s2);
return tmp;
}
TQ_EXPORT inline const TQString operator+( const char *s1, const TQString &amp;s2 )
{
TQString tmp = TQString::fromAscii( s1 );
tmp += s2;
return tmp;
}
#endif
TQ_EXPORT inline const TQString operator+( const TQString &amp;s1, TQChar c2 )
{
TQString tmp( s1 );
tmp += c2;
return tmp;
}
TQ_EXPORT inline const TQString operator+( const TQString &amp;s1, char c2 )
{
TQString tmp( s1 );
tmp += c2;
return tmp;
}
TQ_EXPORT inline const TQString operator+( TQChar c1, const TQString &amp;s2 )
{
TQString tmp;
tmp += c1;
tmp += s2;
return tmp;
}
TQ_EXPORT inline const TQString operator+( char c1, const TQString &amp;s2 )
{
TQString tmp;
tmp += c1;
tmp += s2;
return tmp;
}
#ifndef TQT_NO_STL
TQ_EXPORT inline const TQString operator+(const TQString&amp; s1, const std::string&amp; s2)
{
return s1 + TQString(s2);
}
TQ_EXPORT inline const TQString operator+(const std::string&amp; s1, const TQString&amp; s2)
{
TQString tmp(s2);
return TQString(tmp.prepend(s1));
}
#endif
#if defined(Q_OS_WIN32)
extern TQ_EXPORT TQString qt_winTQString(void*);
extern TQ_EXPORT const void* qt_winTchar(const TQString&amp; str, bool addnul);
extern TQ_EXPORT void* qt_winTchar_new(const TQString&amp; str);
extern TQ_EXPORT TQCString qt_winTQString2MB( const TQString&amp; s, int len=-1 );
extern TQ_EXPORT TQString qt_winMB2TQString( const char* mb, int len=-1 );
#endif
#define Q_DEFINED_QSTRING
#include "tqwinexport.h"
#endif // TQSTRING_H
</pre>
<!-- eof -->
<p><address><hr><div align=center>
<table width=100% cellspacing=0 border=0><tr>
<td>Copyright &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>TQt 3.3.8</div>
</table></div></address></body>
</html>