diff options
Diffstat (limited to 'doc/html/tqstring.html')
| -rw-r--r-- | doc/html/tqstring.html | 218 |
1 files changed, 109 insertions, 109 deletions
diff --git a/doc/html/tqstring.html b/doc/html/tqstring.html index 054176257..2fe289b49 100644 --- a/doc/html/tqstring.html +++ b/doc/html/tqstring.html @@ -74,20 +74,20 @@ and the classic C '\0'-terminated char array. <li class=fn>TQString <a href="#arg-e"><b>arg</b></a> ( const TQString & a1, const TQString & a2, const TQString & a3 ) const</li> <li class=fn>TQString <a href="#arg-f"><b>arg</b></a> ( const TQString & a1, const TQString & a2, const TQString & a3, const TQString & a4 ) const</li> <li class=fn>TQString & <a href="#sprintf"><b>sprintf</b></a> ( const char * cformat, ... )</li> -<li class=fn>int <a href="#find-2"><b>find</b></a> ( TQChar c, int index = 0, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#find-3"><b>find</b></a> ( char c, int index = 0, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#find-4"><b>find</b></a> ( const TQString & str, int index = 0, bool cs = TRUE ) const</li> +<li class=fn>int <a href="#find-2"><b>find</b></a> ( TQChar c, int index = 0, bool cs = true ) const</li> +<li class=fn>int <a href="#find-3"><b>find</b></a> ( char c, int index = 0, bool cs = true ) const</li> +<li class=fn>int <a href="#find-4"><b>find</b></a> ( const TQString & str, int index = 0, bool cs = true ) const</li> <li class=fn>int <a href="#find"><b>find</b></a> ( const TQRegExp & rx, int index = 0 ) const</li> <li class=fn>int <a href="#find-5"><b>find</b></a> ( const char * str, int index = 0 ) const</li> -<li class=fn>int <a href="#findRev-2"><b>findRev</b></a> ( TQChar c, int index = -1, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#findRev-3"><b>findRev</b></a> ( char c, int index = -1, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#findRev-4"><b>findRev</b></a> ( const TQString & str, int index = -1, bool cs = TRUE ) const</li> +<li class=fn>int <a href="#findRev-2"><b>findRev</b></a> ( TQChar c, int index = -1, bool cs = true ) const</li> +<li class=fn>int <a href="#findRev-3"><b>findRev</b></a> ( char c, int index = -1, bool cs = true ) const</li> +<li class=fn>int <a href="#findRev-4"><b>findRev</b></a> ( const TQString & str, int index = -1, bool cs = true ) const</li> <li class=fn>int <a href="#findRev-5"><b>findRev</b></a> ( const TQRegExp & rx, int index = -1 ) const</li> <li class=fn>int <a href="#findRev"><b>findRev</b></a> ( const char * str, int index = -1 ) const</li> -<li class=fn>int <a href="#contains"><b>contains</b></a> ( TQChar c, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#contains-2"><b>contains</b></a> ( char c, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#contains-3"><b>contains</b></a> ( const char * str, bool cs = TRUE ) const</li> -<li class=fn>int <a href="#contains-4"><b>contains</b></a> ( const TQString & str, bool cs = TRUE ) const</li> +<li class=fn>int <a href="#contains"><b>contains</b></a> ( TQChar c, bool cs = true ) const</li> +<li class=fn>int <a href="#contains-2"><b>contains</b></a> ( char c, bool cs = true ) const</li> +<li class=fn>int <a href="#contains-3"><b>contains</b></a> ( const char * str, bool cs = true ) const</li> +<li class=fn>int <a href="#contains-4"><b>contains</b></a> ( const TQString & str, bool cs = true ) const</li> <li class=fn>int <a href="#contains-5"><b>contains</b></a> ( const TQRegExp & rx ) const</li> <li class=fn>enum <a href="#SectionFlags-enum"><b>SectionFlags</b></a> { SectionDefault = 0x00, SectionSkipEmpty = 0x01, SectionIncludeLeadingSep = 0x02, SectionIncludeTrailingSep = 0x04, SectionCaseInsensitiveSeps = 0x08 }</li> <li class=fn>TQString <a href="#section"><b>section</b></a> ( TQChar sep, int start, int end = 0xffffffff, int flags = SectionDefault ) const</li> @@ -98,8 +98,8 @@ and the classic C '\0'-terminated char array. <li class=fn>TQString <a href="#left"><b>left</b></a> ( uint len ) const</li> <li class=fn>TQString <a href="#right"><b>right</b></a> ( uint len ) const</li> <li class=fn>TQString <a href="#mid"><b>mid</b></a> ( uint index, uint len = 0xffffffff ) const</li> -<li class=fn>TQString <a href="#leftJustify"><b>leftJustify</b></a> ( uint width, TQChar fill = ' ', bool truncate = FALSE ) const</li> -<li class=fn>TQString <a href="#rightJustify"><b>rightJustify</b></a> ( uint width, TQChar fill = ' ', bool truncate = FALSE ) const</li> +<li class=fn>TQString <a href="#leftJustify"><b>leftJustify</b></a> ( uint width, TQChar fill = ' ', bool truncate = false ) const</li> +<li class=fn>TQString <a href="#rightJustify"><b>rightJustify</b></a> ( uint width, TQChar fill = ' ', bool truncate = false ) const</li> <li class=fn>TQString <a href="#lower"><b>lower</b></a> () const</li> <li class=fn>TQString <a href="#upper"><b>upper</b></a> () const</li> <li class=fn>TQString <a href="#stripWhiteSpace"><b>stripWhiteSpace</b></a> () const</li> @@ -123,7 +123,7 @@ and the classic C '\0'-terminated char array. <li class=fn>TQString & <a href="#prepend-5"><b>prepend</b></a> ( const char * s )</li> <li class=fn>TQString & <a href="#prepend-6"><b>prepend</b></a> ( const std::string & s )</li> <li class=fn>TQString & <a href="#remove"><b>remove</b></a> ( uint index, uint len )</li> -<li class=fn>TQString & <a href="#remove-2"><b>remove</b></a> ( const TQString & str, bool cs = TRUE )</li> +<li class=fn>TQString & <a href="#remove-2"><b>remove</b></a> ( const TQString & str, bool cs = true )</li> <li class=fn>TQString & <a href="#remove-3"><b>remove</b></a> ( TQChar c )</li> <li class=fn>TQString & <a href="#remove-4"><b>remove</b></a> ( char c )</li> <li class=fn>TQString & <a href="#remove-5"><b>remove</b></a> ( const char * str )</li> @@ -132,9 +132,9 @@ and the classic C '\0'-terminated char array. <li class=fn>TQString & <a href="#replace-2"><b>replace</b></a> ( uint index, uint len, const TQChar * s, uint slen )</li> <li class=fn>TQString & <a href="#replace-3"><b>replace</b></a> ( uint index, uint len, TQChar c )</li> <li class=fn>TQString & <a href="#replace-4"><b>replace</b></a> ( uint index, uint len, char c )</li> -<li class=fn>TQString & <a href="#replace-5"><b>replace</b></a> ( TQChar c, const TQString & after, bool cs = TRUE )</li> -<li class=fn>TQString & <a href="#replace-6"><b>replace</b></a> ( char c, const TQString & after, bool cs = TRUE )</li> -<li class=fn>TQString & <a href="#replace-7"><b>replace</b></a> ( const TQString & before, const TQString & after, bool cs = TRUE )</li> +<li class=fn>TQString & <a href="#replace-5"><b>replace</b></a> ( TQChar c, const TQString & after, bool cs = true )</li> +<li class=fn>TQString & <a href="#replace-6"><b>replace</b></a> ( char c, const TQString & after, bool cs = true )</li> +<li class=fn>TQString & <a href="#replace-7"><b>replace</b></a> ( const TQString & before, const TQString & after, bool cs = true )</li> <li class=fn>TQString & <a href="#replace-8"><b>replace</b></a> ( const TQRegExp & rx, const TQString & after )</li> <li class=fn>TQString & <a href="#replace-9"><b>replace</b></a> ( TQChar c1, TQChar c2 )</li> <li class=fn>short <a href="#toShort"><b>toShort</b></a> ( bool * ok = 0, int base = 10 ) const</li> @@ -187,8 +187,8 @@ and the classic C '\0'-terminated char array. <li class=fn>int <a href="#localeAwareCompare-2"><b>localeAwareCompare</b></a> ( const TQString & s ) const</li> <li class=fn>void <a href="#compose"><b>compose</b></a> ()</li> <li class=fn>const char * data () const <em>(obsolete)</em></li> -<li class=fn>bool <a href="#startsWith"><b>startsWith</b></a> ( const TQString & s, bool cs = TRUE ) const</li> -<li class=fn>bool <a href="#endsWith"><b>endsWith</b></a> ( const TQString & s, bool cs = TRUE ) const</li> +<li class=fn>bool <a href="#startsWith"><b>startsWith</b></a> ( const TQString & s, bool cs = true ) const</li> +<li class=fn>bool <a href="#endsWith"><b>endsWith</b></a> ( const TQString & s, bool cs = true ) const</li> <li class=fn>void <a href="#setLength"><b>setLength</b></a> ( uint newLen )</li> <li class=fn>uint <a href="#capacity"><b>capacity</b></a> () const</li> <li class=fn>void <a href="#reserve"><b>reserve</b></a> ( uint minCapacity )</li> @@ -704,37 +704,37 @@ TQChar(0x0308) (Unicode accent diaresis), giving TQChar(0x00c4) <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="tqchar.html">TQChar</a> c, bool cs = TRUE ) const +<h3 class=fn>int <a name="contains"></a>TQString::contains ( <a href="tqchar.html">TQChar</a> c, bool cs = true ) const </h3> Returns the number of times the character <em>c</em> occurs in the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<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 ); + int n = string.<a href="#contains">contains</a>( 't', false ); // n == 3 </pre> <p>Examples: <a href="fileiconview-example.html#x867">fileiconview/tqfileiconview.cpp</a> and <a href="mdi-example.html#x2064">mdi/application.cpp</a>. -<h3 class=fn>int <a name="contains-2"></a>TQString::contains ( char c, bool cs = TRUE ) const +<h3 class=fn>int <a name="contains-2"></a>TQString::contains ( char c, bool cs = true ) const </h3> <p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> -<h3 class=fn>int <a name="contains-3"></a>TQString::contains ( const char * str, bool cs = TRUE ) const +<h3 class=fn>int <a name="contains-3"></a>TQString::contains ( const char * str, bool cs = true ) const </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Returns the number of times the string <em>str</em> occurs in the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<p> If <em>cs</em> is true (the default), the search is case sensitive; otherwise the search is case insensitive. -<h3 class=fn>int <a name="contains-4"></a>TQString::contains ( const <a href="tqstring.html">TQString</a> & str, bool cs = TRUE ) const +<h3 class=fn>int <a name="contains-4"></a>TQString::contains ( const <a href="tqstring.html">TQString</a> & str, bool cs = true ) const </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Returns the number of times <em>str</em> occurs in the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<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". @@ -754,7 +754,7 @@ string. there are four instances of "ana" or "ama". <p> <pre> TQString str = "banana and panama"; - <a href="tqregexp.html">TQRegExp</a> rxp = TQRegExp( "a[nm]a", TRUE, FALSE ); + <a href="tqregexp.html">TQRegExp</a> rxp = TQRegExp( "a[nm]a", true, false ); int i = str.<a href="#contains">contains</a>( rxp ); // i == 4 </pre> @@ -777,16 +777,16 @@ string as a sequence of bytes. In TQt 2.x where TQString is a Unicode string, char* conversion constructs a temporary string, and hence direct character operations are meaningless. -<h3 class=fn>bool <a name="endsWith"></a>TQString::endsWith ( const <a href="tqstring.html">TQString</a> & s, bool cs = TRUE ) const +<h3 class=fn>bool <a name="endsWith"></a>TQString::endsWith ( const <a href="tqstring.html">TQString</a> & s, bool cs = true ) const </h3> -Returns TRUE if the string ends with <em>s</em>; otherwise returns -FALSE. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +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 + 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>(). @@ -820,33 +820,33 @@ was found. <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="tqchar.html">TQChar</a> c, int index = 0, bool cs = TRUE ) const +<h3 class=fn>int <a name="find-2"></a>TQString::find ( <a href="tqchar.html">TQChar</a> c, int index = 0, bool cs = true ) const </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Finds the first occurrence of the character <em>c</em>, starting at position <em>index</em>. If <em>index</em> is -1, the search starts at the last character; if -2, at the next to last character and so on. (See <a href="#findRev">findRev</a>() for searching backwards.) -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<p> If <em>cs</em> is true (the default), the search is case sensitive; otherwise the search is case insensitive. <p> Returns the position of <em>c</em> or -1 if <em>c</em> could not be found. -<h3 class=fn>int <a name="find-3"></a>TQString::find ( char c, int index = 0, bool cs = TRUE ) const +<h3 class=fn>int <a name="find-3"></a>TQString::find ( char c, int index = 0, bool cs = true ) const </h3> <p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Find character <em>c</em> starting from position <em>index</em>. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<p> If <em>cs</em> is true (the default), the search is case sensitive; otherwise the search is case insensitive. -<h3 class=fn>int <a name="find-4"></a>TQString::find ( const <a href="tqstring.html">TQString</a> & str, int index = 0, bool cs = TRUE ) const +<h3 class=fn>int <a name="find-4"></a>TQString::find ( const <a href="tqstring.html">TQString</a> & str, int index = 0, bool cs = true ) const </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Finds the first occurrence of the string <em>str</em>, starting at position <em>index</em>. If <em>index</em> is -1, the search starts at the last character, if it is -2, at the next to last character and so on. (See <a href="#findRev">findRev</a>() for searching backwards.) -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<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. @@ -861,7 +861,7 @@ otherwise the search is case insensitive. <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="tqchar.html">TQChar</a> c, int index = -1, bool cs = TRUE ) const +<h3 class=fn>int <a name="findRev-2"></a>TQString::findRev ( <a href="tqchar.html">TQChar</a> c, int index = -1, bool cs = true ) const </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Finds the first occurrence of the character <em>c</em>, starting at @@ -869,7 +869,7 @@ 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; +<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" ); @@ -877,16 +877,16 @@ otherwise the search is case insensitive. </pre> -<h3 class=fn>int <a name="findRev-3"></a>TQString::findRev ( char c, int index = -1, bool cs = TRUE ) const +<h3 class=fn>int <a name="findRev-3"></a>TQString::findRev ( char c, int index = -1, bool cs = true ) const </h3> <p> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Find character <em>c</em> starting from position <em>index</em> and working backwards. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<p> If <em>cs</em> is true (the default), the search is case sensitive; otherwise the search is case insensitive. -<h3 class=fn>int <a name="findRev-4"></a>TQString::findRev ( const <a href="tqstring.html">TQString</a> & str, int index = -1, bool cs = TRUE ) const +<h3 class=fn>int <a name="findRev-4"></a>TQString::findRev ( const <a href="tqstring.html">TQString</a> & str, int index = -1, bool cs = true ) const </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Finds the first occurrence of the string <em>str</em>, starting at @@ -894,7 +894,7 @@ 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; +<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"); @@ -1031,16 +1031,16 @@ then appended. <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> 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 + 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 + 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>(). @@ -1049,12 +1049,12 @@ otherwise returns FALSE. Null strings are also empty. <h3 class=fn>bool <a name="isNull"></a>TQString::isNull () const </h3> -<p> Returns TRUE if the string is null; otherwise returns FALSE. A +<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 + 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>(). @@ -1087,13 +1087,13 @@ string. <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="tqstring.html">TQString</a> <a name="leftJustify"></a>TQString::leftJustify ( uint width, <a href="tqchar.html">TQChar</a> fill = ' ', bool truncate = FALSE ) const +<h3 class=fn><a href="tqstring.html">TQString</a> <a name="leftJustify"></a>TQString::leftJustify ( uint width, <a href="tqchar.html">TQChar</a> fill = ' ', bool truncate = false ) const </h3> Returns a string of length <em>width</em> that contains this string padded by the <em>fill</em> character. -<p> If <em>truncate</em> is FALSE and the length of the string is more than +<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 +<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> @@ -1250,7 +1250,7 @@ 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> Returns true if this is a null string; otherwise returns false. <p> <pre> TQString name = getName(); if ( !name ) @@ -1451,11 +1451,11 @@ the end of the string, the string is truncated at position <em>index</em>. <p> <p>See also <a href="#insert">insert</a>() and <a href="#replace">replace</a>(). -<h3 class=fn><a href="tqstring.html">TQString</a> & <a name="remove-2"></a>TQString::remove ( const <a href="tqstring.html">TQString</a> & str, bool cs = TRUE ) +<h3 class=fn><a href="tqstring.html">TQString</a> & <a name="remove-2"></a>TQString::remove ( const <a href="tqstring.html">TQString</a> & str, bool cs = true ) </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Removes every occurrence of <em>str</em> in the string. Returns a reference to the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<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>). @@ -1524,11 +1524,11 @@ to the string. <p> <p> This is the same as <a href="#replace">replace</a>(<em>index</em>, <em>len</em>, <a href="tqchar.html">TQChar</a>(<em>c</em>)). -<h3 class=fn><a href="tqstring.html">TQString</a> & <a name="replace-5"></a>TQString::replace ( <a href="tqchar.html">TQChar</a> c, const <a href="tqstring.html">TQString</a> & after, bool cs = TRUE ) +<h3 class=fn><a href="tqstring.html">TQString</a> & <a name="replace-5"></a>TQString::replace ( <a href="tqchar.html">TQChar</a> c, const <a href="tqstring.html">TQString</a> & after, bool cs = true ) </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Replaces every occurrence of the character <em>c</em> in the string with <em>after</em>. Returns a reference to the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<p> If <em>cs</em> is true (the default), the search is case sensitive; otherwise the search is case insensitive. <p> Example: <pre> @@ -1538,19 +1538,19 @@ otherwise the search is case insensitive. </pre> -<h3 class=fn><a href="tqstring.html">TQString</a> & <a name="replace-6"></a>TQString::replace ( char c, const <a href="tqstring.html">TQString</a> & after, bool cs = TRUE ) +<h3 class=fn><a href="tqstring.html">TQString</a> & <a name="replace-6"></a>TQString::replace ( char c, const <a href="tqstring.html">TQString</a> & after, bool cs = true ) </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> <p> Replaces every occurrence of the character <em>c</em> in the string with <em>after</em>. Returns a reference to the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<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="tqstring.html">TQString</a> & <a name="replace-7"></a>TQString::replace ( const <a href="tqstring.html">TQString</a> & before, const <a href="tqstring.html">TQString</a> & after, bool cs = TRUE ) +<h3 class=fn><a href="tqstring.html">TQString</a> & <a name="replace-7"></a>TQString::replace ( const <a href="tqstring.html">TQString</a> & before, const <a href="tqstring.html">TQString</a> & after, bool cs = true ) </h3> This is an overloaded member function, provided for convenience. It behaves essentially like the above function. <p> Replaces every occurrence of the string <em>before</em> in the string with the string <em>after</em>. Returns a reference to the string. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +<p> If <em>cs</em> is true (the default), the search is case sensitive; otherwise the search is case insensitive. <p> Example: <pre> @@ -1624,13 +1624,13 @@ string is returned. <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/tqfileiconview.cpp</a>. -<h3 class=fn><a href="tqstring.html">TQString</a> <a name="rightJustify"></a>TQString::rightJustify ( uint width, <a href="tqchar.html">TQChar</a> fill = ' ', bool truncate = FALSE ) const +<h3 class=fn><a href="tqstring.html">TQString</a> <a name="rightJustify"></a>TQString::rightJustify ( uint width, <a href="tqchar.html">TQChar</a> fill = ' ', bool truncate = false ) const </h3> Returns a string of length <em>width</em> that contains the <em>fill</em> character followed by the string. -<p> If <em>truncate</em> is FALSE and the length of the string is more than +<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 +<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" ); @@ -1879,7 +1879,7 @@ 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="tqchar.html#isSpace">TQChar::isSpace</a>() returns -TRUE. This includes Unicode characters with decimal values 9 +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 "; @@ -1924,16 +1924,16 @@ array of unicode characters of type ushort (as returned by Squeezes the string's capacity to the current content. <p> <p>See also <a href="#capacity">capacity</a>() and <a href="#reserve">reserve</a>(). -<h3 class=fn>bool <a name="startsWith"></a>TQString::startsWith ( const <a href="tqstring.html">TQString</a> & s, bool cs = TRUE ) const +<h3 class=fn>bool <a name="startsWith"></a>TQString::startsWith ( const <a href="tqstring.html">TQString</a> & s, bool cs = true ) const </h3> -Returns TRUE if the string starts with <em>s</em>; otherwise returns -FALSE. -<p> If <em>cs</em> is TRUE (the default), the search is case sensitive; +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 + 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>(). @@ -1943,7 +1943,7 @@ otherwise the search is case insensitive. Returns a string that has whitespace removed from the start and the end. <p> Whitespace means any character for which <a href="tqchar.html#isSpace">TQChar::isSpace</a>() returns -TRUE. This includes Unicode characters with decimal values 9 +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> @@ -1957,7 +1957,7 @@ also include other Unicode characters. </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. +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 @@ -2018,7 +2018,7 @@ whitespace is ignored. 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. +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 @@ -2039,12 +2039,12 @@ be hexadecimal; </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. +false; otherwise <em>*ok</em> is set to true. <p> <pre> TQString str( "FF" ); bool ok; - int hex = str.<a href="#toInt">toInt</a>( &ok, 16 ); // hex == 255, ok == TRUE - int dec = str.<a href="#toInt">toInt</a>( &ok, 10 ); // dec == 0, ok == FALSE + int hex = str.<a href="#toInt">toInt</a>( &ok, 16 ); // hex == 255, ok == true + int dec = str.<a href="#toInt">toInt</a>( &ok, 10 ); // dec == 0, ok == false </pre> <p> Leading and trailing whitespace is ignored by this function. @@ -2065,7 +2065,7 @@ be hexadecimal; </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. +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>(). @@ -2084,7 +2084,7 @@ be hexadecimal; </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. +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>(). @@ -2103,7 +2103,7 @@ be hexadecimal; </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. +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>(). @@ -2122,7 +2122,7 @@ be hexadecimal; </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. +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>(). @@ -2141,7 +2141,7 @@ be hexadecimal; </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. +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>(). @@ -2160,7 +2160,7 @@ be hexadecimal; </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. +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>(). @@ -2179,7 +2179,7 @@ be hexadecimal; </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. +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>(). @@ -2234,7 +2234,7 @@ Returns the string encoded in UTF-8 format. </h3> <p> -<p> Returns TRUE if <em>s1</em> is not equal to <em>s2</em>; otherwise returns FALSE. +<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>(). @@ -2244,7 +2244,7 @@ Note that a null string is not equal to a not-null empty string. <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. +<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>(). @@ -2254,7 +2254,7 @@ Note that a null string is not equal to a not-null empty string. <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. +<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>(). @@ -2306,7 +2306,7 @@ character <em>c</em> and string <em>s</em>. </h3> <p> -<p> Returns TRUE if <em>s1</em> is lexically less than <em>s2</em>; otherwise returns FALSE. +<p> Returns true if <em>s1</em> is lexically less than <em>s2</em>; otherwise returns false. The comparison is case sensitive. <p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) < 0. @@ -2315,7 +2315,7 @@ The comparison is case sensitive. <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. +<p> Returns true if <em>s1</em> is lexically less than <em>s2</em>; otherwise returns false. The comparison is case sensitive. <p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) < 0. @@ -2329,8 +2329,8 @@ The comparison is case sensitive. </h3> <p> -<p> Returns TRUE if <em>s1</em> is lexically less than or equal to <em>s2</em>; -otherwise returns FALSE. +<p> Returns true if <em>s1</em> is lexically less than or equal to <em>s2</em>; +otherwise returns false. The comparison is case sensitive. Note that a null string is not equal to a not-null empty string. <p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>,<em>s2</em>) <= 0. @@ -2341,8 +2341,8 @@ Note that a null string is not equal to a not-null empty string. <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. +<p> Returns true if <em>s1</em> is lexically less than or equal to <em>s2</em>; +otherwise returns false. The comparison is case sensitive. Note that a null string is not equal to a not-null empty string. <p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) <= 0. @@ -2352,7 +2352,7 @@ Note that a null string is not equal to a not-null empty string. </h3> <p> -<p> Returns TRUE if <em>s1</em> is equal to <em>s2</em>; otherwise returns FALSE. +<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>(). @@ -2362,7 +2362,7 @@ Note that a null string is not equal to a not-null empty string. <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. +<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>(). @@ -2372,7 +2372,7 @@ Note that a null string is not equal to a not-null empty string. <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. +<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>(). @@ -2381,8 +2381,8 @@ Note that a null string is not equal to a not-null empty string. </h3> <p> -<p> Returns TRUE if <em>s1</em> is lexically greater than <em>s2</em>; otherwise -returns FALSE. +<p> Returns true if <em>s1</em> is lexically greater than <em>s2</em>; otherwise +returns false. The comparison is case sensitive. <p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) > 0. @@ -2391,8 +2391,8 @@ The comparison is case sensitive. <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. +<p> Returns true if <em>s1</em> is lexically greater than <em>s2</em>; otherwise +returns false. The comparison is case sensitive. <p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) > 0. @@ -2400,8 +2400,8 @@ The comparison is case sensitive. </h3> <p> -<p> Returns TRUE if <em>s1</em> is lexically greater than or equal to <em>s2</em>; -otherwise returns FALSE. +<p> Returns true if <em>s1</em> is lexically greater than or equal to <em>s2</em>; +otherwise returns false. The comparison is case sensitive. Note that a null string is not equal to a not-null empty string. <p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) >= 0. @@ -2412,8 +2412,8 @@ Note that a null string is not equal to a not-null empty string. <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. +<p> Returns true if <em>s1</em> is lexically greater than or equal to <em>s2</em>; +otherwise returns false. The comparison is case sensitive. Note that a null string is not equal to a not-null empty string. <p> Equivalent to <a href="#compare">compare</a>(<em>s1</em>, <em>s2</em>) >= 0. |