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

2441 lines
144 KiB

<!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&nbsp;Classes</font></a>
| <a href="mainclasses.html">
<font color="#004faf">Main&nbsp;Classes</font></a>
| <a href="annotated.html">
<font color="#004faf">Annotated</font></a>
| <a href="groups.html">
<font color="#004faf">Grouped&nbsp;Classes</font></a>
| <a href="functions.html">
<font color="#004faf">Functions</font></a>
</td>
<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQString Class Reference</h1>
<p>The TQString class provides an abstraction of Unicode text
and the classic C '&#92;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 &lt;<a href="qstring-h.html">ntqstring.h</a>&gt;</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&nbsp;ch )</li>
<li class=fn><a href="#TQString-3"><b>TQString</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s )</li>
<li class=fn><a href="#TQString-4"><b>TQString</b></a> ( const&nbsp;TQByteArray&nbsp;&amp;&nbsp;ba )</li>
<li class=fn><a href="#TQString-5"><b>TQString</b></a> ( const&nbsp;TQChar&nbsp;*&nbsp;unicode, uint&nbsp;length )</li>
<li class=fn><a href="#TQString-6"><b>TQString</b></a> ( const&nbsp;char&nbsp;*&nbsp;str )</li>
<li class=fn><a href="#TQString-7"><b>TQString</b></a> ( const&nbsp;std::string&nbsp;&amp;&nbsp;str )</li>
<li class=fn><a href="#~TQString"><b>~TQString</b></a> ()</li>
<li class=fn>TQString &amp; <a href="#operator-eq-2"><b>operator=</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#operator-eq-3"><b>operator=</b></a> ( const&nbsp;char&nbsp;*&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#operator-eq-4"><b>operator=</b></a> ( const&nbsp;std::string&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#operator-eq-5"><b>operator=</b></a> ( const&nbsp;TQCString&nbsp;&amp;&nbsp;cstr )</li>
<li class=fn>TQString &amp; <a href="#operator-eq"><b>operator=</b></a> ( TQChar&nbsp;c )</li>
<li class=fn>TQString &amp; <a href="#operator-eq-6"><b>operator=</b></a> ( char&nbsp;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&nbsp;newLen )</li>
<li class=fn>TQString &amp; <a href="#fill"><b>fill</b></a> ( TQChar&nbsp;c, int&nbsp;len = -1 )</li>
<li class=fn>TQString copy () const &nbsp;<em>(obsolete)</em></li>
<li class=fn>TQString <a href="#arg-2"><b>arg</b></a> ( long&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQString <a href="#arg-3"><b>arg</b></a> ( ulong&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQString <a href="#arg-4"><b>arg</b></a> ( TQ_LLONG&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQString <a href="#arg-5"><b>arg</b></a> ( TQ_ULLONG&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQString <a href="#arg-6"><b>arg</b></a> ( int&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQString <a href="#arg-7"><b>arg</b></a> ( uint&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQString <a href="#arg-8"><b>arg</b></a> ( short&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQString <a href="#arg-9"><b>arg</b></a> ( ushort&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQString <a href="#arg-a"><b>arg</b></a> ( double&nbsp;a, int&nbsp;fieldWidth = 0, char&nbsp;fmt = 'g', int&nbsp;prec = -1 ) const</li>
<li class=fn>TQString <a href="#arg-b"><b>arg</b></a> ( char&nbsp;a, int&nbsp;fieldWidth = 0 ) const</li>
<li class=fn>TQString <a href="#arg-c"><b>arg</b></a> ( TQChar&nbsp;a, int&nbsp;fieldWidth = 0 ) const</li>
<li class=fn>TQString <a href="#arg"><b>arg</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;a, int&nbsp;fieldWidth = 0 ) const</li>
<li class=fn>TQString <a href="#arg-d"><b>arg</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;a1, const&nbsp;TQString&nbsp;&amp;&nbsp;a2 ) const</li>
<li class=fn>TQString <a href="#arg-e"><b>arg</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;a1, const&nbsp;TQString&nbsp;&amp;&nbsp;a2, const&nbsp;TQString&nbsp;&amp;&nbsp;a3 ) const</li>
<li class=fn>TQString <a href="#arg-f"><b>arg</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;a1, const&nbsp;TQString&nbsp;&amp;&nbsp;a2, const&nbsp;TQString&nbsp;&amp;&nbsp;a3, const&nbsp;TQString&nbsp;&amp;&nbsp;a4 ) const</li>
<li class=fn>TQString &amp; <a href="#sprintf"><b>sprintf</b></a> ( const&nbsp;char&nbsp;*&nbsp;cformat, ... )</li>
<li class=fn>int <a href="#find-2"><b>find</b></a> ( TQChar&nbsp;c, int&nbsp;index = 0, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#find-3"><b>find</b></a> ( char&nbsp;c, int&nbsp;index = 0, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#find-4"><b>find</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;str, int&nbsp;index = 0, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#find"><b>find</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;rx, int&nbsp;index = 0 ) const</li>
<li class=fn>int <a href="#find-5"><b>find</b></a> ( const&nbsp;char&nbsp;*&nbsp;str, int&nbsp;index = 0 ) const</li>
<li class=fn>int <a href="#findRev-2"><b>findRev</b></a> ( TQChar&nbsp;c, int&nbsp;index = -1, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#findRev-3"><b>findRev</b></a> ( char&nbsp;c, int&nbsp;index = -1, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#findRev-4"><b>findRev</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;str, int&nbsp;index = -1, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#findRev-5"><b>findRev</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;rx, int&nbsp;index = -1 ) const</li>
<li class=fn>int <a href="#findRev"><b>findRev</b></a> ( const&nbsp;char&nbsp;*&nbsp;str, int&nbsp;index = -1 ) const</li>
<li class=fn>int <a href="#contains"><b>contains</b></a> ( TQChar&nbsp;c, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#contains-2"><b>contains</b></a> ( char&nbsp;c, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#contains-3"><b>contains</b></a> ( const&nbsp;char&nbsp;*&nbsp;str, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#contains-4"><b>contains</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;str, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>int <a href="#contains-5"><b>contains</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;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&nbsp;sep, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;flags = SectionDefault ) const</li>
<li class=fn>TQString <a href="#section-2"><b>section</b></a> ( char&nbsp;sep, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;flags = SectionDefault ) const</li>
<li class=fn>TQString <a href="#section-3"><b>section</b></a> ( const&nbsp;char&nbsp;*&nbsp;sep, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;flags = SectionDefault ) const</li>
<li class=fn>TQString <a href="#section-4"><b>section</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;sep, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;flags = SectionDefault ) const</li>
<li class=fn>TQString <a href="#section-5"><b>section</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;reg, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;flags = SectionDefault ) const</li>
<li class=fn>TQString <a href="#left"><b>left</b></a> ( uint&nbsp;len ) const</li>
<li class=fn>TQString <a href="#right"><b>right</b></a> ( uint&nbsp;len ) const</li>
<li class=fn>TQString <a href="#mid"><b>mid</b></a> ( uint&nbsp;index, uint&nbsp;len = 0xffffffff ) const</li>
<li class=fn>TQString <a href="#leftJustify"><b>leftJustify</b></a> ( uint&nbsp;width, TQChar&nbsp;fill = ' ', bool&nbsp;truncate = FALSE ) const</li>
<li class=fn>TQString <a href="#rightJustify"><b>rightJustify</b></a> ( uint&nbsp;width, TQChar&nbsp;fill = ' ', bool&nbsp;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 &amp; <a href="#insert"><b>insert</b></a> ( uint&nbsp;index, const&nbsp;TQString&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#insert-2"><b>insert</b></a> ( uint&nbsp;index, const&nbsp;TQByteArray&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#insert-3"><b>insert</b></a> ( uint&nbsp;index, const&nbsp;char&nbsp;*&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#insert-4"><b>insert</b></a> ( uint&nbsp;index, const&nbsp;TQChar&nbsp;*&nbsp;s, uint&nbsp;len )</li>
<li class=fn>TQString &amp; <a href="#insert-5"><b>insert</b></a> ( uint&nbsp;index, TQChar&nbsp;c )</li>
<li class=fn>TQString &amp; <a href="#insert-6"><b>insert</b></a> ( uint&nbsp;index, char&nbsp;c )</li>
<li class=fn>TQString &amp; <a href="#append-2"><b>append</b></a> ( char&nbsp;ch )</li>
<li class=fn>TQString &amp; <a href="#append-3"><b>append</b></a> ( TQChar&nbsp;ch )</li>
<li class=fn>TQString &amp; <a href="#append"><b>append</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#append-4"><b>append</b></a> ( const&nbsp;TQByteArray&nbsp;&amp;&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#append-5"><b>append</b></a> ( const&nbsp;char&nbsp;*&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#append-6"><b>append</b></a> ( const&nbsp;std::string&nbsp;&amp;&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#prepend-2"><b>prepend</b></a> ( char&nbsp;ch )</li>
<li class=fn>TQString &amp; <a href="#prepend-3"><b>prepend</b></a> ( TQChar&nbsp;ch )</li>
<li class=fn>TQString &amp; <a href="#prepend"><b>prepend</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#prepend-4"><b>prepend</b></a> ( const&nbsp;TQByteArray&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#prepend-5"><b>prepend</b></a> ( const&nbsp;char&nbsp;*&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#prepend-6"><b>prepend</b></a> ( const&nbsp;std::string&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#remove"><b>remove</b></a> ( uint&nbsp;index, uint&nbsp;len )</li>
<li class=fn>TQString &amp; <a href="#remove-2"><b>remove</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;str, bool&nbsp;cs = TRUE )</li>
<li class=fn>TQString &amp; <a href="#remove-3"><b>remove</b></a> ( TQChar&nbsp;c )</li>
<li class=fn>TQString &amp; <a href="#remove-4"><b>remove</b></a> ( char&nbsp;c )</li>
<li class=fn>TQString &amp; <a href="#remove-5"><b>remove</b></a> ( const&nbsp;char&nbsp;*&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#remove-6"><b>remove</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;rx )</li>
<li class=fn>TQString &amp; <a href="#replace"><b>replace</b></a> ( uint&nbsp;index, uint&nbsp;len, const&nbsp;TQString&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQString &amp; <a href="#replace-2"><b>replace</b></a> ( uint&nbsp;index, uint&nbsp;len, const&nbsp;TQChar&nbsp;*&nbsp;s, uint&nbsp;slen )</li>
<li class=fn>TQString &amp; <a href="#replace-3"><b>replace</b></a> ( uint&nbsp;index, uint&nbsp;len, TQChar&nbsp;c )</li>
<li class=fn>TQString &amp; <a href="#replace-4"><b>replace</b></a> ( uint&nbsp;index, uint&nbsp;len, char&nbsp;c )</li>
<li class=fn>TQString &amp; <a href="#replace-5"><b>replace</b></a> ( TQChar&nbsp;c, const&nbsp;TQString&nbsp;&amp;&nbsp;after, bool&nbsp;cs = TRUE )</li>
<li class=fn>TQString &amp; <a href="#replace-6"><b>replace</b></a> ( char&nbsp;c, const&nbsp;TQString&nbsp;&amp;&nbsp;after, bool&nbsp;cs = TRUE )</li>
<li class=fn>TQString &amp; <a href="#replace-7"><b>replace</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;before, const&nbsp;TQString&nbsp;&amp;&nbsp;after, bool&nbsp;cs = TRUE )</li>
<li class=fn>TQString &amp; <a href="#replace-8"><b>replace</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;rx, const&nbsp;TQString&nbsp;&amp;&nbsp;after )</li>
<li class=fn>TQString &amp; <a href="#replace-9"><b>replace</b></a> ( TQChar&nbsp;c1, TQChar&nbsp;c2 )</li>
<li class=fn>short <a href="#toShort"><b>toShort</b></a> ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>ushort <a href="#toUShort"><b>toUShort</b></a> ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>int <a href="#toInt"><b>toInt</b></a> ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>uint <a href="#toUInt"><b>toUInt</b></a> ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>long <a href="#toLong"><b>toLong</b></a> ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>ulong <a href="#toULong"><b>toULong</b></a> ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQ_LLONG <a href="#toLongLong"><b>toLongLong</b></a> ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>TQ_ULLONG <a href="#toULongLong"><b>toULongLong</b></a> ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;base = 10 ) const</li>
<li class=fn>float <a href="#toFloat"><b>toFloat</b></a> ( bool&nbsp;*&nbsp;ok = 0 ) const</li>
<li class=fn>double <a href="#toDouble"><b>toDouble</b></a> ( bool&nbsp;*&nbsp;ok = 0 ) const</li>
<li class=fn>TQString &amp; <a href="#setNum-2"><b>setNum</b></a> ( short&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString &amp; <a href="#setNum-3"><b>setNum</b></a> ( ushort&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString &amp; <a href="#setNum-4"><b>setNum</b></a> ( int&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString &amp; <a href="#setNum-5"><b>setNum</b></a> ( uint&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString &amp; <a href="#setNum-6"><b>setNum</b></a> ( long&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString &amp; <a href="#setNum-7"><b>setNum</b></a> ( ulong&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString &amp; <a href="#setNum"><b>setNum</b></a> ( TQ_LLONG&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString &amp; <a href="#setNum-8"><b>setNum</b></a> ( TQ_ULLONG&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString &amp; <a href="#setNum-9"><b>setNum</b></a> ( float&nbsp;n, char&nbsp;f = 'g', int&nbsp;prec = 6 )</li>
<li class=fn>TQString &amp; <a href="#setNum-a"><b>setNum</b></a> ( double&nbsp;n, char&nbsp;f = 'g', int&nbsp;prec = 6 )</li>
<li class=fn>void setExpand ( uint&nbsp;index, TQChar&nbsp;c ) &nbsp;<em>(obsolete)</em></li>
<li class=fn>TQString &amp; <a href="#operator+-eq"><b>operator+=</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#operator+-eq-2"><b>operator+=</b></a> ( const&nbsp;TQByteArray&nbsp;&amp;&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#operator+-eq-3"><b>operator+=</b></a> ( const&nbsp;char&nbsp;*&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#operator+-eq-4"><b>operator+=</b></a> ( const&nbsp;std::string&nbsp;&amp;&nbsp;str )</li>
<li class=fn>TQString &amp; <a href="#operator+-eq-5"><b>operator+=</b></a> ( TQChar&nbsp;c )</li>
<li class=fn>TQString &amp; <a href="#operator+-eq-6"><b>operator+=</b></a> ( char&nbsp;c )</li>
<li class=fn>TQChar <a href="#at"><b>at</b></a> ( uint&nbsp;i ) const</li>
<li class=fn>TQChar <a href="#operator[]"><b>operator[]</b></a> ( int&nbsp;i ) const</li>
<li class=fn>TQCharRef <a href="#at-2"><b>at</b></a> ( uint&nbsp;i )</li>
<li class=fn>TQCharRef <a href="#operator[]-2"><b>operator[]</b></a> ( int&nbsp;i )</li>
<li class=fn>TQChar <a href="#constref"><b>constref</b></a> ( uint&nbsp;i ) const</li>
<li class=fn>TQChar &amp; <a href="#ref"><b>ref</b></a> ( uint&nbsp;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 &amp; <a href="#setUnicode"><b>setUnicode</b></a> ( const&nbsp;TQChar&nbsp;*&nbsp;unicode, uint&nbsp;len )</li>
<li class=fn>TQString &amp; <a href="#setUnicodeCodes"><b>setUnicodeCodes</b></a> ( const&nbsp;ushort&nbsp;*&nbsp;unicode_as_ushorts, uint&nbsp;len )</li>
<li class=fn>TQString &amp; <a href="#setAscii"><b>setAscii</b></a> ( const&nbsp;char&nbsp;*&nbsp;str, int&nbsp;len = -1 )</li>
<li class=fn>TQString &amp; <a href="#setLatin1"><b>setLatin1</b></a> ( const&nbsp;char&nbsp;*&nbsp;str, int&nbsp;len = -1 )</li>
<li class=fn>int <a href="#compare-2"><b>compare</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s ) const</li>
<li class=fn>int <a href="#localeAwareCompare-2"><b>localeAwareCompare</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s ) const</li>
<li class=fn>void <a href="#compose"><b>compose</b></a> ()</li>
<li class=fn>const char * data () const &nbsp;<em>(obsolete)</em></li>
<li class=fn>bool <a href="#startsWith"><b>startsWith</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>bool <a href="#endsWith"><b>endsWith</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s, bool&nbsp;cs = TRUE ) const</li>
<li class=fn>void <a href="#setLength"><b>setLength</b></a> ( uint&nbsp;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&nbsp;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&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString <a href="#number-2"><b>number</b></a> ( ulong&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString <a href="#number-3"><b>number</b></a> ( TQ_LLONG&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString <a href="#number-4"><b>number</b></a> ( TQ_ULLONG&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString <a href="#number-5"><b>number</b></a> ( int&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString <a href="#number-6"><b>number</b></a> ( uint&nbsp;n, int&nbsp;base = 10 )</li>
<li class=fn>TQString <a href="#number-7"><b>number</b></a> ( double&nbsp;n, char&nbsp;f = 'g', int&nbsp;prec = 6 )</li>
<li class=fn>TQString <a href="#fromAscii"><b>fromAscii</b></a> ( const&nbsp;char&nbsp;*&nbsp;ascii, int&nbsp;len = -1 )</li>
<li class=fn>TQString <a href="#fromLatin1"><b>fromLatin1</b></a> ( const&nbsp;char&nbsp;*&nbsp;chars, int&nbsp;len = -1 )</li>
<li class=fn>TQString <a href="#fromUtf8"><b>fromUtf8</b></a> ( const&nbsp;char&nbsp;*&nbsp;utf8, int&nbsp;len = -1 )</li>
<li class=fn>TQString <a href="#fromLocal8Bit"><b>fromLocal8Bit</b></a> ( const&nbsp;char&nbsp;*&nbsp;local8Bit, int&nbsp;len = -1 )</li>
<li class=fn>TQString <a href="#fromUcs2"><b>fromUcs2</b></a> ( const&nbsp;unsigned&nbsp;short&nbsp;*&nbsp;str )</li>
<li class=fn>int <a href="#compare"><b>compare</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>int <a href="#localeAwareCompare"><b>localeAwareCompare</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
</ul>
<h2>Related Functions</h2>
<ul>
<li class=fn>bool <a href="#operator-eq-eq"><b>operator==</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-eq-eq-2"><b>operator==</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-eq-eq-3"><b>operator==</b></a> ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator!-eq"><b>operator!=</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator!-eq-2"><b>operator!=</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator!-eq-3"><b>operator!=</b></a> ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-lt"><b>operator&lt;</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-lt-2"><b>operator&lt;</b></a> ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-lt-eq"><b>operator&lt;=</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-lt-eq-2"><b>operator&lt;=</b></a> ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-gt"><b>operator&gt;</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-gt-2"><b>operator&gt;</b></a> ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-gt-eq"><b>operator&gt;=</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;s2 )</li>
<li class=fn>bool <a href="#operator-gt-eq-2"><b>operator&gt;=</b></a> ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>const TQString <a href="#operator+"><b>operator+</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>const TQString <a href="#operator+-2"><b>operator+</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;s2 )</li>
<li class=fn>const TQString <a href="#operator+-3"><b>operator+</b></a> ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;TQString&nbsp;&amp;&nbsp;s2 )</li>
<li class=fn>const TQString <a href="#operator+-4"><b>operator+</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;s, char&nbsp;c )</li>
<li class=fn>const TQString <a href="#operator+-5"><b>operator+</b></a> ( char&nbsp;c, const&nbsp;TQString&nbsp;&amp;&nbsp;s )</li>
<li class=fn>TQDataStream &amp; <a href="#operator-lt-lt"><b>operator&lt;&lt;</b></a> ( TQDataStream&nbsp;&amp;&nbsp;s, const&nbsp;TQString&nbsp;&amp;&nbsp;str )</li>
<li class=fn>TQDataStream &amp; <a href="#operator-gt-gt"><b>operator&gt;&gt;</b></a> ( TQDataStream&nbsp;&amp;&nbsp;s, TQString&nbsp;&amp;&nbsp;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 '&#92;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 '&#92;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
'&#92;0'-terminated, the results are undefined. Functions that copy
classic C strings into a TQString will not copy the terminating
'&#92;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 '&#92;0'. If you need to
pass a TQString to a function that requires a C '&#92;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 '&#92;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="ntqstring.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="ntqcstring.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 '&#92;0'-terminated 8-bit
data, use <a href="ntqcstring.html">TQCString</a>; if it is unterminated (i.e. contains '&#92;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="ntqstringlist.html">TQStringList</a> class. You can
split a string into a list of strings using <a href="ntqstringlist.html#split">TQStringList::split</a>(),
and join a list of strings into a single string with an optional
separator using <a href="ntqstringlist.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="ntqregexp.html">regex</a> using
<a href="ntqstringlist.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&amp; 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="ntqdeepcopy.html">TQDeepCopy</a>.
<p> <p>See also <a href="qchar.html">TQChar</a>, <a href="ntqcstring.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>&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="qbytearray.html">TQByteArray</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="qchar.html">TQChar</a>&nbsp;*&nbsp;unicode, uint&nbsp;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&nbsp;char&nbsp;*&nbsp;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="ntqtextcodec.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>TQT_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&nbsp;std::string&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="append"></a>TQString::append ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="append-2"></a>TQString::append ( char&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="append-3"></a>TQString::append ( <a href="qchar.html">TQChar</a>&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="append-4"></a>TQString::append ( const&nbsp;<a href="qbytearray.html">TQByteArray</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="append-5"></a>TQString::append ( const&nbsp;char&nbsp;*&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="append-6"></a>TQString::append ( const&nbsp;std::string&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a> <a name="arg"></a>TQString::arg ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;a, int&nbsp;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="ntqapplication.html#qWarning">tqWarning</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="ntqstring.html">TQString</a> <a name="arg-2"></a>TQString::arg ( long&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;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="ntqlocale.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="ntqlocale.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="ntqstring.html">TQString</a> <a name="arg-3"></a>TQString::arg ( ulong&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-4"></a>TQString::arg ( TQ_LLONG&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-5"></a>TQString::arg ( TQ_ULLONG&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-6"></a>TQString::arg ( int&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-7"></a>TQString::arg ( uint&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-8"></a>TQString::arg ( short&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-9"></a>TQString::arg ( ushort&nbsp;a, int&nbsp;fieldWidth = 0, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-a"></a>TQString::arg ( double&nbsp;a, int&nbsp;fieldWidth = 0, char&nbsp;fmt = 'g', int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-b"></a>TQString::arg ( char&nbsp;a, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-c"></a>TQString::arg ( <a href="qchar.html">TQChar</a>&nbsp;a, int&nbsp;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="ntqstring.html">TQString</a> <a name="arg-d"></a>TQString::arg ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;a1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a> <a name="arg-e"></a>TQString::arg ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;a1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;a2, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a> <a name="arg-f"></a>TQString::arg ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;a1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;a2, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;a3, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqtextcodec.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&nbsp;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&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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 &gt; 0
int b = TQString::<a href="#compare">compare</a>( "abc", "def" ); // b &lt; 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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&nbsp;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>&nbsp;c, bool&nbsp;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&nbsp;c, bool&nbsp;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&nbsp;char&nbsp;*&nbsp;str, bool&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str, bool&nbsp;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&nbsp;<a href="ntqregexp.html">TQRegExp</a>&nbsp;&amp;&nbsp;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="ntqregexp.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="ntqstring.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 '&#92;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s, bool&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="fill"></a>TQString::fill ( <a href="qchar.html">TQChar</a>&nbsp;c, int&nbsp;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&nbsp;<a href="ntqregexp.html">TQRegExp</a>&nbsp;&amp;&nbsp;rx, int&nbsp;index = 0 ) const
</h3>
Finds the first match of the <a href="ntqregexp.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>&nbsp;c, int&nbsp;index = 0, bool&nbsp;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&nbsp;c, int&nbsp;index = 0, bool&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str, int&nbsp;index = 0, bool&nbsp;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&nbsp;char&nbsp;*&nbsp;str, int&nbsp;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&nbsp;char&nbsp;*&nbsp;str, int&nbsp;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>&nbsp;c, int&nbsp;index = -1, bool&nbsp;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&nbsp;c, int&nbsp;index = -1, bool&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str, int&nbsp;index = -1, bool&nbsp;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&nbsp;<a href="ntqregexp.html">TQRegExp</a>&nbsp;&amp;&nbsp;rx, int&nbsp;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="ntqstring.html">TQString</a> <a name="fromAscii"></a>TQString::fromAscii ( const&nbsp;char&nbsp;*&nbsp;ascii, int&nbsp;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="ntqtextcodec.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>TQT_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="ntqstring.html">TQString</a> <a name="fromLatin1"></a>TQString::fromLatin1 ( const&nbsp;char&nbsp;*&nbsp;chars, int&nbsp;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="ntqstring.html">TQString</a> <a name="fromLocal8Bit"></a>TQString::fromLocal8Bit ( const&nbsp;char&nbsp;*&nbsp;local8Bit, int&nbsp;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="ntqtextcodec.html">TQTextCodec</a> for more diverse coding/decoding of Unicode strings.
<h3 class=fn><a href="ntqstring.html">TQString</a> <a name="fromUcs2"></a>TQString::fromUcs2 ( const&nbsp;unsigned&nbsp;short&nbsp;*&nbsp;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="ntqstring.html">TQString</a> <a name="fromUtf8"></a>TQString::fromUtf8 ( const&nbsp;char&nbsp;*&nbsp;utf8, int&nbsp;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="ntqtextcodec.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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="insert"></a>TQString::insert ( uint&nbsp;index, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="insert-2"></a>TQString::insert ( uint&nbsp;index, const&nbsp;<a href="qbytearray.html">TQByteArray</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="insert-3"></a>TQString::insert ( uint&nbsp;index, const&nbsp;char&nbsp;*&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="insert-4"></a>TQString::insert ( uint&nbsp;index, const&nbsp;<a href="qchar.html">TQChar</a>&nbsp;*&nbsp;s, uint&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="insert-5"></a>TQString::insert ( uint&nbsp;index, <a href="qchar.html">TQChar</a>&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="insert-6"></a>TQString::insert ( uint&nbsp;index, char&nbsp;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="ntqtextcodec.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="ntqstring.html">TQString</a> <a name="left"></a>TQString::left ( uint&nbsp;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="ntqstring.html">TQString</a> <a name="leftJustify"></a>TQString::leftJustify ( uint&nbsp;width, <a href="qchar.html">TQChar</a>&nbsp;fill = ' ', bool&nbsp;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="ntqcstring.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="ntqtextcodec.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="ntqtextcodec.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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqtextcodec.html#locale">TQTextCodec::locale</a>().
<h3 class=fn>int <a name="localeAwareCompare-2"></a>TQString::localeAwareCompare ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqstring.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="ntqstring.html">TQString</a> <a name="mid"></a>TQString::mid ( uint&nbsp;index, uint&nbsp;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="ntqstring.html">TQString</a> <a name="number"></a>TQString::number ( long&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a> <a name="number-2"></a>TQString::number ( ulong&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a> <a name="number-3"></a>TQString::number ( TQ_LLONG&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a> <a name="number-4"></a>TQString::number ( TQ_ULLONG&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a> <a name="number-5"></a>TQString::number ( int&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a> <a name="number-6"></a>TQString::number ( uint&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a> <a name="number-7"></a>TQString::number ( double&nbsp;n, char&nbsp;f = 'g', int&nbsp;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>TQT_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>TQT_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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator+-eq"></a>TQString::operator+= ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str )
</h3>
Appends <em>str</em> to the string and returns a reference to the string.
<h3 class=fn><a href="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator+-eq-2"></a>TQString::operator+= ( const&nbsp;<a href="qbytearray.html">TQByteArray</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator+-eq-3"></a>TQString::operator+= ( const&nbsp;char&nbsp;*&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator+-eq-4"></a>TQString::operator+= ( const&nbsp;std::string&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator+-eq-5"></a>TQString::operator+= ( <a href="qchar.html">TQChar</a>&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator+-eq-6"></a>TQString::operator+= ( char&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator-eq"></a>TQString::operator= ( <a href="qchar.html">TQChar</a>&nbsp;c )
</h3>
<p> Sets the string to contain just the single character <em>c</em>.
<h3 class=fn><a href="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator-eq-2"></a>TQString::operator= ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator-eq-3"></a>TQString::operator= ( const&nbsp;char&nbsp;*&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator-eq-4"></a>TQString::operator= ( const&nbsp;std::string&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator-eq-5"></a>TQString::operator= ( const&nbsp;<a href="ntqcstring.html">TQCString</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="operator-eq-6"></a>TQString::operator= ( char&nbsp;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&nbsp;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&amp;
(i.e., const TQString&amp;), 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&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="prepend"></a>TQString::prepend ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="prepend-2"></a>TQString::prepend ( char&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="prepend-3"></a>TQString::prepend ( <a href="qchar.html">TQChar</a>&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="prepend-4"></a>TQString::prepend ( const&nbsp;<a href="qbytearray.html">TQByteArray</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="prepend-5"></a>TQString::prepend ( const&nbsp;char&nbsp;*&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="prepend-6"></a>TQString::prepend ( const&nbsp;std::string&nbsp;&amp;&nbsp;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>&nbsp;&amp; <a name="ref"></a>TQString::ref ( uint&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="remove"></a>TQString::remove ( uint&nbsp;index, uint&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="remove-2"></a>TQString::remove ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str, bool&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="remove-3"></a>TQString::remove ( <a href="qchar.html">TQChar</a>&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="remove-4"></a>TQString::remove ( char&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="remove-5"></a>TQString::remove ( const&nbsp;char&nbsp;*&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="remove-6"></a>TQString::remove ( const&nbsp;<a href="ntqregexp.html">TQRegExp</a>&nbsp;&amp;&nbsp;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="ntqregexp.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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace"></a>TQString::replace ( uint&nbsp;index, uint&nbsp;len, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace-2"></a>TQString::replace ( uint&nbsp;index, uint&nbsp;len, const&nbsp;<a href="qchar.html">TQChar</a>&nbsp;*&nbsp;s, uint&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace-3"></a>TQString::replace ( uint&nbsp;index, uint&nbsp;len, <a href="qchar.html">TQChar</a>&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace-4"></a>TQString::replace ( uint&nbsp;index, uint&nbsp;len, char&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace-5"></a>TQString::replace ( <a href="qchar.html">TQChar</a>&nbsp;c, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;after, bool&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace-6"></a>TQString::replace ( char&nbsp;c, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;after, bool&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace-7"></a>TQString::replace ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;before, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;after, bool&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace-8"></a>TQString::replace ( const&nbsp;<a href="ntqregexp.html">TQRegExp</a>&nbsp;&amp;&nbsp;rx, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqregexp.html#capturing-text">capturing
parentheses</a>, occurrences of <b>&#92;1</b>, <b>&#92;2</b>, ...,
in <em>after</em> are replaced with <em>rx</em>.cap(1), cap(2), ...
<p> <pre>
TQString t = "A &lt;i&gt;bon mot&lt;/i&gt;.";
t.<a href="#replace">replace</a>( TQRegExp("&lt;i&gt;([^&lt;]*)&lt;/i&gt;"), "\\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="ntqregexp.html#cap">TQRegExp::cap</a>().
<h3 class=fn><a href="ntqstring.html">TQString</a>&nbsp;&amp; <a name="replace-9"></a>TQString::replace ( <a href="qchar.html">TQChar</a>&nbsp;c1, <a href="qchar.html">TQChar</a>&nbsp;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&nbsp;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="ntqstring.html">TQString</a> <a name="right"></a>TQString::right ( uint&nbsp;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="ntqstring.html">TQString</a> <a name="rightJustify"></a>TQString::rightJustify ( uint&nbsp;width, <a href="qchar.html">TQChar</a>&nbsp;fill = ' ', bool&nbsp;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="ntqstring.html">TQString</a> <a name="section"></a>TQString::section ( <a href="qchar.html">TQChar</a>&nbsp;sep, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;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="ntqstringlist.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="ntqstring.html">TQString</a> <a name="section-2"></a>TQString::section ( char&nbsp;sep, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;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="ntqstring.html">TQString</a> <a name="section-3"></a>TQString::section ( const&nbsp;char&nbsp;*&nbsp;sep, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;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="ntqstring.html">TQString</a> <a name="section-4"></a>TQString::section ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;sep, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;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="ntqstringlist.html#split">TQStringList::split</a>().
<h3 class=fn><a href="ntqstring.html">TQString</a> <a name="section-5"></a>TQString::section ( const&nbsp;<a href="ntqregexp.html">TQRegExp</a>&nbsp;&amp;&nbsp;reg, int&nbsp;start, int&nbsp;end = 0xffffffff, int&nbsp;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="ntqregexp.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="ntqregexp.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="ntqregexp.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="ntqregexp.html">TQRegExp</a> version is much more expensive than
the overloaded string and character versions.
<p> <p>See also <a href="ntqstringlist.html#split">TQStringList::split</a>() and <a href="#simplifyWhiteSpace">simplifyWhiteSpace</a>().
<h3 class=fn><a href="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setAscii"></a>TQString::setAscii ( const&nbsp;char&nbsp;*&nbsp;str, int&nbsp;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&nbsp;index, <a href="qchar.html">TQChar</a>&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setLatin1"></a>TQString::setLatin1 ( const&nbsp;char&nbsp;*&nbsp;str, int&nbsp;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&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum"></a>TQString::setNum ( TQ_LLONG&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-2"></a>TQString::setNum ( short&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-3"></a>TQString::setNum ( ushort&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-4"></a>TQString::setNum ( int&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-5"></a>TQString::setNum ( uint&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-6"></a>TQString::setNum ( long&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-7"></a>TQString::setNum ( ulong&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-8"></a>TQString::setNum ( TQ_ULLONG&nbsp;n, int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-9"></a>TQString::setNum ( float&nbsp;n, char&nbsp;f = 'g', int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setNum-a"></a>TQString::setNum ( double&nbsp;n, char&nbsp;f = 'g', int&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setUnicode"></a>TQString::setUnicode ( const&nbsp;<a href="qchar.html">TQChar</a>&nbsp;*&nbsp;unicode, uint&nbsp;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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="setUnicodeCodes"></a>TQString::setUnicodeCodes ( const&nbsp;ushort&nbsp;*&nbsp;unicode_as_ushorts, uint&nbsp;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="ntqstring.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="ntqstring.html">TQString</a>&nbsp;&amp; <a name="sprintf"></a>TQString::sprintf ( const&nbsp;char&nbsp;*&nbsp;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( &amp;str ) &lt;&lt; s &lt;&lt; " : " &lt;&lt; x;
</pre>
<p> For <a href="ntqobject.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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s, bool&nbsp;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="ntqstring.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&nbsp;*&nbsp;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="ntqlocale.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="ntqlocale.html#setDefault">setDefault</a>(TQLocale::C);
d = <a href="#TQString">TQString</a>( "1234,56" ).toDouble(&amp;ok); // ok == false
d = <a href="#TQString">TQString</a>( "1234.56" ).toDouble(&amp;ok); // ok == true, d == 1234.56
TQLocale::<a href="ntqlocale.html#setDefault">setDefault</a>(TQLocale::German);
d = <a href="#TQString">TQString</a>( "1234,56" ).toDouble(&amp;ok); // ok == true, d == 1234.56
d = <a href="#TQString">TQString</a>( "1234.56" ).toDouble(&amp;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="ntqlocale.html">TQLocale</a>.
<p> <pre>
bool ok;
TQLocale::<a href="ntqlocale.html#setDefault">setDefault</a>(TQLocale::C);
double d = <a href="#TQString">TQString</a>( "1,234,567.89" ).toDouble(&amp;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="ntqlocale.html#setDefault">TQLocale::setDefault</a>(), <a href="ntqlocale.html#toDouble">TQLocale::toDouble</a>(), and <a href="#stripWhiteSpace">stripWhiteSpace</a>().
<h3 class=fn>float <a name="toFloat"></a>TQString::toFloat ( bool&nbsp;*&nbsp;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&nbsp;*&nbsp;ok = 0, int&nbsp;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>( &amp;ok, 16 ); // hex == 255, ok == TRUE
int dec = str.<a href="#toInt">toInt</a>( &amp;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&nbsp;*&nbsp;ok = 0, int&nbsp;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>TQ_LLONG <a name="toLongLong"></a>TQString::toLongLong ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;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&nbsp;*&nbsp;ok = 0, int&nbsp;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&nbsp;*&nbsp;ok = 0, int&nbsp;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&nbsp;*&nbsp;ok = 0, int&nbsp;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>TQ_ULLONG <a name="toULongLong"></a>TQString::toULongLong ( bool&nbsp;*&nbsp;ok = 0, int&nbsp;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&nbsp;*&nbsp;ok = 0, int&nbsp;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&nbsp;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&nbsp;<a href="qchar.html">TQChar</a>&nbsp;* <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="ntqstring.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="ntqcstring.html">TQCString</a> <a name="utf8"></a>TQString::utf8 () const
</h3>
Returns the string encoded in UTF-8 format.
<p> See <a href="ntqtextcodec.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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;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&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a> <a name="operator+"></a>operator+ ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a> <a name="operator+-2"></a>operator+ ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a> <a name="operator+-3"></a>operator+ ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a> <a name="operator+-4"></a>operator+ ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s, char&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a> <a name="operator+-5"></a>operator+ ( char&nbsp;c, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&lt; ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;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>) &lt; 0.
<h3 class=fn>bool <a name="operator-lt-2"></a>operator&lt; ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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>) &lt; 0.
<h3 class=fn><a href="ntqdatastream.html">TQDataStream</a>&nbsp;&amp; <a name="operator-lt-lt"></a>operator&lt;&lt; ( <a href="ntqdatastream.html">TQDataStream</a>&nbsp;&amp;&nbsp;s, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&lt;= ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;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>) &lt;= 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&lt;= ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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>) &lt;= 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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;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&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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&gt; ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;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>) &gt; 0.
<h3 class=fn>bool <a name="operator-gt-2"></a>operator&gt; ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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>) &gt; 0.
<h3 class=fn>bool <a name="operator-gt-eq"></a>operator&gt;= ( const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;s1, const&nbsp;char&nbsp;*&nbsp;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>) &gt;= 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&gt;= ( const&nbsp;char&nbsp;*&nbsp;s1, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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>) &gt;= 0.
<p> <p>See also <a href="#isNull">isNull</a>() and <a href="#isEmpty">isEmpty</a>().
<h3 class=fn><a href="ntqdatastream.html">TQDataStream</a>&nbsp;&amp; <a name="operator-gt-gt"></a>operator&gt;&gt; ( <a href="ntqdatastream.html">TQDataStream</a>&nbsp;&amp;&nbsp;s, <a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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 &copy; 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 &copy; 2007
<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a>
<td align=right><div align=right>TQt 3.3.8</div>
</table></div></address></body>
</html>