diff options
Diffstat (limited to 'doc/html/qstring.html')
| -rw-r--r-- | doc/html/qstring.html | 2440 |
1 files changed, 0 insertions, 2440 deletions
diff --git a/doc/html/qstring.html b/doc/html/qstring.html deleted file mode 100644 index c6e26866f..000000000 --- a/doc/html/qstring.html +++ /dev/null @@ -1,2440 +0,0 @@ -<!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/src/tools/qstring.cpp:1228 --> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> -<title>TQString Class</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>TQString Class Reference</h1> - -<p>The TQString class provides an abstraction of Unicode text -and the classic C '\0'-terminated char array. -<a href="#details">More...</a> -<p>All the functions in this class are <a href="threads.html#reentrant">reentrant</a> when TQt is built with thread support.</p> -<p><tt>#include <<a href="qstring-h.html">qstring.h</a>></tt> -<p><a href="qstring-members.html">List of all member functions.</a> -<h2>Public Members</h2> -<ul> -<li class=fn><a href="#TQString"><b>TQString</b></a> ()</li> -<li class=fn><a href="#TQString-2"><b>TQString</b></a> ( TQChar ch )</li> -<li class=fn><a href="#TQString-3"><b>TQString</b></a> ( const TQString & s )</li> -<li class=fn><a href="#TQString-4"><b>TQString</b></a> ( const TQByteArray & ba )</li> -<li class=fn><a href="#TQString-5"><b>TQString</b></a> ( const TQChar * unicode, uint length )</li> -<li class=fn><a href="#TQString-6"><b>TQString</b></a> ( const char * str )</li> -<li class=fn><a href="#TQString-7"><b>TQString</b></a> ( const std::string & str )</li> -<li class=fn><a href="#~TQString"><b>~TQString</b></a> ()</li> -<li class=fn>TQString & <a href="#operator-eq-2"><b>operator=</b></a> ( const TQString & s )</li> -<li class=fn>TQString & <a href="#operator-eq-3"><b>operator=</b></a> ( const char * str )</li> -<li class=fn>TQString & <a href="#operator-eq-4"><b>operator=</b></a> ( const std::string & s )</li> -<li class=fn>TQString & <a href="#operator-eq-5"><b>operator=</b></a> ( const TQCString & cstr )</li> -<li class=fn>TQString & <a href="#operator-eq"><b>operator=</b></a> ( TQChar c )</li> -<li class=fn>TQString & <a href="#operator-eq-6"><b>operator=</b></a> ( char c )</li> -<li class=fn>bool <a href="#isNull"><b>isNull</b></a> () const</li> -<li class=fn>bool <a href="#isEmpty"><b>isEmpty</b></a> () const</li> -<li class=fn>uint <a href="#length"><b>length</b></a> () const</li> -<li class=fn>void <a href="#truncate"><b>truncate</b></a> ( uint newLen )</li> -<li class=fn>TQString & <a href="#fill"><b>fill</b></a> ( TQChar c, int len = -1 )</li> -<li class=fn>TQString copy () const <em>(obsolete)</em></li> -<li class=fn>TQString <a href="#arg-2"><b>arg</b></a> ( long a, int fieldWidth = 0, int base = 10 ) const</li> -<li class=fn>TQString <a href="#arg-3"><b>arg</b></a> ( ulong a, int fieldWidth = 0, int base = 10 ) const</li> -<li class=fn>TQString <a href="#arg-4"><b>arg</b></a> ( Q_LLONG a, int fieldWidth = 0, int base = 10 ) const</li> -<li class=fn>TQString <a href="#arg-5"><b>arg</b></a> ( Q_ULLONG a, int fieldWidth = 0, int base = 10 ) const</li> -<li class=fn>TQString <a href="#arg-6"><b>arg</b></a> ( int a, int fieldWidth = 0, int base = 10 ) const</li> -<li class=fn>TQString <a href="#arg-7"><b>arg</b></a> ( uint a, int fieldWidth = 0, int base = 10 ) const</li> -<li class=fn>TQString <a href="#arg-8"><b>arg</b></a> ( short a, int fieldWidth = 0, int base = 10 ) const</li> -<li class=fn>TQString <a href="#arg-9"><b>arg</b></a> ( ushort a, int fieldWidth = 0, int base = 10 ) const</li> -<li class=fn>TQString <a href="#arg-a"><b>arg</b></a> ( double a, int fieldWidth = 0, char fmt = 'g', int prec = -1 ) const</li> -<li class=fn>TQString <a href="#arg-b"><b>arg</b></a> ( char a, int fieldWidth = 0 ) const</li> -<li class=fn>TQString <a href="#arg-c"><b>arg</b></a> ( TQChar a, int fieldWidth = 0 ) const</li> -<li class=fn>TQString <a href="#arg"><b>arg</b></a> ( const TQString & a, int fieldWidth = 0 ) const</li> -<li class=fn>TQString <a href="#arg-d"><b>arg</b></a> ( const TQString & a1, const TQString & a2 ) const</li> -<li class=fn>TQString <a href="#arg-e"><b>arg</b></a> ( const TQString & a1, const TQString & a2, const TQString & a3 ) const</li> -<li class=fn>TQString <a href="#arg-f"><b>arg</b></a> ( const TQString & a1, const TQString & a2, const TQString & a3, const TQString & a4 ) const</li> -<li class=fn>TQString & <a href="#sprintf"><b>sprintf</b></a> ( const char * cformat, ... )</li> -<li class=fn>int <a href="#find-2"><b>find</b></a> ( TQChar c, int index = 0, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#find-3"><b>find</b></a> ( char c, int index = 0, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#find-4"><b>find</b></a> ( const TQString & str, int index = 0, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#find"><b>find</b></a> ( const TQRegExp & rx, int index = 0 ) const</li> -<li class=fn>int <a href="#find-5"><b>find</b></a> ( const char * str, int index = 0 ) const</li> -<li class=fn>int <a href="#findRev-2"><b>findRev</b></a> ( TQChar c, int index = -1, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#findRev-3"><b>findRev</b></a> ( char c, int index = -1, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#findRev-4"><b>findRev</b></a> ( const TQString & str, int index = -1, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#findRev-5"><b>findRev</b></a> ( const TQRegExp & rx, int index = -1 ) const</li> -<li class=fn>int <a href="#findRev"><b>findRev</b></a> ( const char * str, int index = -1 ) const</li> -<li class=fn>int <a href="#contains"><b>contains</b></a> ( TQChar c, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#contains-2"><b>contains</b></a> ( char c, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#contains-3"><b>contains</b></a> ( const char * str, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#contains-4"><b>contains</b></a> ( const TQString & str, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#contains-5"><b>contains</b></a> ( const TQRegExp & rx ) const</li> -<li class=fn>enum <a href="#SectionFlags-enum"><b>SectionFlags</b></a> { SectionDefault = 0x00, SectionSkipEmpty = 0x01, SectionIncludeLeadingSep = 0x02, SectionIncludeTrailingSep = 0x04, SectionCaseInsensitiveSeps = 0x08 }</li> -<li class=fn>TQString <a href="#section"><b>section</b></a> ( TQChar sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li> -<li class=fn>TQString <a href="#section-2"><b>section</b></a> ( char sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li> -<li class=fn>TQString <a href="#section-3"><b>section</b></a> ( const char * sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li> -<li class=fn>TQString <a href="#section-4"><b>section</b></a> ( const TQString & sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li> -<li class=fn>TQString <a href="#section-5"><b>section</b></a> ( const TQRegExp & reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li> -<li class=fn>TQString <a href="#left"><b>left</b></a> ( uint len ) const</li> -<li class=fn>TQString <a href="#right"><b>right</b></a> ( uint len ) const</li> -<li class=fn>TQString <a href="#mid"><b>mid</b></a> ( uint index, uint len = 0xffffffff ) const</li> -<li class=fn>TQString <a href="#leftJustify"><b>leftJustify</b></a> ( uint width, TQChar fill = ' ', bool truncate = FALSE ) const</li> -<li class=fn>TQString <a href="#rightJustify"><b>rightJustify</b></a> ( uint width, TQChar fill = ' ', bool truncate = FALSE ) const</li> -<li class=fn>TQString <a href="#lower"><b>lower</b></a> () const</li> -<li class=fn>TQString <a href="#upper"><b>upper</b></a> () const</li> -<li class=fn>TQString <a href="#stripWhiteSpace"><b>stripWhiteSpace</b></a> () const</li> -<li class=fn>TQString <a href="#simplifyWhiteSpace"><b>simplifyWhiteSpace</b></a> () const</li> -<li class=fn>TQString & <a href="#insert"><b>insert</b></a> ( uint index, const TQString & s )</li> -<li class=fn>TQString & <a href="#insert-2"><b>insert</b></a> ( uint index, const TQByteArray & s )</li> -<li class=fn>TQString & <a href="#insert-3"><b>insert</b></a> ( uint index, const char * s )</li> -<li class=fn>TQString & <a href="#insert-4"><b>insert</b></a> ( uint index, const TQChar * s, uint len )</li> -<li class=fn>TQString & <a href="#insert-5"><b>insert</b></a> ( uint index, TQChar c )</li> -<li class=fn>TQString & <a href="#insert-6"><b>insert</b></a> ( uint index, char c )</li> -<li class=fn>TQString & <a href="#append-2"><b>append</b></a> ( char ch )</li> -<li class=fn>TQString & <a href="#append-3"><b>append</b></a> ( TQChar ch )</li> -<li class=fn>TQString & <a href="#append"><b>append</b></a> ( const TQString & str )</li> -<li class=fn>TQString & <a href="#append-4"><b>append</b></a> ( const TQByteArray & str )</li> -<li class=fn>TQString & <a href="#append-5"><b>append</b></a> ( const char * str )</li> -<li class=fn>TQString & <a href="#append-6"><b>append</b></a> ( const std::string & str )</li> -<li class=fn>TQString & <a href="#prepend-2"><b>prepend</b></a> ( char ch )</li> -<li class=fn>TQString & <a href="#prepend-3"><b>prepend</b></a> ( TQChar ch )</li> -<li class=fn>TQString & <a href="#prepend"><b>prepend</b></a> ( const TQString & s )</li> -<li class=fn>TQString & <a href="#prepend-4"><b>prepend</b></a> ( const TQByteArray & s )</li> -<li class=fn>TQString & <a href="#prepend-5"><b>prepend</b></a> ( const char * s )</li> -<li class=fn>TQString & <a href="#prepend-6"><b>prepend</b></a> ( const std::string & s )</li> -<li class=fn>TQString & <a href="#remove"><b>remove</b></a> ( uint index, uint len )</li> -<li class=fn>TQString & <a href="#remove-2"><b>remove</b></a> ( const TQString & str, bool cs = TRUE )</li> -<li class=fn>TQString & <a href="#remove-3"><b>remove</b></a> ( TQChar c )</li> -<li class=fn>TQString & <a href="#remove-4"><b>remove</b></a> ( char c )</li> -<li class=fn>TQString & <a href="#remove-5"><b>remove</b></a> ( const char * str )</li> -<li class=fn>TQString & <a href="#remove-6"><b>remove</b></a> ( const TQRegExp & rx )</li> -<li class=fn>TQString & <a href="#replace"><b>replace</b></a> ( uint index, uint len, const TQString & s )</li> -<li class=fn>TQString & <a href="#replace-2"><b>replace</b></a> ( uint index, uint len, const TQChar * s, uint slen )</li> -<li class=fn>TQString & <a href="#replace-3"><b>replace</b></a> ( uint index, uint len, TQChar c )</li> -<li class=fn>TQString & <a href="#replace-4"><b>replace</b></a> ( uint index, uint len, char c )</li> -<li class=fn>TQString & <a href="#replace-5"><b>replace</b></a> ( TQChar c, const TQString & after, bool cs = TRUE )</li> -<li class=fn>TQString & <a href="#replace-6"><b>replace</b></a> ( char c, const TQString & after, bool cs = TRUE )</li> -<li class=fn>TQString & <a href="#replace-7"><b>replace</b></a> ( const TQString & before, const TQString & after, bool cs = TRUE )</li> -<li class=fn>TQString & <a href="#replace-8"><b>replace</b></a> ( const TQRegExp & rx, const TQString & after )</li> -<li class=fn>TQString & <a href="#replace-9"><b>replace</b></a> ( TQChar c1, TQChar c2 )</li> -<li class=fn>short <a href="#toShort"><b>toShort</b></a> ( bool * ok = 0, int base = 10 ) const</li> -<li class=fn>ushort <a href="#toUShort"><b>toUShort</b></a> ( bool * ok = 0, int base = 10 ) const</li> -<li class=fn>int <a href="#toInt"><b>toInt</b></a> ( bool * ok = 0, int base = 10 ) const</li> -<li class=fn>uint <a href="#toUInt"><b>toUInt</b></a> ( bool * ok = 0, int base = 10 ) const</li> -<li class=fn>long <a href="#toLong"><b>toLong</b></a> ( bool * ok = 0, int base = 10 ) const</li> -<li class=fn>ulong <a href="#toULong"><b>toULong</b></a> ( bool * ok = 0, int base = 10 ) const</li> -<li class=fn>Q_LLONG <a href="#toLongLong"><b>toLongLong</b></a> ( bool * ok = 0, int base = 10 ) const</li> -<li class=fn>Q_ULLONG <a href="#toULongLong"><b>toULongLong</b></a> ( bool * ok = 0, int base = 10 ) const</li> -<li class=fn>float <a href="#toFloat"><b>toFloat</b></a> ( bool * ok = 0 ) const</li> -<li class=fn>double <a href="#toDouble"><b>toDouble</b></a> ( bool * ok = 0 ) const</li> -<li class=fn>TQString & <a href="#setNum-2"><b>setNum</b></a> ( short n, int base = 10 )</li> -<li class=fn>TQString & <a href="#setNum-3"><b>setNum</b></a> ( ushort n, int base = 10 )</li> -<li class=fn>TQString & <a href="#setNum-4"><b>setNum</b></a> ( int n, int base = 10 )</li> -<li class=fn>TQString & <a href="#setNum-5"><b>setNum</b></a> ( uint n, int base = 10 )</li> -<li class=fn>TQString & <a href="#setNum-6"><b>setNum</b></a> ( long n, int base = 10 )</li> -<li class=fn>TQString & <a href="#setNum-7"><b>setNum</b></a> ( ulong n, int base = 10 )</li> -<li class=fn>TQString & <a href="#setNum"><b>setNum</b></a> ( Q_LLONG n, int base = 10 )</li> -<li class=fn>TQString & <a href="#setNum-8"><b>setNum</b></a> ( Q_ULLONG n, int base = 10 )</li> -<li class=fn>TQString & <a href="#setNum-9"><b>setNum</b></a> ( float n, char f = 'g', int prec = 6 )</li> -<li class=fn>TQString & <a href="#setNum-a"><b>setNum</b></a> ( double n, char f = 'g', int prec = 6 )</li> -<li class=fn>void setExpand ( uint index, TQChar c ) <em>(obsolete)</em></li> -<li class=fn>TQString & <a href="#operator+-eq"><b>operator+=</b></a> ( const TQString & str )</li> -<li class=fn>TQString & <a href="#operator+-eq-2"><b>operator+=</b></a> ( const TQByteArray & str )</li> -<li class=fn>TQString & <a href="#operator+-eq-3"><b>operator+=</b></a> ( const char * str )</li> -<li class=fn>TQString & <a href="#operator+-eq-4"><b>operator+=</b></a> ( const std::string & str )</li> -<li class=fn>TQString & <a href="#operator+-eq-5"><b>operator+=</b></a> ( TQChar c )</li> -<li class=fn>TQString & <a href="#operator+-eq-6"><b>operator+=</b></a> ( char c )</li> -<li class=fn>TQChar <a href="#at"><b>at</b></a> ( uint i ) const</li> -<li class=fn>TQChar <a href="#operator[]"><b>operator[]</b></a> ( int i ) const</li> -<li class=fn>TQCharRef <a href="#at-2"><b>at</b></a> ( uint i )</li> -<li class=fn>TQCharRef <a href="#operator[]-2"><b>operator[]</b></a> ( int i )</li> -<li class=fn>TQChar <a href="#constref"><b>constref</b></a> ( uint i ) const</li> -<li class=fn>TQChar & <a href="#ref"><b>ref</b></a> ( uint i )</li> -<li class=fn>const TQChar * <a href="#unicode"><b>unicode</b></a> () const</li> -<li class=fn>const char * <a href="#ascii"><b>ascii</b></a> () const</li> -<li class=fn>const char * <a href="#latin1"><b>latin1</b></a> () const</li> -<li class=fn>TQCString <a href="#utf8"><b>utf8</b></a> () const</li> -<li class=fn>TQCString <a href="#local8Bit"><b>local8Bit</b></a> () const</li> -<li class=fn>bool <a href="#operator!"><b>operator!</b></a> () const</li> -<li class=fn><a href="#operator-const-char-*"><b>operator const char *</b></a> () const</li> -<li class=fn><a href="#operator-std::string"><b>operator std::string</b></a> () const</li> -<li class=fn>const unsigned short * <a href="#ucs2"><b>ucs2</b></a> () const</li> -<li class=fn>TQString & <a href="#setUnicode"><b>setUnicode</b></a> ( const TQChar * unicode, uint len )</li> -<li class=fn>TQString & <a href="#setUnicodeCodes"><b>setUnicodeCodes</b></a> ( const ushort * unicode_as_ushorts, uint len )</li> -<li class=fn>TQString & <a href="#setAscii"><b>setAscii</b></a> ( const char * str, int len = -1 )</li> -<li class=fn>TQString & <a href="#setLatin1"><b>setLatin1</b></a> ( const char * str, int len = -1 )</li> -<li class=fn>int <a href="#compare-2"><b>compare</b></a> ( const TQString & s ) const</li> -<li class=fn>int <a href="#localeAwareCompare-2"><b>localeAwareCompare</b></a> ( const TQString & s ) const</li> -<li class=fn>void <a href="#compose"><b>compose</b></a> ()</li> -<li class=fn>const char * data () const <em>(obsolete)</em></li> -<li class=fn>bool <a href="#startsWith"><b>startsWith</b></a> ( const TQString & s, bool cs = TRUE ) const</li> -<li class=fn>bool <a href="#endsWith"><b>endsWith</b></a> ( const TQString & s, bool cs = TRUE ) const</li> -<li class=fn>void <a href="#setLength"><b>setLength</b></a> ( uint newLen )</li> -<li class=fn>uint <a href="#capacity"><b>capacity</b></a> () const</li> -<li class=fn>void <a href="#reserve"><b>reserve</b></a> ( uint minCapacity )</li> -<li class=fn>void <a href="#squeeze"><b>squeeze</b></a> ()</li> -</ul> -<h2>Static Public Members</h2> -<ul> -<li class=fn>TQString <a href="#number"><b>number</b></a> ( long n, int base = 10 )</li> -<li class=fn>TQString <a href="#number-2"><b>number</b></a> ( ulong n, int base = 10 )</li> -<li class=fn>TQString <a href="#number-3"><b>number</b></a> ( Q_LLONG n, int base = 10 )</li> -<li class=fn>TQString <a href="#number-4"><b>number</b></a> ( Q_ULLONG n, int base = 10 )</li> -<li class=fn>TQString <a href="#number-5"><b>number</b></a> ( int n, int base = 10 )</li> -<li class=fn>TQString <a href="#number-6"><b>number</b></a> ( uint n, int base = 10 )</li> -<li class=fn>TQString <a href="#number-7"><b>number</b></a> ( double n, char f = 'g', int prec = 6 )</li> -<li class=fn>TQString <a href="#fromAscii"><b>fromAscii</b></a> ( const char * ascii, int len = -1 )</li> -<li class=fn>TQString <a href="#fromLatin1"><b>fromLatin1</b></a> ( const char * chars, int len = -1 )</li> -<li class=fn>TQString <a href="#fromUtf8"><b>fromUtf8</b></a> ( const char * utf8, int len = -1 )</li> -<li class=fn>TQString <a href="#fromLocal8Bit"><b>fromLocal8Bit</b></a> ( const char * local8Bit, int len = -1 )</li> -<li class=fn>TQString <a href="#fromUcs2"><b>fromUcs2</b></a> ( const unsigned short * str )</li> -<li class=fn>int <a href="#compare"><b>compare</b></a> ( const TQString & s1, const TQString & s2 )</li> -<li class=fn>int <a href="#localeAwareCompare"><b>localeAwareCompare</b></a> ( const TQString & s1, const TQString & s2 )</li> -</ul> -<h2>Related Functions</h2> -<ul> -<li class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const TQString & s1, const TQString & s2 )</li> -<li class=fn>bool <a href="#operator-eq-eq-2"><b>operator==</b></a> ( const TQString & s1, const char * s2 )</li> -<li class=fn>bool <a href="#operator-eq-eq-3"><b>operator==</b></a> ( const char * s1, const TQString & s2 )</li> -<li class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const TQString & s1, const TQString & s2 )</li> -<li class=fn>bool <a href="#operator!-eq-2"><b>operator!=</b></a> ( const TQString & s1, const char * s2 )</li> -<li class=fn>bool <a href="#operator!-eq-3"><b>operator!=</b></a> ( const char * s1, const TQString & s2 )</li> -<li class=fn>bool <a href="#operator-lt"><b>operator<</b></a> ( const TQString & s1, const char * s2 )</li> -<li class=fn>bool <a href="#operator-lt-2"><b>operator<</b></a> ( const char * s1, const TQString & s2 )</li> -<li class=fn>bool <a href="#operator-lt-eq"><b>operator<=</b></a> ( const TQString & s1, const char * s2 )</li> -<li class=fn>bool <a href="#operator-lt-eq-2"><b>operator<=</b></a> ( const char * s1, const TQString & s2 )</li> -<li class=fn>bool <a href="#operator-gt"><b>operator></b></a> ( const TQString & s1, const char * s2 )</li> -<li class=fn>bool <a href="#operator-gt-2"><b>operator></b></a> ( const char * s1, const TQString & s2 )</li> -<li class=fn>bool <a href="#operator-gt-eq"><b>operator>=</b></a> ( const TQString & s1, const char * s2 )</li> -<li class=fn>bool <a href="#operator-gt-eq-2"><b>operator>=</b></a> ( const char * s1, const TQString & s2 )</li> -<li class=fn>const TQString <a href="#operator+"><b>operator+</b></a> ( const TQString & s1, const TQString & s2 )</li> -<li class=fn>const TQString <a href="#operator+-2"><b>operator+</b></a> ( const TQString & s1, const char * s2 )</li> -<li class=fn>const TQString <a href="#operator+-3"><b>operator+</b></a> ( const char * s1, const TQString & s2 )</li> -<li class=fn>const TQString <a href="#operator+-4"><b>operator+</b></a> ( const TQString & s, char c )</li> -<li class=fn>const TQString <a href="#operator+-5"><b>operator+</b></a> ( char c, const TQString & s )</li> -<li class=fn>TQDataStream & <a href="#operator-lt-lt"><b>operator<<</b></a> ( TQDataStream & s, const TQString & str )</li> -<li class=fn>TQDataStream & <a href="#operator-gt-gt"><b>operator>></b></a> ( TQDataStream & s, TQString & str )</li> -</ul> -<hr><a name="details"></a><h2>Detailed Description</h2> - - - -<p> The TQString class provides an abstraction of Unicode text -and the classic C '\0'-terminated char array. -<p> - - - -<p> TQString uses <a href="shclass.html">implicit sharing</a>, which -makes it very efficient and easy to use. -<p> In all of the TQString methods that take <tt>const char *</tt> -parameters, the <tt>const char *</tt> is interpreted as a classic -C-style '\0'-terminated ASCII string. It is legal for the <tt>const char *</tt> parameter to be 0. If the <tt>const char *</tt> is not -'\0'-terminated, the results are undefined. Functions that copy -classic C strings into a TQString will not copy the terminating -'\0' character. The <a href="qchar.html">TQChar</a> array of the TQString (as returned by -<a href="#unicode">unicode</a>()) is generally not terminated by a '\0'. If you need to -pass a TQString to a function that requires a C '\0'-terminated -string use <a href="#latin1">latin1</a>(). -<p> <!-- index TQString::null --><a name="TQString-null"></a>A TQString that has not been assigned to anything is <em>null</em>, i.e. -both the length and data pointer is 0. A TQString that references -the empty string ("", a single '\0' char) is <em>empty</em>. Both null -and empty TQStrings are legal parameters to the methods. Assigning -<tt>(const char *) 0</tt> to TQString gives a null TQString. For -convenience, <a href="qstring.html#TQString-null">TQString::null</a> is a null TQString. When sorting, -empty strings come first, followed by non-empty strings, followed -by null strings. We recommend using <tt>if ( !str.isNull() )</tt> to -check for a non-null string rather than <tt>if ( !str )</tt>; see <a href="#operator!">operator!</a>() for an explanation. -<p> Note that if you find that you are mixing usage of <a href="qcstring.html">TQCString</a>, -TQString, and <a href="qbytearray.html">TQByteArray</a>, this causes lots of unnecessary -copying and might indicate that the true nature of the data you -are dealing with is uncertain. If the data is '\0'-terminated 8-bit -data, use <a href="qcstring.html">TQCString</a>; if it is unterminated (i.e. contains '\0's) -8-bit data, use <a href="qbytearray.html">TQByteArray</a>; if it is text, use TQString. -<p> Lists of strings are handled by the <a href="qstringlist.html">TQStringList</a> class. You can -split a string into a list of strings using <a href="qstringlist.html#split">TQStringList::split</a>(), -and join a list of strings into a single string with an optional -separator using <a href="qstringlist.html#join">TQStringList::join</a>(). You can obtain a list of -strings from a string list that contain a particular substring or -that match a particular <a href="qregexp.html">regex</a> using -<a href="qstringlist.html#grep">TQStringList::grep</a>(). -<p> <b>Note for C programmers</b> -<p> Due to C++'s type system and the fact that TQString is <a href="shclass.html#implicitly-shared">implicitly shared</a>, TQStrings can be treated like ints or other simple base -types. For example: -<p> <pre> - TQString boolToString( bool b ) - { - TQString result; - if ( b ) - result = "True"; - else - result = "False"; - return result; - } - </pre> - -<p> The variable, result, is an auto variable allocated on the stack. -When return is called, because we're returning by value, The copy -constructor is called and a copy of the string is returned. (No -actual copying takes place thanks to the <a href="shclass.html#implicit-sharing">implicit sharing</a>, see -below.) -<p> Throughout TQt's source code you will encounter TQString usages like -this: -<pre> - TQString func( const TQString& input ) - { - TQString output = input; - // process output - return output; - } - </pre> - -<p> The 'copying' of input to output is almost as fast as copying a -pointer because behind the scenes copying is achieved by -incrementing a reference count. TQString (like all TQt's implicitly -shared classes) operates on a copy-on-write basis, only copying if -an instance is actually changed. -<p> If you wish to create a <a href="shclass.html#deep-copy">deep copy</a> of a TQString without losing any -Unicode information then you should use <a href="qdeepcopy.html">TQDeepCopy</a>. -<p> <p>See also <a href="qchar.html">TQChar</a>, <a href="qcstring.html">TQCString</a>, <a href="qbytearray.html">TQByteArray</a>, <a href="qconststring.html">TQConstString</a>, <a href="shared.html">Implicitly and Explicitly Shared Classes</a>, <a href="text.html">Text Related Classes</a>, and <a href="tools.html">Non-GUI Classes</a>. - -<hr><h2>Member Type Documentation</h2> -<h3 class=fn><a name="SectionFlags-enum"></a>TQString::SectionFlags</h3> - -<ul> -<li><tt>TQString::SectionDefault</tt> - Empty fields are counted, leading and -trailing separators are not included, and the separator is -compared case sensitively. -<li><tt>TQString::SectionSkipEmpty</tt> - Treat empty fields as if they don't exist, -i.e. they are not considered as far as <em>start</em> and <em>end</em> are -concerned. -<li><tt>TQString::SectionIncludeLeadingSep</tt> - Include the leading separator (if -any) in the result string. -<li><tt>TQString::SectionIncludeTrailingSep</tt> - Include the trailing separator -(if any) in the result string. -<li><tt>TQString::SectionCaseInsensitiveSeps</tt> - Compare the separator -case-insensitively. -</ul><p> Any of the last four values can be OR-ed together to form a flag. -<p> <p>See also <a href="#section">section</a>(). - -<hr><h2>Member Function Documentation</h2> -<h3 class=fn><a name="TQString"></a>TQString::TQString () -</h3> - -<p> Constructs a null string, i.e. both the length and data pointer -are 0. -<p> <p>See also <a href="#isNull">isNull</a>(). - -<h3 class=fn><a name="TQString-2"></a>TQString::TQString ( <a href="qchar.html">TQChar</a> ch ) -</h3> -Constructs a string of length one, containing the character <em>ch</em>. - -<h3 class=fn><a name="TQString-3"></a>TQString::TQString ( const <a href="qstring.html">TQString</a> & s ) -</h3> -Constructs an <a href="shclass.html#implicitly-shared">implicitly shared</a> copy of <em>s</em>. This is very fast -since it only involves incrementing a reference count. - -<h3 class=fn><a name="TQString-4"></a>TQString::TQString ( const <a href="qbytearray.html">TQByteArray</a> & ba ) -</h3> -Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of <em>ba</em> interpreted as a -classic C string. - -<h3 class=fn><a name="TQString-5"></a>TQString::TQString ( const <a href="qchar.html">TQChar</a> * unicode, uint length ) -</h3> -Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of the first <em>length</em> -characters in the <a href="qchar.html">TQChar</a> array. -<p> If <em>unicode</em> and <em>length</em> are 0, then a null string is created. -<p> If only <em>unicode</em> is 0, the string is empty but has <em>length</em> -characters of space preallocated: TQString expands automatically -anyway, but this may speed up some cases a little. We recommend -using the plain constructor and <a href="#setLength">setLength</a>() for this purpose since -it will result in more readable code. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#setLength">setLength</a>(). - -<h3 class=fn><a name="TQString-6"></a>TQString::TQString ( const char * str ) -</h3> -Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of <em>str</em>, interpreted as -a classic C string. The encoding is assumed to be Latin-1, unless -you change it using <a href="qtextcodec.html#setCodecForCStrings">TQTextCodec::setCodecForCStrings</a>(). -<p> If <em>str</em> is 0, then a null string is created. -<p> This is a cast constructor, but it is perfectly safe: converting a -Latin-1 <tt>const char *</tt> to TQString preserves all the information. You -can disable this constructor by defining <tt>QT_NO_CAST_ASCII</tt> when -you compile your applications. You can also make TQString objects -by using <a href="#setLatin1">setLatin1</a>(), <a href="#fromLatin1">fromLatin1</a>(), <a href="#fromLocal8Bit">fromLocal8Bit</a>(), and -<a href="#fromUtf8">fromUtf8</a>(). Or whatever encoding is appropriate for the 8-bit data -you have. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#fromAscii">fromAscii</a>(). - -<h3 class=fn><a name="TQString-7"></a>TQString::TQString ( const std::string & str ) -</h3> -Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of <em>str</em>. -<p> This is the same as <a href="#fromAscii">fromAscii</a>(<em>str</em>). - -<h3 class=fn><a name="~TQString"></a>TQString::~TQString () -</h3> - -<p> Destroys the string and frees the string's data if this is the -last reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="append"></a>TQString::append ( const <a href="qstring.html">TQString</a> & str ) -</h3> - -<p> Appends <em>str</em> to the string and returns a reference to the -result. -<p> <pre> - string = "Test"; - string.append( "ing" ); // string == "Testing" - </pre> - -<p> Equivalent to <a href="#operator+-eq">operator+=</a>(). - -<p>Example: <a href="dirview-example.html#x1701">dirview/dirview.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="append-2"></a>TQString::append ( char ch ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends character <em>ch</em> to the string and returns a reference to -the result. -<p> Equivalent to <a href="#operator+-eq">operator+=</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="append-3"></a>TQString::append ( <a href="qchar.html">TQChar</a> ch ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends character <em>ch</em> to the string and returns a reference to -the result. -<p> Equivalent to <a href="#operator+-eq">operator+=</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="append-4"></a>TQString::append ( const <a href="qbytearray.html">TQByteArray</a> & str ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends <em>str</em> to the string and returns a reference to the result. -<p> Equivalent to <a href="#operator+-eq">operator+=</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="append-5"></a>TQString::append ( const char * str ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends <em>str</em> to the string and returns a reference to the result. -<p> Equivalent to <a href="#operator+-eq">operator+=</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="append-6"></a>TQString::append ( const std::string & str ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends <em>str</em> to the string and returns a reference to the result. -<p> Equivalent to <a href="#operator+-eq">operator+=</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg"></a>TQString::arg ( const <a href="qstring.html">TQString</a> & a, int fieldWidth = 0 ) const -</h3> -This function will return a string that replaces the lowest -numbered occurrence of <tt>%1</tt>, <tt>%2</tt>, ..., <tt>%9</tt> with <em>a</em>. -<p> The <em>fieldWidth</em> value specifies the minimum amount of space that -<em>a</em> is padded to. A positive value will produce right-aligned -text, whereas a negative value will produce left-aligned text. -<p> The following example shows how we could create a 'status' string -when processing a list of files: -<pre> - TQString status = <a href="#TQString">TQString</a>( "Processing file %1 of %2: %3" ) - .arg( i ) // current file's number - .arg( total ) // number of files to process - .arg( fileName ); // current file's name - </pre> - -<p> It is generally fine to use filenames and numbers as we have done -in the example above. But note that using <a href="#arg">arg</a>() to construct -natural language sentences does not usually translate well into -other languages because sentence structure and word order often -differ between languages. -<p> If there is no place marker (<tt>%1</tt>, <tt>%2</tt>, etc.), a warning -message (<a href="qapplication.html#qWarning">qWarning</a>()) is output and the result is undefined. -<p> <b>Warning:</b> If any placeholder occurs more than once, the result is undefined. -<p> -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-2"></a>TQString::arg ( long a, int fieldWidth = 0, int base = 10 ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> The <em>fieldWidth</em> value specifies the minimum amount of space that -<em>a</em> is padded to. A positive value will produce a right-aligned -number, whereas a negative value will produce a left-aligned -number. -<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must -be between 2 and 36. -<p> The '%' can be followed by an 'L', in which case the sequence is -replaced with a localized representation of <em>a</em>. The conversion -uses the default locale. The default locale is determined from the -system's locale settings at application startup. It can be changed -using <a href="qlocale.html#setDefault">TQLocale::setDefault</a>(). The 'L' flag is ignored if <em>base</em> is -not 10. -<p> <pre> - TQString str; - str = <a href="#TQString">TQString</a>( "Decimal 63 is %1 in hexadecimal" ) - .arg( 63, 0, 16 ); - // str == "Decimal 63 is 3f in hexadecimal" - - TQLocale::<a href="qlocale.html#setDefault">setDefault</a>(TQLocale::English, TQLocale::UnitedStates); - str = <a href="#TQString">TQString</a>( "%1 %L2 %L3" ) - .arg( 12345 ) - .arg( 12345 ) - .arg( 12345, 0, 16 ); - // str == "12345 12,345 3039" - </pre> - - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-3"></a>TQString::arg ( ulong a, int fieldWidth = 0, int base = 10 ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must -be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used -to produce localized strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-4"></a>TQString::arg ( Q_LLONG a, int fieldWidth = 0, int base = 10 ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must -be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used -to produce localized strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-5"></a>TQString::arg ( Q_ULLONG a, int fieldWidth = 0, int base = 10 ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must -be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used -to produce localized strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-6"></a>TQString::arg ( int a, int fieldWidth = 0, int base = 10 ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must -be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used -to produce localized strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-7"></a>TQString::arg ( uint a, int fieldWidth = 0, int base = 10 ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must -be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used -to produce localized strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-8"></a>TQString::arg ( short a, int fieldWidth = 0, int base = 10 ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must -be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used -to produce localized strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-9"></a>TQString::arg ( ushort a, int fieldWidth = 0, int base = 10 ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <em>a</em> is expressed in base <em>base</em>, which is 10 by default and must -be between 2 and 36. If <em>base</em> is 10, the '%L' syntax can be used -to produce localized strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-a"></a>TQString::arg ( double a, int fieldWidth = 0, char fmt = 'g', int prec = -1 ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <a name="arg-formats"></a> -<p> Argument <em>a</em> is formatted according to the <em>fmt</em> format specified, -which is 'g' by default and can be any of the following: -<p> <center><table cellpadding="4" cellspacing="2" border="0"> -<tr bgcolor="#a2c511"> <th valign="top">Format <th valign="top">Meaning -<tr bgcolor="#f0f0f0"> <td valign="top"><tt>e</tt> <td valign="top">format as [-]9.9e[+|-]999 -<tr bgcolor="#d0d0d0"> <td valign="top"><tt>E</tt> <td valign="top">format as [-]9.9E[+|-]999 -<tr bgcolor="#f0f0f0"> <td valign="top"><tt>f</tt> <td valign="top">format as [-]9.9 -<tr bgcolor="#d0d0d0"> <td valign="top"><tt>g</tt> <td valign="top">use <tt>e</tt> or <tt>f</tt> format, whichever is the most concise -<tr bgcolor="#f0f0f0"> <td valign="top"><tt>G</tt> <td valign="top">use <tt>E</tt> or <tt>f</tt> format, whichever is the most concise -</table></center> -<p> With 'e', 'E', and 'f', <em>prec</em> is the number of digits after the -decimal point. With 'g' and 'G', <em>prec</em> is the maximum number of -significant digits (trailing zeroes are omitted). -<p> <pre> - double d = 12.34; - TQString ds = <a href="#TQString">TQString</a>( "'E' format, precision 3, gives %1" ) - .arg( d, 0, 'E', 3 ); - // ds == "'E' format, precision 3, gives 1.234E+01" - </pre> - -<p> The '%L' syntax can be used to produce localized strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-b"></a>TQString::arg ( char a, int fieldWidth = 0 ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <em>a</em> is assumed to be in the Latin-1 character set. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-c"></a>TQString::arg ( <a href="qchar.html">TQChar</a> a, int fieldWidth = 0 ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-d"></a>TQString::arg ( const <a href="qstring.html">TQString</a> & a1, const <a href="qstring.html">TQString</a> & a2 ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This is the same as str.<a href="#arg">arg</a>(<em>a1</em>).arg(<em>a2</em>), except that -the strings are replaced in one pass. This can make a difference -if <em>a1</em> contains e.g. <tt>%1</tt>: -<p> <pre> - TQString str( "%1 %2" ); - str.<a href="#arg">arg</a>( "Hello", "world" ); // returns "Hello world" - str.<a href="#arg">arg</a>( "Hello" ).arg( "world" ); // returns "Hello world" - - str.<a href="#arg">arg</a>( "(%1)", "Hello" ); // returns "(%1) Hello" - str.<a href="#arg">arg</a>( "(%1)" ).arg( "Hello" ); // returns "(Hello) %2" - </pre> - - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-e"></a>TQString::arg ( const <a href="qstring.html">TQString</a> & a1, const <a href="qstring.html">TQString</a> & a2, const <a href="qstring.html">TQString</a> & a3 ) const -</h3> - -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This is the same as calling str.<a href="#arg">arg</a>(<em>a1</em>).arg(<em>a2</em>).arg(<em>a3</em>), -except that the strings are replaced in one pass. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="arg-f"></a>TQString::arg ( const <a href="qstring.html">TQString</a> & a1, const <a href="qstring.html">TQString</a> & a2, const <a href="qstring.html">TQString</a> & a3, const <a href="qstring.html">TQString</a> & a4 ) const -</h3> - -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This is the same as calling -str.<a href="#arg">arg</a>(<em>a1</em>).arg(<em>a2</em>).arg(<em>a3</em>).arg(<em>a4</em>), -except that the strings are replaced in one pass. - -<h3 class=fn>const char * <a name="ascii"></a>TQString::ascii () const -</h3> -Returns an 8-bit ASCII representation of the string. -<p> If a codec has been set using <a href="qtextcodec.html#codecForCStrings">TQTextCodec::codecForCStrings</a>(), -it is used to convert Unicode to 8-bit char. Otherwise, this function -does the same as <a href="#latin1">latin1</a>(). -<p> <p>See also <a href="#fromAscii">fromAscii</a>(), <a href="#latin1">latin1</a>(), <a href="#utf8">utf8</a>(), and <a href="#local8Bit">local8Bit</a>(). - -<p>Example: <a href="networkprotocol-example.html#x690">network/networkprotocol/nntp.cpp</a>. -<h3 class=fn><a href="qchar.html">TQChar</a> <a name="at"></a>TQString::at ( uint i ) const -</h3> - -<p> Returns the character at index <em>i</em>, or 0 if <em>i</em> is beyond the -length of the string. -<p> <pre> - const TQString string( "abcdefgh" ); - <a href="qchar.html">TQChar</a> ch = string.<a href="#at">at</a>( 4 ); - // ch == 'e' - </pre> - -<p> If the TQString is not const (i.e. const TQString) or const& (i.e. -const TQString &), then the non-const overload of <a href="#at">at</a>() will be used -instead. - -<h3 class=fn><a href="qcharref.html">TQCharRef</a> <a name="at-2"></a>TQString::at ( uint i ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> The function returns a reference to the character at index <em>i</em>. -The resulting reference can then be assigned to, or used -immediately, but it will become invalid once further modifications -are made to the original string. -<p> If <em>i</em> is beyond the length of the string then the string is -expanded with TQChar::null. - -<h3 class=fn>uint <a name="capacity"></a>TQString::capacity () const -</h3> - -<p> Returns the number of characters this string can hold -in the allocated memory. -<p> <p>See also <a href="#reserve">reserve</a>() and <a href="#squeeze">squeeze</a>(). - -<h3 class=fn>int <a name="compare"></a>TQString::compare ( const <a href="qstring.html">TQString</a> & s1, const <a href="qstring.html">TQString</a> & s2 )<tt> [static]</tt> -</h3> - -<p> Lexically compares <em>s1</em> with <em>s2</em> and returns an integer less -than, equal to, or greater than zero if <em>s1</em> is less than, equal -to, or greater than <em>s2</em>. -<p> The comparison is based exclusively on the numeric Unicode values -of the characters and is very fast, but is not what a human would -expect. Consider sorting user-interface strings with -<a href="#localeAwareCompare">TQString::localeAwareCompare</a>(). -<p> <pre> - int a = TQString::<a href="#compare">compare</a>( "def", "abc" ); // a > 0 - int b = TQString::<a href="#compare">compare</a>( "abc", "def" ); // b < 0 - int c = TQString::<a href="#compare">compare</a>( "abc", "abc" ); // c == 0 - </pre> - - -<h3 class=fn>int <a name="compare-2"></a>TQString::compare ( const <a href="qstring.html">TQString</a> & s ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Lexically compares this string with <em>s</em> and returns an integer -less than, equal to, or greater than zero if it is less than, equal -to, or greater than <em>s</em>. - -<h3 class=fn>void <a name="compose"></a>TQString::compose () -</h3> -<b>Warning:</b> This function is not supported in TQt 3.x. It is provided -for experimental and illustrative purposes only. It is mainly of -interest to those experimenting with Arabic and other -composition-rich texts. -<p> Applies possible ligatures to a TQString. Useful when -composition-rich text requires rendering with glyph-poor fonts, -but it also makes compositions such as <a href="qchar.html">TQChar</a>(0x0041) ('A') and -TQChar(0x0308) (Unicode accent diaresis), giving TQChar(0x00c4) -(German A Umlaut). - -<h3 class=fn><a href="qchar.html">TQChar</a> <a name="constref"></a>TQString::constref ( uint i ) const -</h3> - -<p> Returns the <a href="qchar.html">TQChar</a> at index <em>i</em> by value. -<p> Equivalent to <a href="#at">at</a>(<em>i</em>). -<p> <p>See also <a href="#ref">ref</a>(). - -<h3 class=fn>int <a name="contains"></a>TQString::contains ( <a href="qchar.html">TQChar</a> c, bool cs = TRUE ) const -</h3> -Returns the number of times the character <em>c</em> occurs in the -string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> <pre> - TQString string( "Trolltech and TQt" ); - int n = string.<a href="#contains">contains</a>( 't', FALSE ); - // n == 3 - </pre> - - -<p>Examples: <a href="fileiconview-example.html#x867">fileiconview/qfileiconview.cpp</a> and <a href="mdi-example.html#x2064">mdi/application.cpp</a>. -<h3 class=fn>int <a name="contains-2"></a>TQString::contains ( char c, bool cs = TRUE ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<h3 class=fn>int <a name="contains-3"></a>TQString::contains ( const char * str, bool cs = TRUE ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Returns the number of times the string <em>str</em> occurs in the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. - -<h3 class=fn>int <a name="contains-4"></a>TQString::contains ( const <a href="qstring.html">TQString</a> & str, bool cs = TRUE ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Returns the number of times <em>str</em> occurs in the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> This function counts overlapping strings, so in the example below, -there are two instances of "ana" in "bananas". -<p> <pre> - TQString str( "bananas" ); - int i = str.<a href="#contains">contains</a>( "ana" ); // i == 2 - </pre> - -<p> <p>See also <a href="#findRev">findRev</a>(). - -<h3 class=fn>int <a name="contains-5"></a>TQString::contains ( const <a href="qregexp.html">TQRegExp</a> & rx ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Returns the number of times the regexp, <em>rx</em>, matches in the -string. -<p> This function counts overlapping matches, so in the example below, -there are four instances of "ana" or "ama". -<p> <pre> - TQString str = "banana and panama"; - <a href="qregexp.html">TQRegExp</a> rxp = TQRegExp( "a[nm]a", TRUE, FALSE ); - int i = str.<a href="#contains">contains</a>( rxp ); // i == 4 - </pre> - -<p> <p>See also <a href="#find">find</a>() and <a href="#findRev">findRev</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="copy"></a>TQString::copy () const -</h3> - -<p> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> In TQt 2.0 and later, all calls to this function are needless. Just -remove them. - -<h3 class=fn>const char * <a name="data"></a>TQString::data () const -</h3> - -<p> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> Returns a pointer to a '\0'-terminated classic C string. -<p> In TQt 1.x, this returned a char* allowing direct manipulation of the -string as a sequence of bytes. In TQt 2.x where TQString is a Unicode -string, char* conversion constructs a temporary string, and hence -direct character operations are meaningless. - -<h3 class=fn>bool <a name="endsWith"></a>TQString::endsWith ( const <a href="qstring.html">TQString</a> & s, bool cs = TRUE ) const -</h3> -Returns TRUE if the string ends with <em>s</em>; otherwise returns -FALSE. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> <pre> - TQString str( "Bananas" ); - str.<a href="#endsWith">endsWith</a>( "anas" ); // returns TRUE - str.<a href="#endsWith">endsWith</a>( "pple" ); // returns FALSE - </pre> - -<p> <p>See also <a href="#startsWith">startsWith</a>(). - -<p>Example: <a href="tutorial2-04.html#x2561">chart/main.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="fill"></a>TQString::fill ( <a href="qchar.html">TQChar</a> c, int len = -1 ) -</h3> -Fills the string with <em>len</em> characters of value <em>c</em>, and returns -a reference to the string. -<p> If <em>len</em> is negative (the default), the current string length is -used. -<p> <pre> - TQString str; - str.<a href="#fill">fill</a>( 'g', 5 ); // string == "ggggg" - </pre> - - -<h3 class=fn>int <a name="find"></a>TQString::find ( const <a href="qregexp.html">TQRegExp</a> & rx, int index = 0 ) const -</h3> -Finds the first match of the <a href="qregexp.html#regular-expression">regular expression</a> <em>rx</em>, starting -from position <em>index</em>. If <em>index</em> is -1, the search starts at -the last character; if -2, at the next to last character and so -on. (See <a href="#findRev">findRev</a>() for searching backwards.) -<p> Returns the position of the first match of <em>rx</em> or -1 if no match -was found. -<p> <pre> - TQString string( "bananas" ); - int i = string.<a href="#find">find</a>( TQRegExp("an"), 0 ); // i == 1 - </pre> - -<p> <p>See also <a href="#findRev">findRev</a>(), <a href="#replace">replace</a>(), and <a href="#contains">contains</a>(). - -<p>Example: <a href="mail-example.html#x715">network/mail/smtp.cpp</a>. -<h3 class=fn>int <a name="find-2"></a>TQString::find ( <a href="qchar.html">TQChar</a> c, int index = 0, bool cs = TRUE ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Finds the first occurrence of the character <em>c</em>, starting at -position <em>index</em>. If <em>index</em> is -1, the search starts at the -last character; if -2, at the next to last character and so on. -(See <a href="#findRev">findRev</a>() for searching backwards.) -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> Returns the position of <em>c</em> or -1 if <em>c</em> could not be found. - -<h3 class=fn>int <a name="find-3"></a>TQString::find ( char c, int index = 0, bool cs = TRUE ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Find character <em>c</em> starting from position <em>index</em>. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. - -<h3 class=fn>int <a name="find-4"></a>TQString::find ( const <a href="qstring.html">TQString</a> & str, int index = 0, bool cs = TRUE ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Finds the first occurrence of the string <em>str</em>, starting at -position <em>index</em>. If <em>index</em> is -1, the search starts at the -last character, if it is -2, at the next to last character and so -on. (See <a href="#findRev">findRev</a>() for searching backwards.) -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> Returns the position of <em>str</em> or -1 if <em>str</em> could not be found. - -<h3 class=fn>int <a name="find-5"></a>TQString::find ( const char * str, int index = 0 ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Equivalent to <a href="#find">find</a>(TQString(<em>str</em>), <em>index</em>). - -<h3 class=fn>int <a name="findRev"></a>TQString::findRev ( const char * str, int index = -1 ) const -</h3> - -<p> Equivalent to <a href="#findRev">findRev</a>(TQString(<em>str</em>), <em>index</em>). - -<h3 class=fn>int <a name="findRev-2"></a>TQString::findRev ( <a href="qchar.html">TQChar</a> c, int index = -1, bool cs = TRUE ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Finds the first occurrence of the character <em>c</em>, starting at -position <em>index</em> and searching backwards. If the index is -1, the -search starts at the last character, if it is -2, at the next to -last character and so on. -<p> Returns the position of <em>c</em> or -1 if <em>c</em> could not be found. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> <pre> - TQString string( "bananas" ); - int i = string.<a href="#findRev">findRev</a>( 'a' ); // i == 5 - </pre> - - -<h3 class=fn>int <a name="findRev-3"></a>TQString::findRev ( char c, int index = -1, bool cs = TRUE ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Find character <em>c</em> starting from position <em>index</em> and working -backwards. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. - -<h3 class=fn>int <a name="findRev-4"></a>TQString::findRev ( const <a href="qstring.html">TQString</a> & str, int index = -1, bool cs = TRUE ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Finds the first occurrence of the string <em>str</em>, starting at -position <em>index</em> and searching backwards. If the index is -1, the -search starts at the last character, if it is -2, at the next to -last character and so on. -<p> Returns the position of <em>str</em> or -1 if <em>str</em> could not be found. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> <pre> - TQString string("bananas"); - int i = string.<a href="#findRev">findRev</a>( "ana" ); // i == 3 - </pre> - - -<h3 class=fn>int <a name="findRev-5"></a>TQString::findRev ( const <a href="qregexp.html">TQRegExp</a> & rx, int index = -1 ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Finds the first match of the regexp <em>rx</em>, starting at position <em>index</em> and searching backwards. If the index is -1, the search -starts at the last character, if it is -2, at the next to last -character and so on. (See <a href="#findRev">findRev</a>() for searching backwards.) -<p> Returns the position of the match or -1 if no match was found. -<p> <pre> - TQString string( "bananas" ); - int i = string.<a href="#findRev">findRev</a>( TQRegExp("an") ); // i == 3 - </pre> - -<p> <p>See also <a href="#find">find</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="fromAscii"></a>TQString::fromAscii ( const char * ascii, int len = -1 )<tt> [static]</tt> -</h3> -Returns the Unicode string decoded from the first <em>len</em> -bytes of <em>ascii</em>, ignoring the rest of <em>ascii</em>. If <em>len</em> -is -1 then the length of <em>ascii</em> is used. If <em>len</em> is bigger -than the length of <em>ascii</em> then it will use the length of <em>ascii</em>. -<p> If a codec has been set using <a href="qtextcodec.html#codecForCStrings">TQTextCodec::codecForCStrings</a>(), -it is used to convert the string from 8-bit characters to Unicode. -Otherwise, this function does the same as <a href="#fromLatin1">fromLatin1</a>(). -<p> This is the same as the TQString(const char*) constructor, but you -can make that constructor invisible if you compile with the define -<tt>QT_NO_CAST_ASCII</tt>, in which case you can explicitly create a -TQString from 8-bit ASCII text using this function. -<p> <pre> - TQString str = TQString::<a href="#fromAscii">fromAscii</a>( "123456789", 5 ); - // str == "12345" - </pre> - - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="fromLatin1"></a>TQString::fromLatin1 ( const char * chars, int len = -1 )<tt> [static]</tt> -</h3> -Returns the Unicode string decoded from the first <em>len</em> -bytes of <em>chars</em>, ignoring the rest of <em>chars</em>. If <em>len</em> -is -1 then the length of <em>chars</em> is used. If <em>len</em> is bigger -than the length of <em>chars</em> then it will use the length of <em>chars</em>. -<p> <p>See also <a href="#fromAscii">fromAscii</a>(). - -<p>Examples: <a href="listbox-example.html#x1446">listbox/listbox.cpp</a> and <a href="mail-example.html#x716">network/mail/smtp.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="fromLocal8Bit"></a>TQString::fromLocal8Bit ( const char * local8Bit, int len = -1 )<tt> [static]</tt> -</h3> -Returns the Unicode string decoded from the first <em>len</em> -bytes of <em>local8Bit</em>, ignoring the rest of <em>local8Bit</em>. If -<em>len</em> is -1 then the length of <em>local8Bit</em> is used. If <em>len</em> is -bigger than the length of <em>local8Bit</em> then it will use the length -of <em>local8Bit</em>. -<p> <pre> - TQString str = TQString::<a href="#fromLocal8Bit">fromLocal8Bit</a>( "123456789", 5 ); - // str == "12345" - </pre> - -<p> <em>local8Bit</em> is assumed to be encoded in a locale-specific format. -<p> See <a href="qtextcodec.html">TQTextCodec</a> for more diverse coding/decoding of Unicode strings. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="fromUcs2"></a>TQString::fromUcs2 ( const unsigned short * str )<tt> [static]</tt> -</h3> -Constructs a string that is a <a href="shclass.html#deep-copy">deep copy</a> of <em>str</em>, interpreted as a -UCS2 encoded, zero terminated, Unicode string. -<p> If <em>str</em> is 0, then a null string is created. -<p> <p>See also <a href="#isNull">isNull</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="fromUtf8"></a>TQString::fromUtf8 ( const char * utf8, int len = -1 )<tt> [static]</tt> -</h3> -Returns the Unicode string decoded from the first <em>len</em> -bytes of <em>utf8</em>, ignoring the rest of <em>utf8</em>. If <em>len</em> is --1 then the length of <em>utf8</em> is used. If <em>len</em> is bigger than -the length of <em>utf8</em> then it will use the length of <em>utf8</em>. -<p> <pre> - TQString str = TQString::<a href="#fromUtf8">fromUtf8</a>( "123456789", 5 ); - // str == "12345" - </pre> - -<p> See <a href="qtextcodec.html">TQTextCodec</a> for more diverse coding/decoding of Unicode strings. - -<p>Example: <a href="simple-font-demo-example.html#x2850">fonts/simple-qfont-demo/viewer.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="insert"></a>TQString::insert ( uint index, const <a href="qstring.html">TQString</a> & s ) -</h3> -Inserts <em>s</em> into the string at position <em>index</em>. -<p> If <em>index</em> is beyond the end of the string, the string is -extended with spaces to length <em>index</em> and <em>s</em> is then appended -and returns a reference to the string. -<p> <pre> - TQString string( "I like fish" ); - str = string.<a href="#insert">insert</a>( 2, "don't " ); - // str == "I don't like fish" - </pre> - -<p> <p>See also <a href="#remove">remove</a>() and <a href="#replace">replace</a>(). - -<p>Examples: <a href="themes-example.html#x337">themes/themes.cpp</a> and <a href="xform-example.html#x1264">xform/xform.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="insert-2"></a>TQString::insert ( uint index, const <a href="qbytearray.html">TQByteArray</a> & s ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Inserts <em>s</em> into the string at position <em>index</em> and returns -a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="insert-3"></a>TQString::insert ( uint index, const char * s ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Inserts <em>s</em> into the string at position <em>index</em> and returns -a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="insert-4"></a>TQString::insert ( uint index, const <a href="qchar.html">TQChar</a> * s, uint len ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Inserts the first <em>len</em> characters in <em>s</em> into the string at -position <em>index</em> and returns a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="insert-5"></a>TQString::insert ( uint index, <a href="qchar.html">TQChar</a> c ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Insert <em>c</em> into the string at position <em>index</em> and returns a -reference to the string. -<p> If <em>index</em> is beyond the end of the string, the string is -extended with spaces (ASCII 32) to length <em>index</em> and <em>c</em> is -then appended. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="insert-6"></a>TQString::insert ( uint index, char c ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Insert character <em>c</em> at position <em>index</em>. - -<h3 class=fn>bool <a name="isEmpty"></a>TQString::isEmpty () const -</h3> - -<p> Returns TRUE if the string is empty, i.e. if <a href="#length">length</a>() == 0; -otherwise returns FALSE. Null strings are also empty. -<p> <pre> - TQString a( "" ); - a.<a href="#isEmpty">isEmpty</a>(); // TRUE - a.<a href="#isNull">isNull</a>(); // FALSE - - TQString b; - b.<a href="#isEmpty">isEmpty</a>(); // TRUE - b.<a href="#isNull">isNull</a>(); // TRUE - </pre> - -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#length">length</a>(). - -<p>Examples: <a href="addressbook-example.html#x571">addressbook/mainwindow.cpp</a>, <a href="canvas-chart-example.html#x2892">chart/chartform.cpp</a>, <a href="tutorial2-06.html#x2576">chart/chartform_canvas.cpp</a>, <a href="networkprotocol-example.html#x691">network/networkprotocol/nntp.cpp</a>, <a href="qmag-example.html#x1792">qmag/qmag.cpp</a>, and <a href="qwerty-example.html#x390">qwerty/qwerty.cpp</a>. -<h3 class=fn>bool <a name="isNull"></a>TQString::isNull () const -</h3> - -<p> Returns TRUE if the string is null; otherwise returns FALSE. A -null string is always empty. -<p> <pre> - TQString a; // a.<a href="#unicode">unicode</a>() == 0, a.<a href="#length">length</a>() == 0 - a.<a href="#isNull">isNull</a>(); // TRUE, because a.<a href="#unicode">unicode</a>() == 0 - a.<a href="#isEmpty">isEmpty</a>(); // TRUE, because a.<a href="#length">length</a>() == 0 - </pre> - -<p> <p>See also <a href="#isEmpty">isEmpty</a>() and <a href="#length">length</a>(). - -<p>Examples: <a href="i18n-example.html#x1948">i18n/main.cpp</a>, <a href="ftpclient-example.html#x771">network/ftpclient/ftpmainwindow.ui.h</a>, and <a href="qdir-example.html#x1842">qdir/qdir.cpp</a>. -<h3 class=fn>const char * <a name="latin1"></a>TQString::latin1 () const -</h3> -Returns a Latin-1 representation of the string. The -returned value is undefined if the string contains non-Latin-1 -characters. If you want to convert strings into formats other than -Unicode, see the <a href="qtextcodec.html">TQTextCodec</a> classes. -<p> This function is mainly useful for boot-strapping legacy code to -use Unicode. -<p> The result remains valid so long as one unmodified copy of the -source string exists. -<p> <p>See also <a href="#fromLatin1">fromLatin1</a>(), <a href="#ascii">ascii</a>(), <a href="#utf8">utf8</a>(), and <a href="#local8Bit">local8Bit</a>(). - -<p>Examples: <a href="fileiconview-example.html#x869">fileiconview/qfileiconview.cpp</a> and <a href="networkprotocol-example.html#x692">network/networkprotocol/nntp.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="left"></a>TQString::left ( uint len ) const -</h3> -Returns a substring that contains the <em>len</em> leftmost characters -of the string. -<p> The whole string is returned if <em>len</em> exceeds the length of the -string. -<p> <pre> - TQString s = "Pineapple"; - TQString t = s.<a href="#left">left</a>( 4 ); // t == "Pine" - </pre> - -<p> <p>See also <a href="#right">right</a>(), <a href="#mid">mid</a>(), and <a href="#isEmpty">isEmpty</a>(). - -<p>Example: <a href="themes-example.html#x338">themes/themes.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="leftJustify"></a>TQString::leftJustify ( uint width, <a href="qchar.html">TQChar</a> fill = ' ', bool truncate = FALSE ) const -</h3> -Returns a string of length <em>width</em> that contains this string -padded by the <em>fill</em> character. -<p> If <em>truncate</em> is FALSE and the length of the string is more than -<em>width</em>, then the returned string is a copy of the string. -<p> If <em>truncate</em> is TRUE and the length of the string is more than -<em>width</em>, then any characters in a copy of the string after length -<em>width</em> are removed, and the copy is returned. -<p> <pre> - TQString s( "apple" ); - TQString t = s.<a href="#leftJustify">leftJustify</a>( 8, '.' ); // t == "apple..." - </pre> - -<p> <p>See also <a href="#rightJustify">rightJustify</a>(). - -<h3 class=fn>uint <a name="length"></a>TQString::length () const -</h3> - -<p> Returns the length of the string. -<p> Null strings and empty strings have zero length. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<p>Examples: <a href="dirview-example.html#x1702">dirview/dirview.cpp</a>, <a href="fileiconview-example.html#x870">fileiconview/qfileiconview.cpp</a>, <a href="networkprotocol-example.html#x693">network/networkprotocol/nntp.cpp</a>, <a href="rot-example.html#x1372">rot13/rot13.cpp</a>, and <a href="themes-example.html#x339">themes/themes.cpp</a>. -<h3 class=fn><a href="qcstring.html">TQCString</a> <a name="local8Bit"></a>TQString::local8Bit () const -</h3> -Returns the string encoded in a locale-specific format. On X11, -this is the <a href="qtextcodec.html#codecForLocale">TQTextCodec::codecForLocale</a>(). On Windows, it is a -system-defined encoding. On Mac OS X, this always uses UTF-8 as -the encoding. -<p> See <a href="qtextcodec.html">TQTextCodec</a> for more diverse coding/decoding of Unicode -strings. -<p> <p>See also <a href="#fromLocal8Bit">fromLocal8Bit</a>(), <a href="#ascii">ascii</a>(), <a href="#latin1">latin1</a>(), and <a href="#utf8">utf8</a>(). - -<h3 class=fn>int <a name="localeAwareCompare"></a>TQString::localeAwareCompare ( const <a href="qstring.html">TQString</a> & s1, const <a href="qstring.html">TQString</a> & s2 )<tt> [static]</tt> -</h3> - -<p> Compares <em>s1</em> with <em>s2</em> and returns an integer less than, equal -to, or greater than zero if <em>s1</em> is less than, equal to, or -greater than <em>s2</em>. -<p> The comparison is performed in a locale- and also -platform-dependent manner. Use this function to present sorted -lists of strings to the user. -<p> <p>See also <a href="#compare">TQString::compare</a>() and <a href="qtextcodec.html#locale">TQTextCodec::locale</a>(). - -<h3 class=fn>int <a name="localeAwareCompare-2"></a>TQString::localeAwareCompare ( const <a href="qstring.html">TQString</a> & s ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Compares this string with <em>s</em>. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="lower"></a>TQString::lower () const -</h3> -Returns a lowercase copy of the string. -<p> <pre> - TQString string( "TROlltECH" ); - str = string.<a href="#lower">lower</a>(); // str == "trolltech" - </pre> - -<p> <p>See also <a href="#upper">upper</a>(). - -<p>Example: <a href="scribble-example.html#x941">scribble/scribble.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="mid"></a>TQString::mid ( uint index, uint len = 0xffffffff ) const -</h3> -Returns a string that contains the <em>len</em> characters of this -string, starting at position <em>index</em>. -<p> Returns a null string if the string is empty or <em>index</em> is out of -range. Returns the whole string from <em>index</em> if <em>index</em> + <em>len</em> -exceeds the length of the string. -<p> <pre> - TQString s( "Five pineapples" ); - TQString t = s.<a href="#mid">mid</a>( 5, 4 ); // t == "pine" - </pre> - -<p> <p>See also <a href="#left">left</a>() and <a href="#right">right</a>(). - -<p>Examples: <a href="mail-example.html#x717">network/mail/smtp.cpp</a>, <a href="qmag-example.html#x1793">qmag/qmag.cpp</a>, and <a href="themes-example.html#x340">themes/themes.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="number"></a>TQString::number ( long n, int base = 10 )<tt> [static]</tt> -</h3> -A convenience function that returns a string equivalent of the -number <em>n</em> to base <em>base</em>, which is 10 by default and must be -between 2 and 36. The returned string is in "C" locale. -<p> <pre> - long a = 63; - TQString str = TQString::<a href="#number">number</a>( a, 16 ); // str == "3f" - TQString str = TQString::<a href="#number">number</a>( a, 16 ).upper(); // str == "3F" - </pre> - -<p> <p>See also <a href="#setNum">setNum</a>(). - -<p>Examples: <a href="simple-application-example.html#x1580">application/application.cpp</a>, <a href="canvas-chart-example.html#x2893">chart/chartform.cpp</a>, <a href="simple-font-demo-example.html#x2851">fonts/simple-qfont-demo/viewer.cpp</a>, <a href="helpviewer-example.html#x1018">helpviewer/helpwindow.cpp</a>, <a href="mdi-example.html#x2066">mdi/application.cpp</a>, <a href="regexptester-example.html#x2496">regexptester/regexptester.cpp</a>, and <a href="sql.html#x2193">sql/overview/extract/main.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="number-2"></a>TQString::number ( ulong n, int base = 10 )<tt> [static]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <p>See also <a href="#setNum">setNum</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="number-3"></a>TQString::number ( Q_LLONG n, int base = 10 )<tt> [static]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <p>See also <a href="#setNum">setNum</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="number-4"></a>TQString::number ( Q_ULLONG n, int base = 10 )<tt> [static]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <p>See also <a href="#setNum">setNum</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="number-5"></a>TQString::number ( int n, int base = 10 )<tt> [static]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> <p>See also <a href="#setNum">setNum</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="number-6"></a>TQString::number ( uint n, int base = 10 )<tt> [static]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> A convenience factory function that returns a string -representation of the number <em>n</em> to the base <em>base</em>, which is 10 -by default and must be between 2 and 36. -<p> <p>See also <a href="#setNum">setNum</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="number-7"></a>TQString::number ( double n, char f = 'g', int prec = 6 )<tt> [static]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Argument <em>n</em> is formatted according to the <em>f</em> format specified, -which is <tt>g</tt> by default, and can be any of the following: -<p> <center><table cellpadding="4" cellspacing="2" border="0"> -<tr bgcolor="#a2c511"> <th valign="top">Format <th valign="top">Meaning -<tr bgcolor="#f0f0f0"> <td valign="top"><tt>e</tt> <td valign="top">format as [-]9.9e[+|-]999 -<tr bgcolor="#d0d0d0"> <td valign="top"><tt>E</tt> <td valign="top">format as [-]9.9E[+|-]999 -<tr bgcolor="#f0f0f0"> <td valign="top"><tt>f</tt> <td valign="top">format as [-]9.9 -<tr bgcolor="#d0d0d0"> <td valign="top"><tt>g</tt> <td valign="top">use <tt>e</tt> or <tt>f</tt> format, whichever is the most concise -<tr bgcolor="#f0f0f0"> <td valign="top"><tt>G</tt> <td valign="top">use <tt>E</tt> or <tt>f</tt> format, whichever is the most concise -</table></center> -<p> With 'e', 'E', and 'f', <em>prec</em> is the number of digits after the -decimal point. With 'g' and 'G', <em>prec</em> is the maximum number of -significant digits (trailing zeroes are omitted). -<p> <pre> - double d = 12.34; - TQString ds = <a href="#TQString">TQString</a>( "'E' format, precision 3, gives %1" ) - .arg( d, 0, 'E', 3 ); - // ds == "1.234E+001" - </pre> - -<p> <p>See also <a href="#setNum">setNum</a>(). - -<h3 class=fn><a name="operator-const-char-*"></a>TQString::operator const char * () const -</h3> - -<p> Returns <a href="#ascii">ascii</a>(). Be sure to see the warnings documented in the -ascii() function. Note that for new code which you wish to be -strictly Unicode-clean, you can define the macro <tt>QT_NO_ASCII_CAST</tt> when compiling your code to hide this function so -that automatic casts are not done. This has the added advantage -that you catch the programming error described in <a href="#operator!">operator!</a>(). - -<h3 class=fn><a name="operator-std::string"></a>TQString::operator std::string () const -</h3> - -<p> Returns <a href="#ascii">ascii</a>() as a std::string. -<p> <b>Warning:</b> The function may cause an application to crash if a static C run-time is in use. -This can happen in Microsoft Visual C++ if TQt is configured as single-threaded. A safe -alternative is to call ascii() directly and construct a std::string manually. - -<h3 class=fn>bool <a name="operator!"></a>TQString::operator! () const -</h3> - -<p> Returns TRUE if this is a null string; otherwise returns FALSE. -<p> <pre> - TQString name = getName(); - if ( !name ) - name = "Rodney"; - </pre> - -<p> Note that if you say -<p> <pre> - TQString name = getName(); - if ( name ) - doSomethingWith(name); - </pre> - -<p> It will call "operator const char*()", which is inefficent; you -may wish to define the macro <tt>QT_NO_ASCII_CAST</tt> when writing code -which you wish to remain Unicode-clean. -<p> When you want the above semantics, use: -<p> <pre> - TQString name = getName(); - if ( !name.<a href="#isNull">isNull</a>() ) - doSomethingWith(name); - </pre> - -<p> <p>See also <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator+-eq"></a>TQString::operator+= ( const <a href="qstring.html">TQString</a> & str ) -</h3> -Appends <em>str</em> to the string and returns a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator+-eq-2"></a>TQString::operator+= ( const <a href="qbytearray.html">TQByteArray</a> & str ) -</h3> - -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends <em>str</em> to the string and returns a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator+-eq-3"></a>TQString::operator+= ( const char * str ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends <em>str</em> to the string and returns a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator+-eq-4"></a>TQString::operator+= ( const std::string & str ) -</h3> - -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends <em>str</em> to the string and returns a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator+-eq-5"></a>TQString::operator+= ( <a href="qchar.html">TQChar</a> c ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends <em>c</em> to the string and returns a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator+-eq-6"></a>TQString::operator+= ( char c ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Appends <em>c</em> to the string and returns a reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator-eq"></a>TQString::operator= ( <a href="qchar.html">TQChar</a> c ) -</h3> - -<p> Sets the string to contain just the single character <em>c</em>. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator-eq-2"></a>TQString::operator= ( const <a href="qstring.html">TQString</a> & s ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Assigns a <a href="shclass.html#shallow-copy">shallow copy</a> of <em>s</em> to this string and returns a -reference to this string. This is very fast because the string -isn't actually copied. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator-eq-3"></a>TQString::operator= ( const char * str ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Assigns a <a href="shclass.html#deep-copy">deep copy</a> of <em>str</em>, interpreted as a classic C string -to this string and returns a reference to this string. -<p> If <em>str</em> is 0, then a null string is created. -<p> <p>See also <a href="#isNull">isNull</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator-eq-4"></a>TQString::operator= ( const std::string & s ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Makes a <a href="shclass.html#deep-copy">deep copy</a> of <em>s</em> and returns a reference to the deep -copy. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator-eq-5"></a>TQString::operator= ( const <a href="qcstring.html">TQCString</a> & cstr ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Assigns a <a href="shclass.html#deep-copy">deep copy</a> of <em>cstr</em>, interpreted as a classic C -string, to this string. Returns a reference to this string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="operator-eq-6"></a>TQString::operator= ( char c ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the string to contain just the single character <em>c</em>. - -<h3 class=fn><a href="qchar.html">TQChar</a> <a name="operator[]"></a>TQString::operator[] ( int i ) const -</h3> - -<p> Returns the character at index <em>i</em>, or TQChar::null if <em>i</em> is -beyond the length of the string. -<p> If the TQString is not const (i.e., const TQString) or const& -(i.e., const TQString&), then the non-const overload of operator[] -will be used instead. - -<h3 class=fn><a href="qcharref.html">TQCharRef</a> <a name="operator[]-2"></a>TQString::operator[] ( int i ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> The function returns a reference to the character at index <em>i</em>. -The resulting reference can then be assigned to, or used -immediately, but it will become invalid once further modifications -are made to the original string. -<p> If <em>i</em> is beyond the length of the string then the string is -expanded with TQChar::nulls, so that the <a href="qcharref.html">TQCharRef</a> references a -valid (null) character in the string. -<p> The TQCharRef internal class can be used much like a constant -<a href="qchar.html">TQChar</a>, but if you assign to it, you change the original string -(which will detach itself because of TQString's copy-on-write -semantics). You will get compilation errors if you try to use the -result as anything but a TQChar. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="prepend"></a>TQString::prepend ( const <a href="qstring.html">TQString</a> & s ) -</h3> - -<p> Inserts <em>s</em> at the beginning of the string and returns a -reference to the string. -<p> Equivalent to <a href="#insert">insert</a>(0, <em>s</em>). -<p> <pre> - TQString string = "42"; - string.<a href="#prepend">prepend</a>( "The answer is " ); - // string == "The answer is 42" - </pre> - -<p> <p>See also <a href="#insert">insert</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="prepend-2"></a>TQString::prepend ( char ch ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Inserts <em>ch</em> at the beginning of the string and returns a -reference to the string. -<p> Equivalent to <a href="#insert">insert</a>(0, <em>ch</em>). -<p> <p>See also <a href="#insert">insert</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="prepend-3"></a>TQString::prepend ( <a href="qchar.html">TQChar</a> ch ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Inserts <em>ch</em> at the beginning of the string and returns a -reference to the string. -<p> Equivalent to <a href="#insert">insert</a>(0, <em>ch</em>). -<p> <p>See also <a href="#insert">insert</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="prepend-4"></a>TQString::prepend ( const <a href="qbytearray.html">TQByteArray</a> & s ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Inserts <em>s</em> at the beginning of the string and returns a reference to the string. -<p> Equivalent to <a href="#insert">insert</a>(0, <em>s</em>). -<p> <p>See also <a href="#insert">insert</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="prepend-5"></a>TQString::prepend ( const char * s ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Inserts <em>s</em> at the beginning of the string and returns a reference to the string. -<p> Equivalent to <a href="#insert">insert</a>(0, <em>s</em>). -<p> <p>See also <a href="#insert">insert</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="prepend-6"></a>TQString::prepend ( const std::string & s ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Inserts <em>s</em> at the beginning of the string and returns a reference to the string. -<p> Equivalent to <a href="#insert">insert</a>(0, <em>s</em>). -<p> <p>See also <a href="#insert">insert</a>(). - -<h3 class=fn><a href="qchar.html">TQChar</a> & <a name="ref"></a>TQString::ref ( uint i ) -</h3> - -<p> Returns the <a href="qchar.html">TQChar</a> at index <em>i</em> by reference, expanding the string -with TQChar::null if necessary. The resulting reference can be -assigned to, or otherwise used immediately, but becomes invalid -once furher modifications are made to the string. -<p> <pre> - TQString string("ABCDEF"); - <a href="qchar.html">TQChar</a> ch = string.<a href="#ref">ref</a>( 3 ); // ch == 'D' - </pre> - -<p> <p>See also <a href="#constref">constref</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="remove"></a>TQString::remove ( uint index, uint len ) -</h3> -Removes <em>len</em> characters from the string starting at position <em>index</em>, and returns a reference to the string. -<p> If <em>index</em> is beyond the length of the string, nothing happens. -If <em>index</em> is within the string, but <em>index</em> + <em>len</em> is beyond -the end of the string, the string is truncated at position <em>index</em>. -<p> <pre> - TQString string( "Montreal" ); - string.<a href="#remove">remove</a>( 1, 4 ); // string == "Meal" - </pre> - -<p> <p>See also <a href="#insert">insert</a>() and <a href="#replace">replace</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="remove-2"></a>TQString::remove ( const <a href="qstring.html">TQString</a> & str, bool cs = TRUE ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Removes every occurrence of <em>str</em> in the string. Returns a -reference to the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> This is the same as <a href="#replace">replace</a>(<em>str</em>, "", <em>cs</em>). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="remove-3"></a>TQString::remove ( <a href="qchar.html">TQChar</a> c ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Removes every occurrence of the character <em>c</em> in the string. -Returns a reference to the string. -<p> This is the same as <a href="#replace">replace</a>(<em>c</em>, ""). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="remove-4"></a>TQString::remove ( char c ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Removes every occurrence of the character <em>c</em> in the string. -Returns a reference to the string. -<p> This is the same as <a href="#replace">replace</a>(<em>c</em>, ""). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="remove-5"></a>TQString::remove ( const char * str ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Removes every occurrence of <em>str</em> in the string. Returns a -reference to the string. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="remove-6"></a>TQString::remove ( const <a href="qregexp.html">TQRegExp</a> & rx ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Removes every occurrence of the <a href="qregexp.html#regular-expression">regular expression</a> <em>rx</em> in the -string. Returns a reference to the string. -<p> This is the same as <a href="#replace">replace</a>(<em>rx</em>, ""). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace"></a>TQString::replace ( uint index, uint len, const <a href="qstring.html">TQString</a> & s ) -</h3> -Replaces <em>len</em> characters from the string with <em>s</em>, starting at -position <em>index</em>, and returns a reference to the string. -<p> If <em>index</em> is beyond the length of the string, nothing is deleted -and <em>s</em> is appended at the end of the string. If <em>index</em> is -valid, but <em>index</em> + <em>len</em> is beyond the end of the string, -the string is truncated at position <em>index</em>, then <em>s</em> is -appended at the end. -<p> <pre> - TQString string( "Say yes!" ); - string = string.<a href="#replace">replace</a>( 4, 3, "NO" ); - // string == "Say NO!" - </pre> - -<p> <b>Warning:</b> TQt 3.3.3 and earlier had different semantics for the -case <em>index</em> >= <a href="#length">length</a>(), which contradicted the documentation. -To avoid portability problems between TQt 3 versions and with TQt -4, we recommend that you never call the function with <em>index</em> >= -length(). -<p> <p>See also <a href="#insert">insert</a>() and <a href="#remove">remove</a>(). - -<p>Examples: <a href="listviews-example.html#x162">listviews/listviews.cpp</a>, <a href="networkprotocol-example.html#x694">network/networkprotocol/nntp.cpp</a>, <a href="qmag-example.html#x1794">qmag/qmag.cpp</a>, and <a href="regexptester-example.html#x2497">regexptester/regexptester.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace-2"></a>TQString::replace ( uint index, uint len, const <a href="qchar.html">TQChar</a> * s, uint slen ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Replaces <em>len</em> characters with <em>slen</em> characters of <a href="qchar.html">TQChar</a> data -from <em>s</em>, starting at position <em>index</em>, and returns a reference -to the string. -<p> <p>See also <a href="#insert">insert</a>() and <a href="#remove">remove</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace-3"></a>TQString::replace ( uint index, uint len, <a href="qchar.html">TQChar</a> c ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This is the same as <a href="#replace">replace</a>(<em>index</em>, <em>len</em>, TQString(<em>c</em>)). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace-4"></a>TQString::replace ( uint index, uint len, char c ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> This is the same as <a href="#replace">replace</a>(<em>index</em>, <em>len</em>, <a href="qchar.html">TQChar</a>(<em>c</em>)). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace-5"></a>TQString::replace ( <a href="qchar.html">TQChar</a> c, const <a href="qstring.html">TQString</a> & after, bool cs = TRUE ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Replaces every occurrence of the character <em>c</em> in the string -with <em>after</em>. Returns a reference to the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> Example: -<pre> - TQString s = "a,b,c"; - s.<a href="#replace">replace</a>( TQChar(','), " or " ); - // s == "a or b or c" - </pre> - - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace-6"></a>TQString::replace ( char c, const <a href="qstring.html">TQString</a> & after, bool cs = TRUE ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Replaces every occurrence of the character <em>c</em> in the string -with <em>after</em>. Returns a reference to the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace-7"></a>TQString::replace ( const <a href="qstring.html">TQString</a> & before, const <a href="qstring.html">TQString</a> & after, bool cs = TRUE ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Replaces every occurrence of the string <em>before</em> in the string -with the string <em>after</em>. Returns a reference to the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> Example: -<pre> - TQString s = "Greek is Greek"; - s.<a href="#replace">replace</a>( "Greek", "English" ); - // s == "English is English" - </pre> - - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace-8"></a>TQString::replace ( const <a href="qregexp.html">TQRegExp</a> & rx, const <a href="qstring.html">TQString</a> & after ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Replaces every occurrence of the regexp <em>rx</em> in the string with -<em>after</em>. Returns a reference to the string. For example: -<pre> - TQString s = "banana"; - s.<a href="#replace">replace</a>( TQRegExp("an"), "" ); - // s == "ba" - </pre> - -<p> For regexps containing <a href="qregexp.html#capturing-text">capturing - parentheses</a>, occurrences of <b>\1</b>, <b>\2</b>, ..., -in <em>after</em> are replaced with <em>rx</em>.cap(1), cap(2), ... -<p> <pre> - TQString t = "A <i>bon mot</i>."; - t.<a href="#replace">replace</a>( TQRegExp("<i>([^<]*)</i>"), "\\emph{\\1}" ); - // t == "A \\emph{bon mot}." - </pre> - -<p> <p>See also <a href="#find">find</a>(), <a href="#findRev">findRev</a>(), and <a href="qregexp.html#cap">TQRegExp::cap</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="replace-9"></a>TQString::replace ( <a href="qchar.html">TQChar</a> c1, <a href="qchar.html">TQChar</a> c2 ) -</h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Replaces every occurrence of <em>c1</em> with the char <em>c2</em>. Returns a -reference to the string. - -<h3 class=fn>void <a name="reserve"></a>TQString::reserve ( uint minCapacity ) -</h3> -Ensures that at least <em>minCapacity</em> characters are allocated to -the string. -<p> This function is useful for code that needs to build up a long -string and wants to avoid repeated reallocation. In this example, -we want to add to the string until some condition is true, and -we're fairly sure that size is big enough: -<pre> - TQString result; - int len = 0; - result.<a href="#reserve">reserve</a>(maxLen); - while (...) { - result[len++] = ... // fill part of the space - } - result.<a href="#squeeze">squeeze</a>(); - </pre> - -<p> If <em>maxLen</em> is an underestimate, the worst that will happen is -that the loop will slow down. -<p> If it is not possible to allocate enough memory, the string -remains unchanged. -<p> <p>See also <a href="#capacity">capacity</a>(), <a href="#squeeze">squeeze</a>(), and <a href="#setLength">setLength</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="right"></a>TQString::right ( uint len ) const -</h3> -Returns a string that contains the <em>len</em> rightmost characters of -the string. -<p> If <em>len</em> is greater than the length of the string then the whole -string is returned. -<p> <pre> - TQString string( "Pineapple" ); - TQString t = string.<a href="#right">right</a>( 5 ); // t == "apple" - </pre> - -<p> <p>See also <a href="#left">left</a>(), <a href="#mid">mid</a>(), and <a href="#isEmpty">isEmpty</a>(). - -<p>Example: <a href="fileiconview-example.html#x871">fileiconview/qfileiconview.cpp</a>. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="rightJustify"></a>TQString::rightJustify ( uint width, <a href="qchar.html">TQChar</a> fill = ' ', bool truncate = FALSE ) const -</h3> -Returns a string of length <em>width</em> that contains the <em>fill</em> -character followed by the string. -<p> If <em>truncate</em> is FALSE and the length of the string is more than -<em>width</em>, then the returned string is a copy of the string. -<p> If <em>truncate</em> is TRUE and the length of the string is more than -<em>width</em>, then the resulting string is truncated at position <em>width</em>. -<p> <pre> - TQString string( "apple" ); - TQString t = string.<a href="#rightJustify">rightJustify</a>( 8, '.' ); // t == "...apple" - </pre> - -<p> <p>See also <a href="#leftJustify">leftJustify</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="section"></a>TQString::section ( <a href="qchar.html">TQChar</a> sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const -</h3> - -<p> This function returns a section of the string. -<p> This string is treated as a sequence of fields separated by the -character, <em>sep</em>. The returned string consists of the fields from -position <em>start</em> to position <em>end</em> inclusive. If <em>end</em> is not -specified, all fields from position <em>start</em> to the end of the -string are included. Fields are numbered 0, 1, 2, etc., counting -from the left, and -1, -2, etc., counting from right to left. -<p> The <em>flags</em> argument can be used to affect some aspects of the -function's behaviour, e.g. whether to be case sensitive, whether -to skip empty fields and how to deal with leading and trailing -separators; see <a href="#SectionFlags-enum">SectionFlags</a>. -<p> <pre> - TQString csv( "forename,middlename,surname,phone" ); - TQString s = csv.<a href="#section">section</a>( ',', 2, 2 ); // s == "surname" - - TQString path( "/usr/local/bin/myapp" ); // First field is empty - TQString s = path.<a href="#section">section</a>( '/', 3, 4 ); // s == "bin/myapp" - TQString s = path.<a href="#section">section</a>( '/', 3, 3, SectionSkipEmpty ); // s == "myapp" - </pre> - -<p> If <em>start</em> or <em>end</em> is negative, we count fields from the right -of the string, the right-most field being -1, the one from -right-most field being -2, and so on. -<p> <pre> - TQString csv( "forename,middlename,surname,phone" ); - TQString s = csv.<a href="#section">section</a>( ',', -3, -2 ); // s == "middlename,surname" - - TQString path( "/usr/local/bin/myapp" ); // First field is empty - TQString s = path.<a href="#section">section</a>( '/', -1 ); // s == "myapp" - </pre> - -<p> <p>See also <a href="qstringlist.html#split">TQStringList::split</a>(). - -<p>Examples: <a href="tutorial2-03.html#x2551">chart/element.cpp</a> and <a href="ftpclient-example.html#x772">network/ftpclient/ftpmainwindow.ui.h</a>. -<h3 class=fn><a href="qstring.html">TQString</a> <a name="section-2"></a>TQString::section ( char sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<h3 class=fn><a href="qstring.html">TQString</a> <a name="section-3"></a>TQString::section ( const char * sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<h3 class=fn><a href="qstring.html">TQString</a> <a name="section-4"></a>TQString::section ( const <a href="qstring.html">TQString</a> & sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This function returns a section of the string. -<p> This string is treated as a sequence of fields separated by the -string, <em>sep</em>. The returned string consists of the fields from -position <em>start</em> to position <em>end</em> inclusive. If <em>end</em> is not -specified, all fields from position <em>start</em> to the end of the -string are included. Fields are numbered 0, 1, 2, etc., counting -from the left, and -1, -2, etc., counting from right to left. -<p> The <em>flags</em> argument can be used to affect some aspects of the -function's behaviour, e.g. whether to be case sensitive, whether -to skip empty fields and how to deal with leading and trailing -separators; see <a href="#SectionFlags-enum">SectionFlags</a>. -<p> <pre> - TQString data( "forename**middlename**surname**phone" ); - TQString s = data.<a href="#section">section</a>( "**", 2, 2 ); // s == "surname" - </pre> - -<p> If <em>start</em> or <em>end</em> is negative, we count fields from the right -of the string, the right-most field being -1, the one from -right-most field being -2, and so on. -<p> <pre> - TQString data( "forename**middlename**surname**phone" ); - TQString s = data.<a href="#section">section</a>( "**", -3, -2 ); // s == "middlename**surname" - </pre> - -<p> <p>See also <a href="qstringlist.html#split">TQStringList::split</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="section-5"></a>TQString::section ( const <a href="qregexp.html">TQRegExp</a> & reg, int start, int end = 0xffffffff, int flags = SectionDefault ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This function returns a section of the string. -<p> This string is treated as a sequence of fields separated by the -<a href="qregexp.html#regular-expression">regular expression</a>, <em>reg</em>. The returned string consists of the -fields from position <em>start</em> to position <em>end</em> inclusive. If <em>end</em> is not specified, all fields from position <em>start</em> to the end -of the string are included. Fields are numbered 0, 1, 2, etc., counting -from the left, and -1, -2, etc., counting from right to left. -<p> The <em>flags</em> argument can be used to affect some aspects of the -function's behaviour, e.g. whether to be case sensitive, whether -to skip empty fields and how to deal with leading and trailing -separators; see <a href="#SectionFlags-enum">SectionFlags</a>. -<p> <pre> - TQString line( "forename\tmiddlename surname \t \t phone" ); - <a href="qregexp.html">TQRegExp</a> sep( "\s+" ); - TQString s = line.<a href="#section">section</a>( sep, 2, 2 ); // s == "surname" - </pre> - -<p> If <em>start</em> or <em>end</em> is negative, we count fields from the right -of the string, the right-most field being -1, the one from -right-most field being -2, and so on. -<p> <pre> - TQString line( "forename\tmiddlename surname \t \t phone" ); - <a href="qregexp.html">TQRegExp</a> sep( "\\s+" ); - TQString s = line.<a href="#section">section</a>( sep, -3, -2 ); // s == "middlename surname" - </pre> - -<p> <b>Warning:</b> Using this <a href="qregexp.html">TQRegExp</a> version is much more expensive than -the overloaded string and character versions. -<p> <p>See also <a href="qstringlist.html#split">TQStringList::split</a>() and <a href="#simplifyWhiteSpace">simplifyWhiteSpace</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setAscii"></a>TQString::setAscii ( const char * str, int len = -1 ) -</h3> -Sets this string to <em>str</em>, interpreted as a classic 8-bit ASCII C -string. If <em>len</em> is -1 (the default), then it is set to -strlen(str). -<p> If <em>str</em> is 0 a null string is created. If <em>str</em> is "", an empty -string is created. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>void <a name="setExpand"></a>TQString::setExpand ( uint index, <a href="qchar.html">TQChar</a> c ) -</h3> <b>This function is obsolete.</b> It is provided to keep old source working. We strongly advise against using it in new code. -<p> Sets the character at position <em>index</em> to <em>c</em> and expands the -string if necessary, filling with spaces. -<p> This method is redundant in TQt 3.x, because operator[] will expand -the string as necessary. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setLatin1"></a>TQString::setLatin1 ( const char * str, int len = -1 ) -</h3> -Sets this string to <em>str</em>, interpreted as a classic Latin-1 C -string. If <em>len</em> is -1 (the default), then it is set to -strlen(str). -<p> If <em>str</em> is 0 a null string is created. If <em>str</em> is "", an empty -string is created. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>void <a name="setLength"></a>TQString::setLength ( uint newLen ) -</h3> -Ensures that at least <em>newLen</em> characters are allocated to the -string, and sets the length of the string to <em>newLen</em>. Any new -space allocated contains arbitrary data. -<p> <p>See also <a href="#reserve">reserve</a>() and <a href="#truncate">truncate</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum"></a>TQString::setNum ( Q_LLONG n, int base = 10 ) -</h3> -Sets the string to the printed value of <em>n</em> in base <em>base</em> and -returns a reference to the string. The returned string is in "C" locale. -<p> The base is 10 by default and must be between 2 and 36. -<p> <pre> - TQString string; - string = string.<a href="#setNum">setNum</a>( 1234 ); // string == "1234" - </pre> - - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-2"></a>TQString::setNum ( short n, int base = 10 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and -returns a reference to the string. -<p> The base is 10 by default and must be between 2 and 36. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-3"></a>TQString::setNum ( ushort n, int base = 10 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and -returns a reference to the string. -<p> The base is 10 by default and must be between 2 and 36. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-4"></a>TQString::setNum ( int n, int base = 10 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and -returns a reference to the string. -<p> The base is 10 by default and must be between 2 and 36. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-5"></a>TQString::setNum ( uint n, int base = 10 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and -returns a reference to the string. -<p> The base is 10 by default and must be between 2 and 36. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-6"></a>TQString::setNum ( long n, int base = 10 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-7"></a>TQString::setNum ( ulong n, int base = 10 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-8"></a>TQString::setNum ( Q_ULLONG n, int base = 10 ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the string to the printed value of <em>n</em> in base <em>base</em> and -returns a reference to the string. -<p> The base is 10 by default and must be between 2 and 36. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-9"></a>TQString::setNum ( float n, char f = 'g', int prec = 6 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the string to the printed value of <em>n</em>, formatted in format -<em>f</em> with precision <em>prec</em>, and returns a reference to the -string. -<p> The format <em>f</em> can be 'f', 'F', 'e', 'E', 'g' or 'G'. See <a href="#arg-formats">arg</a>() for an explanation of the formats. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setNum-a"></a>TQString::setNum ( double n, char f = 'g', int prec = 6 ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Sets the string to the printed value of <em>n</em>, formatted in format -<em>f</em> with precision <em>prec</em>, and returns a reference to the -string. -<p> The format <em>f</em> can be 'f', 'F', 'e', 'E', 'g' or 'G'. See <a href="#arg-formats">arg</a>() for an explanation of the formats. - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setUnicode"></a>TQString::setUnicode ( const <a href="qchar.html">TQChar</a> * unicode, uint len ) -</h3> -Resizes the string to <em>len</em> characters and copies <em>unicode</em> into -the string. If <em>unicode</em> is 0, nothing is copied, but the -string is still resized to <em>len</em>. If <em>len</em> is zero, then the -string becomes a <a href="#isNull">null</a> string. -<p> <p>See also <a href="#setLatin1">setLatin1</a>() and <a href="#isNull">isNull</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="setUnicodeCodes"></a>TQString::setUnicodeCodes ( const ushort * unicode_as_ushorts, uint len ) -</h3> -Resizes the string to <em>len</em> characters and copies <em>unicode_as_ushorts</em> into the string (on some X11 client platforms -this will involve a byte-swapping pass). -<p> If <em>unicode_as_ushorts</em> is 0, nothing is copied, but the string -is still resized to <em>len</em>. If <em>len</em> is zero, the string becomes -a <a href="#isNull">null</a> string. -<p> <p>See also <a href="#setLatin1">setLatin1</a>() and <a href="#isNull">isNull</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="simplifyWhiteSpace"></a>TQString::simplifyWhiteSpace () const -</h3> -Returns a string that has whitespace removed from the start and -the end, and which has each sequence of internal whitespace -replaced with a single space. -<p> Whitespace means any character for which <a href="qchar.html#isSpace">TQChar::isSpace</a>() returns -TRUE. This includes Unicode characters with decimal values 9 -(TAB), 10 (LF), 11 (VT), 12 (FF), 13 (CR), and 32 (Space). -<p> <pre> - TQString string = " lots\t of\nwhite space "; - TQString t = string.<a href="#simplifyWhiteSpace">simplifyWhiteSpace</a>(); - // t == "lots of white space" - </pre> - -<p> <p>See also <a href="#stripWhiteSpace">stripWhiteSpace</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> & <a name="sprintf"></a>TQString::sprintf ( const char * cformat, ... ) -</h3> -Safely builds a formatted string from the format string <em>cformat</em> -and an arbitrary list of arguments. The format string supports all -the escape sequences of printf() in the standard C library. -<p> The %s escape sequence expects a <a href="#utf8">utf8</a>() encoded string. The format -string <em>cformat</em> is expected to be in latin1. If you need a -Unicode format string, use <a href="#arg">arg</a>() instead. For typesafe string -building, with full Unicode support, you can use <a href="qtextostream.html">TQTextOStream</a> like -this: -<p> <pre> - TQString str; - TQString s = ...; - int x = ...; - TQTextOStream( &str ) << s << " : " << x; - </pre> - -<p> For <a href="qobject.html#tr">translations,</a> especially if the -strings contains more than one escape sequence, you should -consider using the arg() function instead. This allows the order -of the replacements to be controlled by the translator, and has -Unicode support. -<p> The %lc escape sequence expects a unicode character of type ushort -(as returned by <a href="qchar.html#unicode">TQChar::unicode</a>()). -The %ls escape sequence expects a pointer to a zero-terminated -array of unicode characters of type ushort (as returned by -<a href="#ucs2">TQString::ucs2</a>()). -<p> <p>See also <a href="#arg">arg</a>(). - -<p>Examples: <a href="dclock-example.html#x1103">dclock/dclock.cpp</a>, <a href="forever-example.html#x1052">forever/forever.cpp</a>, <a href="layout-example.html#x542">layout/layout.cpp</a>, <a href="qmag-example.html#x1795">qmag/qmag.cpp</a>, <a href="scrollview-example.html#x656">scrollview/scrollview.cpp</a>, <a href="tooltip-example.html#x449">tooltip/tooltip.cpp</a>, and <a href="xform-example.html#x1265">xform/xform.cpp</a>. -<h3 class=fn>void <a name="squeeze"></a>TQString::squeeze () -</h3> -Squeezes the string's capacity to the current content. -<p> <p>See also <a href="#capacity">capacity</a>() and <a href="#reserve">reserve</a>(). - -<h3 class=fn>bool <a name="startsWith"></a>TQString::startsWith ( const <a href="qstring.html">TQString</a> & s, bool cs = TRUE ) const -</h3> -Returns TRUE if the string starts with <em>s</em>; otherwise returns -FALSE. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; -otherwise the search is case insensitive. -<p> <pre> - TQString str( "Bananas" ); - str.<a href="#startsWith">startsWith</a>( "Ban" ); // returns TRUE - str.<a href="#startsWith">startsWith</a>( "Car" ); // returns FALSE - </pre> - -<p> <p>See also <a href="#endsWith">endsWith</a>(). - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="stripWhiteSpace"></a>TQString::stripWhiteSpace () const -</h3> -Returns a string that has whitespace removed from the start and -the end. -<p> Whitespace means any character for which <a href="qchar.html#isSpace">TQChar::isSpace</a>() returns -TRUE. This includes Unicode characters with decimal values 9 -(TAB), 10 (LF), 11 (VT), 12 (FF), 13 (CR) and 32 (Space), and may -also include other Unicode characters. -<p> <pre> - TQString string = " white space "; - TQString s = string.<a href="#stripWhiteSpace">stripWhiteSpace</a>(); // s == "white space" - </pre> - -<p> <p>See also <a href="#simplifyWhiteSpace">simplifyWhiteSpace</a>(). - -<h3 class=fn>double <a name="toDouble"></a>TQString::toDouble ( bool * ok = 0 ) const -</h3> -Returns the string converted to a <tt>double</tt> value. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> <pre> - TQString string( "1234.56" ); - double a = string.<a href="#toDouble">toDouble</a>(); // a == 1234.56 - </pre> - -<p> The string-to-number functions: -<ul> -<li> <a href="#toShort">toShort</a>() -<li> <a href="#toUShort">toUShort</a>() -<li> <a href="#toInt">toInt</a>() -<li> <a href="#toUInt">toUInt</a>() -<li> <a href="#toLong">toLong</a>() -<li> <a href="#toULong">toULong</a>() -<li> <a href="#toLongLong">toLongLong</a>() -<li> <a href="#toULongLong">toULongLong</a>() -<li> <a href="#toFloat">toFloat</a>() -<li> <a href="#toDouble">toDouble</a>() -</ul> -can handle numbers -represented in various locales. These representations may use different -characters for the decimal point, thousands group sepearator -and even individual digits. TQString's functions try to interpret -the string according to the current locale. The current locale is -determined from the system at application startup and can be changed -by calling <a href="qlocale.html#setDefault">TQLocale::setDefault</a>(). If the string cannot be interpreted -according to the current locale, this function falls back -on the "C" locale. -<p> <pre> - bool ok; - double d; - - TQLocale::<a href="qlocale.html#setDefault">setDefault</a>(TQLocale::C); - d = <a href="#TQString">TQString</a>( "1234,56" ).toDouble(&ok); // ok == false - d = <a href="#TQString">TQString</a>( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56 - - TQLocale::<a href="qlocale.html#setDefault">setDefault</a>(TQLocale::German); - d = <a href="#TQString">TQString</a>( "1234,56" ).toDouble(&ok); // ok == true, d == 1234.56 - d = <a href="#TQString">TQString</a>( "1234.56" ).toDouble(&ok); // ok == true, d == 1234.56 - </pre> - -<p> Due to the ambiguity between the decimal point and thousands group -separator in various locales, these functions do not handle -thousands group separators. If you need to convert such numbers, -use the corresponding function in <a href="qlocale.html">TQLocale</a>. -<p> <pre> - bool ok; - TQLocale::<a href="qlocale.html#setDefault">setDefault</a>(TQLocale::C); - double d = <a href="#TQString">TQString</a>( "1,234,567.89" ).toDouble(&ok); // ok == false - </pre> - -<p> <b>Warning:</b> If the string contains trailing whitespace this function -will fail, and set <em>*ok</em> to false if <em>ok</em> is not 0. Leading -whitespace is ignored. -<p> <p>See also <a href="#number">number</a>(), <a href="qlocale.html#setDefault">TQLocale::setDefault</a>(), <a href="qlocale.html#toDouble">TQLocale::toDouble</a>(), and <a href="#stripWhiteSpace">stripWhiteSpace</a>(). - -<h3 class=fn>float <a name="toFloat"></a>TQString::toFloat ( bool * ok = 0 ) const -</h3> -Returns the string converted to a <tt>float</tt> value. -<p> Returns 0.0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <b>Warning:</b> If the string contains trailing whitespace this function -will fail, settings <em>*ok</em> to false if <em>ok</em> is not 0. -Leading whitespace is ignored. -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>int <a name="toInt"></a>TQString::toInt ( bool * ok = 0, int base = 10 ) const -</h3> -Returns the string converted to an <tt>int</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If -<em>base</em> is 0, the base is determined automatically using the -following rules: -<ul> -<li>If the string begins with "0x", it is assumed to -be hexadecimal; -<li>If it begins with "0", it is assumed to be octal; -<li>Otherwise it is assumed to be decimal. -</ul> -<p> Returns 0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> <pre> - TQString str( "FF" ); - bool ok; - int hex = str.<a href="#toInt">toInt</a>( &ok, 16 ); // hex == 255, ok == TRUE - int dec = str.<a href="#toInt">toInt</a>( &ok, 10 ); // dec == 0, ok == FALSE - </pre> - -<p> Leading and trailing whitespace is ignored by this function. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>long <a name="toLong"></a>TQString::toLong ( bool * ok = 0, int base = 10 ) const -</h3> -Returns the string converted to a <tt>long</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If -<em>base</em> is 0, the base is determined automatically using the -following rules: -<ul> -<li>If the string begins with "0x", it is assumed to -be hexadecimal; -<li>If it begins with "0", it is assumed to be octal; -<li>Otherwise it is assumed to be decimal. -</ul> -<p> Returns 0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> Leading and trailing whitespace is ignored by this function. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>Q_LLONG <a name="toLongLong"></a>TQString::toLongLong ( bool * ok = 0, int base = 10 ) const -</h3> -Returns the string converted to a <tt>long long</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If -<em>base</em> is 0, the base is determined automatically using the -following rules: -<ul> -<li>If the string begins with "0x", it is assumed to -be hexadecimal; -<li>If it begins with "0", it is assumed to be octal; -<li>Otherwise it is assumed to be decimal. -</ul> -<p> Returns 0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> Leading and trailing whitespace is ignored by this function. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>short <a name="toShort"></a>TQString::toShort ( bool * ok = 0, int base = 10 ) const -</h3> -Returns the string converted to a <tt>short</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If -<em>base</em> is 0, the base is determined automatically using the -following rules: -<ul> -<li>If the string begins with "0x", it is assumed to -be hexadecimal; -<li>If it begins with "0", it is assumed to be octal; -<li>Otherwise it is assumed to be decimal. -</ul> -<p> Returns 0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> Leading and trailing whitespace is ignored by this function. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>uint <a name="toUInt"></a>TQString::toUInt ( bool * ok = 0, int base = 10 ) const -</h3> -Returns the string converted to an <tt>unsigned int</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If -<em>base</em> is 0, the base is determined automatically using the -following rules: -<ul> -<li>If the string begins with "0x", it is assumed to -be hexadecimal; -<li>If it begins with "0", it is assumed to be octal; -<li>Otherwise it is assumed to be decimal. -</ul> -<p> Returns 0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> Leading and trailing whitespace is ignored by this function. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>ulong <a name="toULong"></a>TQString::toULong ( bool * ok = 0, int base = 10 ) const -</h3> -Returns the string converted to an <tt>unsigned long</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If -<em>base</em> is 0, the base is determined automatically using the -following rules: -<ul> -<li>If the string begins with "0x", it is assumed to -be hexadecimal; -<li>If it begins with "0", it is assumed to be octal; -<li>Otherwise it is assumed to be decimal. -</ul> -<p> Returns 0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> Leading and trailing whitespace is ignored by this function. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>Q_ULLONG <a name="toULongLong"></a>TQString::toULongLong ( bool * ok = 0, int base = 10 ) const -</h3> -Returns the string converted to an <tt>unsigned long long</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If -<em>base</em> is 0, the base is determined automatically using the -following rules: -<ul> -<li>If the string begins with "0x", it is assumed to -be hexadecimal; -<li>If it begins with "0", it is assumed to be octal; -<li>Otherwise it is assumed to be decimal. -</ul> -<p> Returns 0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> Leading and trailing whitespace is ignored by this function. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>ushort <a name="toUShort"></a>TQString::toUShort ( bool * ok = 0, int base = 10 ) const -</h3> -Returns the string converted to an <tt>unsigned short</tt> using base <em>base</em>, which is 10 by default and must be between 2 and 36 or 0. If -<em>base</em> is 0, the base is determined automatically using the -following rules: -<ul> -<li>If the string begins with "0x", it is assumed to -be hexadecimal; -<li>If it begins with "0", it is assumed to be octal; -<li>Otherwise it is assumed to be decimal. -</ul> -<p> Returns 0 if the conversion fails. -<p> If <em>ok</em> is not 0: if a conversion error occurs, <em>*ok</em> is set to -FALSE; otherwise <em>*ok</em> is set to TRUE. -<p> Leading and trailing whitespace is ignored by this function. -<p> For information on how string-to-number functions in TQString handle -localized input, see <a href="#toDouble">toDouble</a>(). -<p> <p>See also <a href="#number">number</a>(). - -<h3 class=fn>void <a name="truncate"></a>TQString::truncate ( uint newLen ) -</h3> -If <em>newLen</em> is less than the length of the string, then the -string is truncated at position <em>newLen</em>. Otherwise nothing -happens. -<p> <pre> - TQString s = "truncate me"; - s.<a href="#truncate">truncate</a>( 5 ); // s == "trunc" - </pre> - -<p> <p>See also <a href="#setLength">setLength</a>(). - -<p>Example: <a href="mail-example.html#x718">network/mail/smtp.cpp</a>. -<h3 class=fn>const unsigned short * <a name="ucs2"></a>TQString::ucs2 () const -</h3> -Returns the TQString as a zero terminated array of unsigned shorts -if the string is not null; otherwise returns zero. -<p> The result remains valid so long as one unmodified -copy of the source string exists. - -<p>Example: <a href="activeqt-dotnet.html#x2467">dotnet/wrapper/lib/tools.cpp</a>. -<h3 class=fn>const <a href="qchar.html">TQChar</a> * <a name="unicode"></a>TQString::unicode () const -</h3> - -<p> Returns the Unicode representation of the string. The result -remains valid until the string is modified. - -<h3 class=fn><a href="qstring.html">TQString</a> <a name="upper"></a>TQString::upper () const -</h3> -Returns an uppercase copy of the string. -<p> <pre> - TQString string( "TeXt" ); - str = string.<a href="#upper">upper</a>(); // t == "TEXT" - </pre> - -<p> <p>See also <a href="#lower">lower</a>(). - -<p>Examples: <a href="scribble-example.html#x942">scribble/scribble.cpp</a> and <a href="sql.html#x2240">sql/overview/custom1/main.cpp</a>. -<h3 class=fn><a href="qcstring.html">TQCString</a> <a name="utf8"></a>TQString::utf8 () const -</h3> -Returns the string encoded in UTF-8 format. -<p> See <a href="qtextcodec.html">TQTextCodec</a> for more diverse coding/decoding of Unicode strings. -<p> <p>See also <a href="#fromUtf8">fromUtf8</a>(), <a href="#ascii">ascii</a>(), <a href="#latin1">latin1</a>(), and <a href="#local8Bit">local8Bit</a>(). - -<p>Example: <a href="archivesearch-example.html#x483">network/archivesearch/archivedialog.ui.h</a>. -<hr><h2>Related Functions</h2> -<h3 class=fn>bool <a name="operator!-eq"></a>operator!= ( const <a href="qstring.html">TQString</a> & s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> -<p> Returns TRUE if <em>s1</em> is not equal to <em>s2</em>; otherwise returns FALSE. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) != 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>bool <a name="operator!-eq-2"></a>operator!= ( const <a href="qstring.html">TQString</a> & s1, const char * s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns TRUE if <em>s1</em> is not equal to <em>s2</em>; otherwise returns FALSE. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) != 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>bool <a name="operator!-eq-3"></a>operator!= ( const char * s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns TRUE if <em>s1</em> is not equal to <em>s2</em>; otherwise returns FALSE. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) != 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>const <a href="qstring.html">TQString</a> <a name="operator+"></a>operator+ ( const <a href="qstring.html">TQString</a> & s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> -<p> Returns a string which is the result of concatenating the string -<em>s1</em> and the string <em>s2</em>. -<p> Equivalent to <em>s1</em>.<a href="#append">append</a>(<em>s2</em>). - -<h3 class=fn>const <a href="qstring.html">TQString</a> <a name="operator+-2"></a>operator+ ( const <a href="qstring.html">TQString</a> & s1, const char * s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns a string which is the result of concatenating the string -<em>s1</em> and character <em>s2</em>. -<p> Equivalent to <em>s1</em>.<a href="#append">append</a>(<em>s2</em>). - -<h3 class=fn>const <a href="qstring.html">TQString</a> <a name="operator+-3"></a>operator+ ( const char * s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns a string which is the result of concatenating the -character <em>s1</em> and string <em>s2</em>. - -<h3 class=fn>const <a href="qstring.html">TQString</a> <a name="operator+-4"></a>operator+ ( const <a href="qstring.html">TQString</a> & s, char c ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns a string which is the result of concatenating the string -<em>s</em> and character <em>c</em>. -<p> Equivalent to <em>s</em>.<a href="#append">append</a>(<em>c</em>). - -<h3 class=fn>const <a href="qstring.html">TQString</a> <a name="operator+-5"></a>operator+ ( char c, const <a href="qstring.html">TQString</a> & s ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns a string which is the result of concatenating the -character <em>c</em> and string <em>s</em>. -<p> Equivalent to <em>s</em>.<a href="#prepend">prepend</a>(<em>c</em>). - -<h3 class=fn>bool <a name="operator-lt"></a>operator< ( const <a href="qstring.html">TQString</a> & s1, const char * s2 ) -</h3> - -<p> -<p> Returns TRUE if <em>s1</em> is lexically less than <em>s2</em>; otherwise returns FALSE. -The comparison is case sensitive. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) < 0. - -<h3 class=fn>bool <a name="operator-lt-2"></a>operator< ( const char * s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns TRUE if <em>s1</em> is lexically less than <em>s2</em>; otherwise returns FALSE. -The comparison is case sensitive. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) < 0. - -<h3 class=fn><a href="qdatastream.html">TQDataStream</a> & <a name="operator-lt-lt"></a>operator<< ( <a href="qdatastream.html">TQDataStream</a> & s, const <a href="qstring.html">TQString</a> & str ) -</h3> - -<p> Writes the string <em>str</em> to the stream <em>s</em>. -<p> See also <a href="datastreamformat.html">Format of the TQDataStream operators</a> - -<h3 class=fn>bool <a name="operator-lt-eq"></a>operator<= ( const <a href="qstring.html">TQString</a> & s1, const char * s2 ) -</h3> - -<p> -<p> Returns TRUE if <em>s1</em> is lexically less than or equal to <em>s2</em>; -otherwise returns FALSE. -The comparison is case sensitive. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>,<em>s2</em>) <= 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>bool <a name="operator-lt-eq-2"></a>operator<= ( const char * s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns TRUE if <em>s1</em> is lexically less than or equal to <em>s2</em>; -otherwise returns FALSE. -The comparison is case sensitive. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) <= 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>bool <a name="operator-eq-eq"></a>operator== ( const <a href="qstring.html">TQString</a> & s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> -<p> Returns TRUE if <em>s1</em> is equal to <em>s2</em>; otherwise returns FALSE. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) == 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>bool <a name="operator-eq-eq-2"></a>operator== ( const <a href="qstring.html">TQString</a> & s1, const char * s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns TRUE if <em>s1</em> is equal to <em>s2</em>; otherwise returns FALSE. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) == 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>bool <a name="operator-eq-eq-3"></a>operator== ( const char * s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns TRUE if <em>s1</em> is equal to <em>s2</em>; otherwise returns FALSE. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) == 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>bool <a name="operator-gt"></a>operator> ( const <a href="qstring.html">TQString</a> & s1, const char * s2 ) -</h3> - -<p> -<p> Returns TRUE if <em>s1</em> is lexically greater than <em>s2</em>; otherwise -returns FALSE. -The comparison is case sensitive. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) > 0. - -<h3 class=fn>bool <a name="operator-gt-2"></a>operator> ( const char * s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns TRUE if <em>s1</em> is lexically greater than <em>s2</em>; otherwise -returns FALSE. -The comparison is case sensitive. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) > 0. - -<h3 class=fn>bool <a name="operator-gt-eq"></a>operator>= ( const <a href="qstring.html">TQString</a> & s1, const char * s2 ) -</h3> - -<p> -<p> Returns TRUE if <em>s1</em> is lexically greater than or equal to <em>s2</em>; -otherwise returns FALSE. -The comparison is case sensitive. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) >= 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn>bool <a name="operator-gt-eq-2"></a>operator>= ( const char * s1, const <a href="qstring.html">TQString</a> & s2 ) -</h3> - -<p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> -<p> Returns TRUE if <em>s1</em> is lexically greater than or equal to <em>s2</em>; -otherwise returns FALSE. -The comparison is case sensitive. -Note that a null string is not equal to a not-null empty string. -<p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) >= 0. -<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>(). - -<h3 class=fn><a href="qdatastream.html">TQDataStream</a> & <a name="operator-gt-gt"></a>operator>> ( <a href="qdatastream.html">TQDataStream</a> & s, <a href="qstring.html">TQString</a> & str ) -</h3> - -<p> Reads a string from the stream <em>s</em> into string <em>str</em>. -<p> See also <a href="datastreamformat.html">Format of the TQDataStream operators</a> - -<!-- eof --> -<hr><p> -This file is part of the <a href="index.html">TQt toolkit</a>. -Copyright © 1995-2007 -<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<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>TQt 3.3.8</div> -</table></div></address></body> -</html> |