summaryrefslogtreecommitdiffstats
path: root/doc/html/ntqstringlist.html
diff options
context:
space:
mode:
authorTimothy Pearson <kb9vqf@pearsoncomputing.net>2012-01-26 23:32:43 -0600
committerTimothy Pearson <kb9vqf@pearsoncomputing.net>2012-01-26 23:32:43 -0600
commitea318d1431c89e647598c510c4245c6571aa5f46 (patch)
tree996d29b80c30d453dda86d1a23162d441628f169 /doc/html/ntqstringlist.html
parentaaf89d4b48f69c9293feb187db26362e550b5561 (diff)
downloadtqt3-ea318d1431c89e647598c510c4245c6571aa5f46.tar.gz
tqt3-ea318d1431c89e647598c510c4245c6571aa5f46.zip
Update to latest tqt3 automated conversion
Diffstat (limited to 'doc/html/ntqstringlist.html')
-rw-r--r--doc/html/ntqstringlist.html309
1 files changed, 309 insertions, 0 deletions
diff --git a/doc/html/ntqstringlist.html b/doc/html/ntqstringlist.html
new file mode 100644
index 000000000..f5f71456d
--- /dev/null
+++ b/doc/html/ntqstringlist.html
@@ -0,0 +1,309 @@
+<!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&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>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 &lt;<a href="qstringlist-h.html">ntqstringlist.h</a>&gt;</tt>
+<p>Inherits <a href="ntqvaluelist.html">TQValueList</a>&lt;TQString&gt;.
+<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&nbsp;TQStringList&nbsp;&amp;&nbsp;l )</li>
+<li class=fn><a href="#TQStringList-3"><b>TQStringList</b></a> ( const&nbsp;TQValueList&lt;TQString&gt;&nbsp;&amp;&nbsp;l )</li>
+<li class=fn><a href="#TQStringList-4"><b>TQStringList</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;i )</li>
+<li class=fn><a href="#TQStringList-5"><b>TQStringList</b></a> ( const&nbsp;char&nbsp;*&nbsp;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&nbsp;TQString&nbsp;&amp;&nbsp;sep ) const</li>
+<li class=fn>TQStringList <a href="#grep"><b>grep</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;str, bool&nbsp;cs = TRUE ) const</li>
+<li class=fn>TQStringList <a href="#grep-2"><b>grep</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;rx ) const</li>
+<li class=fn>TQStringList &amp; <a href="#gres"><b>gres</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;before, const&nbsp;TQString&nbsp;&amp;&nbsp;after, bool&nbsp;cs = TRUE )</li>
+<li class=fn>TQStringList &amp; <a href="#gres-2"><b>gres</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;rx, const&nbsp;TQString&nbsp;&amp;&nbsp;after )</li>
+</ul>
+<h2>Static Public Members</h2>
+<ul>
+<li class=fn>TQStringList <a href="#fromStrList"><b>fromStrList</b></a> ( const&nbsp;TQStrList&nbsp;&amp;&nbsp;ascii )</li>
+<li class=fn>TQStringList <a href="#split-2"><b>split</b></a> ( const&nbsp;TQString&nbsp;&amp;&nbsp;sep, const&nbsp;TQString&nbsp;&amp;&nbsp;str, bool&nbsp;allowEmptyEntries = FALSE )</li>
+<li class=fn>TQStringList <a href="#split-3"><b>split</b></a> ( const&nbsp;TQChar&nbsp;&amp;&nbsp;sep, const&nbsp;TQString&nbsp;&amp;&nbsp;str, bool&nbsp;allowEmptyEntries = FALSE )</li>
+<li class=fn>TQStringList <a href="#split"><b>split</b></a> ( const&nbsp;TQRegExp&nbsp;&amp;&nbsp;sep, const&nbsp;TQString&nbsp;&amp;&nbsp;str, bool&nbsp;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="ntqvaluelist.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="ntqvaluelist.html#append">append</a>(), <a href="ntqvaluelist.html#operator+-eq">operator+=</a>() or
+<a href="ntqvaluelist.html#operator-lt-lt">operator&lt;&lt;</a>(), e.g.
+<pre>
+ TQStringList fonts;
+ fonts.<a href="ntqvaluelist.html#append">append</a>( "Times" );
+ fonts += "Courier";
+ fonts += "Courier New";
+ fonts &lt;&lt; "Helvetica [Cronyx]" &lt;&lt; "Helvetica [Adobe]";
+ </pre>
+
+<p> String lists have an iterator, TQStringList::Iterator(), e.g.
+<pre>
+ for ( TQStringList::<a href="ntqvaluelist.html#Iterator">Iterator</a> it = fonts.begin(); it != fonts.end(); ++it ) {
+ cout &lt;&lt; *it &lt;&lt; ":";
+ }
+ cout &lt;&lt; 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 &lt;&lt; allFonts &lt;&lt; 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 &lt;&lt; fonts.join( ", " ) &lt;&lt; endl;
+ // Output:
+ // Courier, Courier New, Helvetica [Adobe], Helvetica [Cronyx], Times
+
+ TQStringList helveticas = fonts.grep( "Helvetica" );
+ cout &lt;&lt; helveticas.<a href="#join">join</a>( ", " ) &lt;&lt; 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 &lt;&lt; colors.<a href="#join">join</a>( ", " ) &lt;&lt; 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&nbsp;<a href="ntqstringlist.html">TQStringList</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="ntqvaluelist.html">TQValueList</a>&lt;TQString&gt;&nbsp;&amp;&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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 &lt;&lt; "Buy" &lt;&lt; "Sell" &lt;&lt; "Update" &lt;&lt; "Value";
+ </pre>
+
+
+<h3 class=fn><a name="TQStringList-5"></a>TQStringList::TQStringList ( const&nbsp;char&nbsp;*&nbsp;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&nbsp;<a href="ntqstrlist.html">TQStrList</a>&nbsp;&amp;&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str, bool&nbsp;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 &lt;&lt; "Bill Gates" &lt;&lt; "John Doe" &lt;&lt; "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&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 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>&nbsp;&amp; <a name="gres"></a>TQStringList::gres ( 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>
+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 &lt;&lt; "alpha" &lt;&lt; "beta" &lt;&lt; "gamma" &lt;&lt; "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>&nbsp;&amp; <a name="gres-2"></a>TQStringList::gres ( 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 list.
+<p> Example:
+<pre>
+ TQStringList list;
+ list &lt;&lt; "alpha" &lt;&lt; "beta" &lt;&lt; "gamma" &lt;&lt; "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>&#92;1</b>,
+<b>&#92;2</b>, ..., in <em>after</em> are replaced with <em>rx</em>.cap(1),
+cap(2), ...
+<p> Example:
+<pre>
+ TQStringList list;
+ list &lt;&lt; "Bill Clinton" &lt;&lt; "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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;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="ntqmap.html">TQMap</a>. For example you could use a TQMap&lt;TQString,TQString&gt;
+to create a case-insensitive ordering (e.g. mapping the lowercase
+text to the text), or a TQMap&lt;int,TQString&gt; 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&nbsp;<a href="ntqregexp.html">TQRegExp</a>&nbsp;&amp;&nbsp;sep, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str, bool&nbsp;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&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;sep, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str, bool&nbsp;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&nbsp;<a href="qchar.html">TQChar</a>&nbsp;&amp;&nbsp;sep, const&nbsp;<a href="ntqstring.html">TQString</a>&nbsp;&amp;&nbsp;str, bool&nbsp;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 &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>