diff options
| author | Michele Calgaro <[email protected]> | 2024-06-06 13:44:12 +0900 |
|---|---|---|
| committer | Michele Calgaro <[email protected]> | 2024-06-06 13:52:29 +0900 |
| commit | e6077c30d14e9d662e8843c554db86c0d366d0b6 (patch) | |
| tree | 672319afee32f0316bad258c0e9a1e0dd737bd61 /doc/html/ntqstringlist.html | |
| parent | 8c029298d9d3f1f84b65ac4a3a16cd1fa28d9cde (diff) | |
| download | tqt3-e6077c30d14e9d662e8843c554db86c0d366d0b6.tar.gz tqt3-e6077c30d14e9d662e8843c554db86c0d366d0b6.zip | |
Rename str nt* related files to equivalent tq*
Signed-off-by: Michele Calgaro <[email protected]>
Diffstat (limited to 'doc/html/ntqstringlist.html')
| -rw-r--r-- | doc/html/ntqstringlist.html | 309 |
1 files changed, 0 insertions, 309 deletions
diff --git a/doc/html/ntqstringlist.html b/doc/html/ntqstringlist.html deleted file mode 100644 index 1cd5e5241..000000000 --- a/doc/html/ntqstringlist.html +++ /dev/null @@ -1,309 +0,0 @@ -<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> -<!-- /home/espenr/tmp/qt-3.3.8-espenr-2499/qt-x11-free-3.3.8/src/tools/qstringlist.cpp:46 --> -<html> -<head> -<meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> -<title>TQStringList Class</title> -<style type="text/css"><!-- -fn { margin-left: 1cm; text-indent: -1cm; } -a:link { color: #004faf; text-decoration: none } -a:visited { color: #672967; text-decoration: none } -body { background: #ffffff; color: black; } ---></style> -</head> -<body> - -<table border="0" cellpadding="0" cellspacing="0" width="100%"> -<tr bgcolor="#E5E5E5"> -<td valign=center> - <a href="index.html"> -<font color="#004faf">Home</font></a> - | <a href="classes.html"> -<font color="#004faf">All Classes</font></a> - | <a href="mainclasses.html"> -<font color="#004faf">Main Classes</font></a> - | <a href="annotated.html"> -<font color="#004faf">Annotated</font></a> - | <a href="groups.html"> -<font color="#004faf">Grouped Classes</font></a> - | <a href="functions.html"> -<font color="#004faf">Functions</font></a> -</td> -<td align="right" valign="center"><img src="logo32.png" align="right" width="64" height="32" border="0"></td></tr></table><h1 align=center>TQStringList Class Reference</h1> - -<p>The TQStringList class provides a list of strings. -<a href="#details">More...</a> -<p>All the functions in this class are <a href="threads.html#reentrant">reentrant</a> when TQt is built with thread support.</p> -<p><tt>#include <<a href="qstringlist-h.html">ntqstringlist.h</a>></tt> -<p>Inherits <a href="tqvaluelist.html">TQValueList</a><TQString>. -<p><a href="qstringlist-members.html">List of all member functions.</a> -<h2>Public Members</h2> -<ul> -<li class=fn><a href="#TQStringList"><b>TQStringList</b></a> ()</li> -<li class=fn><a href="#TQStringList-2"><b>TQStringList</b></a> ( const TQStringList & l )</li> -<li class=fn><a href="#TQStringList-3"><b>TQStringList</b></a> ( const TQValueList<TQString> & l )</li> -<li class=fn><a href="#TQStringList-4"><b>TQStringList</b></a> ( const TQString & i )</li> -<li class=fn><a href="#TQStringList-5"><b>TQStringList</b></a> ( const char * i )</li> -<li class=fn>void <a href="#sort"><b>sort</b></a> ()</li> -<li class=fn>TQString <a href="#join"><b>join</b></a> ( const TQString & sep ) const</li> -<li class=fn>TQStringList <a href="#grep"><b>grep</b></a> ( const TQString & str, bool cs = TRUE ) const</li> -<li class=fn>TQStringList <a href="#grep-2"><b>grep</b></a> ( const TQRegExp & rx ) const</li> -<li class=fn>TQStringList & <a href="#gres"><b>gres</b></a> ( const TQString & before, const TQString & after, bool cs = TRUE )</li> -<li class=fn>TQStringList & <a href="#gres-2"><b>gres</b></a> ( const TQRegExp & rx, const TQString & after )</li> -</ul> -<h2>Static Public Members</h2> -<ul> -<li class=fn>TQStringList <a href="#fromStrList"><b>fromStrList</b></a> ( const TQStrList & ascii )</li> -<li class=fn>TQStringList <a href="#split-2"><b>split</b></a> ( const TQString & sep, const TQString & str, bool allowEmptyEntries = FALSE )</li> -<li class=fn>TQStringList <a href="#split-3"><b>split</b></a> ( const TQChar & sep, const TQString & str, bool allowEmptyEntries = FALSE )</li> -<li class=fn>TQStringList <a href="#split"><b>split</b></a> ( const TQRegExp & sep, const TQString & str, bool allowEmptyEntries = FALSE )</li> -</ul> -<hr><a name="details"></a><h2>Detailed Description</h2> - - - -The TQStringList class provides a list of strings. -<p> - - - -<p> It is used to store and manipulate strings that logically belong -together. Essentially TQStringList is a <a href="tqvaluelist.html">TQValueList</a> of <a href="ntqstring.html">TQString</a> -objects. Unlike <a href="ntqstrlist.html">TQStrList</a>, which stores pointers to characters, -TQStringList holds real TQString objects. It is the class of choice -whenever you work with Unicode strings. TQStringList is part of the -<a href="ntqtl.html">TQt Template Library</a>. -<p> Like TQString itself, TQStringList objects are <a href="shclass.html#implicitly-shared">implicitly shared</a>, so -passing them around as value-parameters is both fast and safe. -<p> Strings can be added to a list using <a href="tqvaluelist.html#append">append</a>(), <a href="tqvaluelist.html#operator+-eq">operator+=</a>() or -<a href="tqvaluelist.html#operator-lt-lt">operator<<</a>(), e.g. -<pre> - TQStringList fonts; - fonts.<a href="tqvaluelist.html#append">append</a>( "Times" ); - fonts += "Courier"; - fonts += "Courier New"; - fonts << "Helvetica [Cronyx]" << "Helvetica [Adobe]"; - </pre> - -<p> String lists have an iterator, TQStringList::Iterator(), e.g. -<pre> - for ( TQStringList::<a href="tqvaluelist.html#Iterator">Iterator</a> it = fonts.begin(); it != fonts.end(); ++it ) { - cout << *it << ":"; - } - cout << endl; - // Output: - // Times:Courier:Courier New:Helvetica [Cronyx]:Helvetica [Adobe]: - </pre> - -<p> Many TQt functions return string lists by value; to iterate over -these you should make a copy and iterate over the copy. -<p> You can concatenate all the strings in a string list into a single -string (with an optional separator) using <a href="#join">join</a>(), e.g. -<pre> - <a href="ntqstring.html">TQString</a> allFonts = fonts.join( ", " ); - cout << allFonts << endl; - // Output: - // Times, Courier, Courier New, Helvetica [Cronyx], Helvetica [Adobe] - </pre> - -<p> You can sort the list with <a href="#sort">sort</a>(), and extract a new list which -contains only those strings which contain a particular substring -(or match a particular <a href="ntqregexp.html#regular-expression">regular expression</a>) using the <a href="#grep">grep</a>() -functions, e.g. -<pre> - fonts.sort(); - cout << fonts.join( ", " ) << endl; - // Output: - // Courier, Courier New, Helvetica [Adobe], Helvetica [Cronyx], Times - - TQStringList helveticas = fonts.grep( "Helvetica" ); - cout << helveticas.<a href="#join">join</a>( ", " ) << endl; - // Output: - // Helvetica [Adobe], Helvetica [Cronyx] - </pre> - -<p> Existing strings can be split into string lists with character, -string or regular expression separators, e.g. -<pre> - <a href="ntqstring.html">TQString</a> s = "Red\tGreen\tBlue"; - TQStringList colors = TQStringList::<a href="#split">split</a>( "\t", s ); - cout << colors.<a href="#join">join</a>( ", " ) << endl; - // Output: - // Red, Green, Blue - </pre> - -<p>See also <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 Function Documentation</h2> -<h3 class=fn><a name="TQStringList"></a>TQStringList::TQStringList () -</h3> - -<p> Creates an empty string list. - -<h3 class=fn><a name="TQStringList-2"></a>TQStringList::TQStringList ( const <a href="ntqstringlist.html">TQStringList</a> & l ) -</h3> - -<p> Creates a copy of the list <em>l</em>. This function is very fast -because TQStringList is <a href="shclass.html#implicitly-shared">implicitly shared</a>. In most situations this -acts like a <a href="shclass.html#deep-copy">deep copy</a>, for example, if this list or the original -one or some other list referencing the same shared data is -modified, the modifying list first makes a copy, i.e. -copy-on-write. -In a threaded environment you may require a real deep copy -. - -<h3 class=fn><a name="TQStringList-3"></a>TQStringList::TQStringList ( const <a href="tqvaluelist.html">TQValueList</a><TQString> & l ) -</h3> - -<p> Constructs a new string list that is a copy of <em>l</em>. - -<h3 class=fn><a name="TQStringList-4"></a>TQStringList::TQStringList ( const <a href="ntqstring.html">TQString</a> & i ) -</h3> - -<p> Constructs a string list consisting of the single string <em>i</em>. -Longer lists are easily created as follows: -<p> <pre> - TQStringList items; - items << "Buy" << "Sell" << "Update" << "Value"; - </pre> - - -<h3 class=fn><a name="TQStringList-5"></a>TQStringList::TQStringList ( const char * i ) -</h3> - -<p> Constructs a string list consisting of the single Latin-1 string <em>i</em>. - -<h3 class=fn><a href="ntqstringlist.html">TQStringList</a> <a name="fromStrList"></a>TQStringList::fromStrList ( const <a href="ntqstrlist.html">TQStrList</a> & ascii )<tt> [static]</tt> -</h3> -Converts from an ASCII-TQStrList <em>ascii</em> to a TQStringList (Unicode). - -<h3 class=fn><a href="ntqstringlist.html">TQStringList</a> <a name="grep"></a>TQStringList::grep ( const <a href="ntqstring.html">TQString</a> & str, bool cs = TRUE ) const -</h3> -Returns a list of all the strings containing the substring <em>str</em>. -<p> If <em>cs</em> is TRUE, the grep is done case-sensitively; otherwise -case is ignored. -<p> <pre> - TQStringList list; - list << "Bill Gates" << "John Doe" << "Bill Clinton"; - list = list.<a href="#grep">grep</a>( "Bill" ); - // list == ["Bill Gates", "Bill Clinton"] - </pre> - -<p> <p>See also <a href="ntqstring.html#find">TQString::find</a>(). - -<h3 class=fn><a href="ntqstringlist.html">TQStringList</a> <a name="grep-2"></a>TQStringList::grep ( const <a href="ntqregexp.html">TQRegExp</a> & rx ) const -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Returns a list of all the strings that match the <a href="ntqregexp.html#regular-expression">regular expression</a> <em>rx</em>. -<p> <p>See also <a href="ntqstring.html#find">TQString::find</a>(). - -<h3 class=fn><a href="ntqstringlist.html">TQStringList</a> & <a name="gres"></a>TQStringList::gres ( const <a href="ntqstring.html">TQString</a> & before, const <a href="ntqstring.html">TQString</a> & after, bool cs = TRUE ) -</h3> -Replaces every occurrence of the string <em>before</em> in the strings -that constitute the string list with the string <em>after</em>. Returns -a reference to the string list. -<p> If <em>cs</em> is TRUE, the search is case sensitive; otherwise the -search is case insensitive. -<p> Example: -<pre> - TQStringList list; - list << "alpha" << "beta" << "gamma" << "epsilon"; - list.<a href="#gres">gres</a>( "a", "o" ); - // list == ["olpho", "beto", "gommo", "epsilon"] - </pre> - -<p> <p>See also <a href="ntqstring.html#replace">TQString::replace</a>(). - -<h3 class=fn><a href="ntqstringlist.html">TQStringList</a> & <a name="gres-2"></a>TQStringList::gres ( const <a href="ntqregexp.html">TQRegExp</a> & rx, const <a href="ntqstring.html">TQString</a> & after ) -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> Replaces every occurrence of the regexp <em>rx</em> in the string -with <em>after</em>. Returns a reference to the string list. -<p> Example: -<pre> - TQStringList list; - list << "alpha" << "beta" << "gamma" << "epsilon"; - list.<a href="#gres">gres</a>( TQRegExp("^a"), "o" ); - // list == ["olpha", "beta", "gamma", "epsilon"] - </pre> - -<p> For regexps containing <a href="ntqregexp.html#capturing-text">capturing parentheses</a>, occurrences of <b>\1</b>, -<b>\2</b>, ..., in <em>after</em> are replaced with <em>rx</em>.cap(1), -cap(2), ... -<p> Example: -<pre> - TQStringList list; - list << "Bill Clinton" << "Gates, Bill"; - list.<a href="#gres">gres</a>( TQRegExp("^(.*), (.*)$"), "\\2 \\1" ); - // list == ["Bill Clinton", "Bill Gates"] - </pre> - -<p> <p>See also <a href="ntqstring.html#replace">TQString::replace</a>(). - -<h3 class=fn><a href="ntqstring.html">TQString</a> <a name="join"></a>TQStringList::join ( const <a href="ntqstring.html">TQString</a> & sep ) const -</h3> -Joins the string list into a single string with each element -separated by the string <em>sep</em> (which can be empty). -<p> <p>See also <a href="#split">split</a>(). - -<p>Examples: <a href="fileiconview-example.html#x872">fileiconview/qfileiconview.cpp</a> and <a href="toplevel-example.html#x2533">toplevel/options.ui.h</a>. -<h3 class=fn>void <a name="sort"></a>TQStringList::sort () -</h3> -Sorts the list of strings in ascending case-sensitive order. -<p> Sorting is very fast. It uses the <a href="ntqtl.html">TQt Template - Library's</a> efficient HeapSort implementation that has a -time complexity of O(n*log n). -<p> If you want to sort your strings in an arbitrary order consider -using a <a href="tqmap.html">TQMap</a>. For example you could use a TQMap<TQString,TQString> -to create a case-insensitive ordering (e.g. mapping the lowercase -text to the text), or a TQMap<int,TQString> to sort the strings by -some integer index, etc. - -<p>Example: <a href="themes-example.html#x341">themes/themes.cpp</a>. -<h3 class=fn><a href="ntqstringlist.html">TQStringList</a> <a name="split"></a>TQStringList::split ( const <a href="ntqregexp.html">TQRegExp</a> & sep, const <a href="ntqstring.html">TQString</a> & str, bool allowEmptyEntries = FALSE )<tt> [static]</tt> -</h3> -Splits the string <em>str</em> into strings wherever the <a href="ntqregexp.html#regular-expression">regular expression</a> <em>sep</em> occurs, and returns the list of those strings. -<p> If <em>allowEmptyEntries</em> is TRUE, a null string is inserted in -the list wherever the separator matches twice without intervening -text. -<p> For example, if you split the string "a,,b,c" on commas, <a href="#split">split</a>() -returns the three-item list "a", "b", "c" if <em>allowEmptyEntries</em> -is FALSE (the default), and the four-item list "a", "", "b", "c" -if <em>allowEmptyEntries</em> is TRUE. -<p> If <em>sep</em> does not match anywhere in <em>str</em>, split() returns a -single element list with the element containing the single string -<em>str</em>. -<p> <p>See also <a href="#join">join</a>() and <a href="ntqstring.html#section">TQString::section</a>(). - -<p>Examples: <a href="tutorial2-03.html#x2552">chart/element.cpp</a>, <a href="dirview-example.html#x1703">dirview/dirview.cpp</a>, and <a href="httpd-example.html#x733">network/httpd/httpd.cpp</a>. -<h3 class=fn><a href="ntqstringlist.html">TQStringList</a> <a name="split-2"></a>TQStringList::split ( const <a href="ntqstring.html">TQString</a> & sep, const <a href="ntqstring.html">TQString</a> & str, bool allowEmptyEntries = FALSE )<tt> [static]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This version of the function uses a <a href="ntqstring.html">TQString</a> as separator, rather -than a <a href="ntqregexp.html#regular-expression">regular expression</a>. -<p> If <em>sep</em> is an empty string, the return value is a list of -one-character strings: <a href="#split">split</a>( TQString( "" ), "four" ) returns the -four-item list, "f", "o", "u", "r". -<p> If <em>allowEmptyEntries</em> is TRUE, a null string is inserted in -the list wherever the separator matches twice without intervening -text. -<p> <p>See also <a href="#join">join</a>() and <a href="ntqstring.html#section">TQString::section</a>(). - -<h3 class=fn><a href="ntqstringlist.html">TQStringList</a> <a name="split-3"></a>TQStringList::split ( const <a href="qchar.html">TQChar</a> & sep, const <a href="ntqstring.html">TQString</a> & str, bool allowEmptyEntries = FALSE )<tt> [static]</tt> -</h3> -This is an overloaded member function, provided for convenience. It behaves essentially like the above function. -<p> This version of the function uses a <a href="qchar.html">TQChar</a> as separator, rather -than a <a href="ntqregexp.html#regular-expression">regular expression</a>. -<p> <p>See also <a href="#join">join</a>() and <a href="ntqstring.html#section">TQString::section</a>(). - -<!-- eof --> -<hr><p> -This file is part of the <a href="index.html">TQt toolkit</a>. -Copyright © 1995-2007 -<a href="http://www.trolltech.com/">Trolltech</a>. All Rights Reserved.<p><address><hr><div align=center> -<table width=100% cellspacing=0 border=0><tr> -<td>Copyright © 2007 -<a href="troll.html">Trolltech</a><td align=center><a href="trademarks.html">Trademarks</a> -<td align=right><div align=right>TQt 3.3.8</div> -</table></div></address></body> -</html> |