<?xml version="1.0" encoding="iso-8859-1"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
<html><head><title>QStringList Class Reference</title><style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm }
a:link { color: #004faf; text-decoration: none }
a:visited { color: #672967; text-decoration: none }
td.postheader { font-family: sans-serif }
tr.address { font-family: sans-serif }
body { background: #ffffff; color: black; }
</style></head><body><table border="0" cellpadding="0" cellspacing="0" width="100%"><tr /><td align="left" valign="top" width="32"><img align="left" border="0" height="32" src="images/rb-logo.png" width="32" /></td><td width="1">  </td><td class="postheader" 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="modules.html"><font color="#004faf">Modules</font></a></td></table><h1 align="center">QStringList Class Reference<br /><sup><sup>[<a href="qtcore.html">QtCore</a> module]</sup></sup></h1><p>The QStringList class provides a list of strings. <a href="#details">More...</a></p>
<h3>Methods</h3><ul><li><div class="fn" /><b><a href="qstringlist.html#QStringList">__init__</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#QStringList-2">__init__</a></b> (<i>self</i>, QString <i>i</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#QStringList-3">__init__</a></b> (<i>self</i>, QStringList <i>l</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#append">append</a></b> (<i>self</i>, QString <i>str</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#clear">clear</a></b> (<i>self</i>)</li><li><div class="fn" />bool <b><a href="qstringlist.html#contains">contains</a></b> (<i>self</i>, QString <i>str</i>, Qt.CaseSensitivity <i>cs</i> = Qt.CaseSensitive)</li><li><div class="fn" />int <b><a href="qstringlist.html#count">count</a></b> (<i>self</i>, QString <i>str</i>)</li><li><div class="fn" />int <b><a href="qstringlist.html#count-2">count</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#filter">filter</a></b> (<i>self</i>, QString <i>str</i>, Qt.CaseSensitivity <i>cs</i> = Qt.CaseSensitive)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#filter-2">filter</a></b> (<i>self</i>, QRegExp <i>rx</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#first">first</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qstringlist.html#indexOf">indexOf</a></b> (<i>self</i>, QString <i>value</i>, int <i>from</i> = 0)</li><li><div class="fn" />int <b><a href="qstringlist.html#indexOf-2">indexOf</a></b> (<i>self</i>, QRegExp <i>rx</i>, int <i>from</i> = 0)</li><li><div class="fn" /><b><a href="qstringlist.html#insert">insert</a></b> (<i>self</i>, int <i>i</i>, QString <i>str</i>)</li><li><div class="fn" />bool <b><a href="qstringlist.html#isEmpty">isEmpty</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#join">join</a></b> (<i>self</i>, QString <i>sep</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#last">last</a></b> (<i>self</i>)</li><li><div class="fn" />int <b><a href="qstringlist.html#lastIndexOf">lastIndexOf</a></b> (<i>self</i>, QString <i>value</i>, int <i>from</i> = -1)</li><li><div class="fn" />int <b><a href="qstringlist.html#lastIndexOf-2">lastIndexOf</a></b> (<i>self</i>, QRegExp <i>rx</i>, int <i>from</i> = -1)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#mid">mid</a></b> (<i>self</i>, int <i>pos</i>, int <i>length</i> = -1)</li><li><div class="fn" /><b><a href="qstringlist.html#move">move</a></b> (<i>self</i>, int <i>from</i>, int <i>to</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#prepend">prepend</a></b> (<i>self</i>, QString <i>str</i>)</li><li><div class="fn" />int <b><a href="qstringlist.html#removeAll">removeAll</a></b> (<i>self</i>, QString <i>str</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#removeAt">removeAt</a></b> (<i>self</i>, int <i>i</i>)</li><li><div class="fn" />int <b><a href="qstringlist.html#removeDuplicates">removeDuplicates</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#replace">replace</a></b> (<i>self</i>, int <i>i</i>, QString <i>str</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#replaceInStrings">replaceInStrings</a></b> (<i>self</i>, QString <i>before</i>, QString <i>after</i>, Qt.CaseSensitivity <i>cs</i> = Qt.CaseSensitive)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#replaceInStrings-2">replaceInStrings</a></b> (<i>self</i>, QRegExp <i>rx</i>, QString <i>after</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#sort">sort</a></b> (<i>self</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#swap">swap</a></b> (<i>self</i>, int <i>i</i>, int <i>j</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#takeAt">takeAt</a></b> (<i>self</i>, int <i>i</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#takeFirst">takeFirst</a></b> (<i>self</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#takeLast">takeLast</a></b> (<i>self</i>)</li></ul><h3>Special Methods</h3><ul><li><div class="fn" />QStringList <b><a href="qstringlist.html#__add__">__add__</a></b> (<i>self</i>, QStringList <i>other</i>)</li><li><div class="fn" />int <b><a href="qstringlist.html#__contains__">__contains__</a></b> (<i>self</i>, QString <i>str</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#__delitem__">__delitem__</a></b> (<i>self</i>, int <i>i</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#__delitem__-2">__delitem__</a></b> (<i>self</i>, slice <i>slice</i>)</li><li><div class="fn" />bool <b><a href="qstringlist.html#__eq__">__eq__</a></b> (<i>self</i>, QStringList <i>other</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#__getitem__">__getitem__</a></b> (<i>self</i>, int <i>i</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__getitem__-2">__getitem__</a></b> (<i>self</i>, slice <i>slice</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__iadd__">__iadd__</a></b> (<i>self</i>, QStringList <i>other</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__iadd__-2">__iadd__</a></b> (<i>self</i>, QString <i>value</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__imul__">__imul__</a></b> (<i>self</i>, int <i>by</i>)</li><li><div class="fn" /> <b><a href="qstringlist.html#__len__">__len__</a></b> (<i>self</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__lshift__">__lshift__</a></b> (<i>self</i>, QString <i>str</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__lshift__-2">__lshift__</a></b> (<i>self</i>, QStringList <i>l</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__mul__">__mul__</a></b> (<i>self</i>, int <i>by</i>)</li><li><div class="fn" />bool <b><a href="qstringlist.html#__ne__">__ne__</a></b> (<i>self</i>, QStringList <i>other</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#__setitem__">__setitem__</a></b> (<i>self</i>, int <i>i</i>, QString <i>str</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#__setitem__-2">__setitem__</a></b> (<i>self</i>, slice <i>slice</i>, QStringList <i>list</i>)</li></ul><a name="details" /><hr /><h2>Detailed Description</h2><p>A Python list of Python string or unicode objects or
<a href="qstring.html">QString</a> instances
may be used whenever a
<a href="qstringlist.html">QStringList</a>
is expected.</p>
<p>The QStringList class provides a list of strings.</p>
<p>QStringList inherits from <a href="qlist.html">QList</a><<a href="qstring.html">QString</a>>.
Like <a href="qlist.html">QList</a>, QStringList is <a href="implicit-sharing.html#implicitly-shared">implicitly shared</a>. It
provides fast index-based access as well as fast insertions and
removals. Passing string lists as value parameters is both fast and
safe.</p>
<p>All of <a href="qlist.html">QList</a>'s functionality also
applies to QStringList. For example, you can use <a href="qlist.html#isEmpty">isEmpty</a>() to test whether the list is
empty, and you can call functions like <a href="qlist.html#append">append</a>(), <a href="qlist.html#prepend">prepend</a>(), <a href="qlist.html#insert">insert</a>(), <a href="qlist.html#replace">replace</a>(), <a href="qlist.html#removeAll">removeAll</a>(), <a href="qlist.html#removeAt">removeAt</a>(), <a href="qlist.html#removeFirst">removeFirst</a>(), <a href="qlist.html#removeLast">removeLast</a>(), and <a href="qlist.html#removeOne">removeOne</a>() to modify a QStringList. In
addition, QStringList provides a few convenience functions that
make handling lists of strings easier:</p>
<a id="adding-strings" name="adding-strings" />
<h3>Adding strings</h3>
<p>Strings can be added to a list using the <a href="qlist.html#append">append()</a>, <a href="qlist.html#operator-2b-eq">operator+=</a>() and <a href="qstringlist.html#operator-lt-lt">operator<<</a>() functions.
For example:</p>
<pre class="cpp">
<span class="type">QStringList</span> fonts;
fonts <span class="operator"><</span><span class="operator"><</span> <span class="string">"Arial"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"Helvetica"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"Times"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"Courier"</span>;
</pre>
<a id="iterating-over-the-strings" name="iterating-over-the-strings" />
<h3>Iterating over the strings</h3>
<p>To iterate over a list, you can either use index positions or
<a href="qlist.html">QList</a>'s Java-style and STL-style iterator
types:</p>
<p>Indexing:</p>
<pre class="cpp">
<span class="keyword">for</span> (<span class="type">int</span> i <span class="operator">=</span> <span class="number">0</span>; i <span class="operator"><</span> fonts<span class="operator">.</span>size(); <span class="operator">+</span><span class="operator">+</span>i)
cout <span class="operator"><</span><span class="operator"><</span> fonts<span class="operator">.</span>at(i)<span class="operator">.</span>toLocal8Bit()<span class="operator">.</span>constData() <span class="operator"><</span><span class="operator"><</span> endl;
</pre>
<p>Java-style iterator:</p>
<pre class="cpp">
<span class="type"><a href="qstringlist.html#QStringListIterator-typedef">QStringListIterator</a></span> javaStyleIterator(fonts);
<span class="keyword">while</span> (javaStyleIterator<span class="operator">.</span>hasNext())
cout <span class="operator"><</span><span class="operator"><</span> javaStyleIterator<span class="operator">.</span>next()<span class="operator">.</span>toLocal8Bit()<span class="operator">.</span>constData() <span class="operator"><</span><span class="operator"><</span> endl;
</pre>
<p>STL-style iterator:</p>
<pre class="cpp">
<span class="type">QStringList</span><span class="operator">.</span>const_iterator constIterator;
<span class="keyword">for</span> (constIterator <span class="operator">=</span> fonts<span class="operator">.</span>constBegin(); constIterator <span class="operator">!</span><span class="operator">=</span> fonts<span class="operator">.</span>constEnd();
<span class="operator">+</span><span class="operator">+</span>constIterator)
cout <span class="operator"><</span><span class="operator"><</span> (<span class="operator">*</span>constIterator)<span class="operator">.</span>toLocal8Bit()<span class="operator">.</span>constData() <span class="operator"><</span><span class="operator"><</span> endl;
</pre>
<p>The <a href="qstringlist.html#QStringListIterator-typedef">QStringListIterator</a>
class is simply a type definition for <a href="qlistiterator.html">QListIterator</a><<a href="qstring.html">QString</a>>. QStringList also provide the
<a href="qstringlist.html#QMutableStringListIterator-typedef">QMutableStringListIterator</a>
class which is a type definition for <a href="qmutablelistiterator.html">QMutableListIterator</a><<a href="qstring.html">QString</a>>.</p>
<a id="manipulating-the-strings" name="manipulating-the-strings" />
<h3>Manipulating the strings</h3>
<p>QStringList provides several functions allowing you to
manipulate the contents of a list. You can concatenate all the
strings in a string list into a single string (with an optional
separator) using the <a href="qstringlist.html#join">join</a>()
function. For example:</p>
<pre class="cpp">
<span class="type"><a href="qstring.html">QString</a></span> str <span class="operator">=</span> fonts<span class="operator">.</span>join(<span class="string">","</span>);
<span class="comment">// str == "Arial,Helvetica,Times,Courier"</span>
</pre>
<p>To break up a string into a string list, use the <a href="qstring.html#split">QString.split</a>() function:</p>
<pre class="cpp">
<span class="type">QStringList</span> list;
list <span class="operator">=</span> str<span class="operator">.</span>split(<span class="string">","</span>);
<span class="comment">// list: ["Arial", "Helvetica", "Times", "Courier"]</span>
</pre>
<p>The argument to split can be a single character, a string, or a
<a href="qregexp.html">QRegExp</a>.</p>
<p>In addition, the <a href="qstringlist.html#operator-2b">operator+</a>() function allows you
to concatenate two string lists into one. To sort a string list,
use the <a href="qstringlist.html#sort">sort</a>() function.</p>
<p><a href="qstring.html">QString</a> list also provides the
<a href="qstringlist.html#filter">filter</a>() function which lets
you to extract a new list which contains only those strings which
contain a particular substring (or match a particular regular
expression):</p>
<pre class="cpp">
<span class="type">QStringList</span> monospacedFonts <span class="operator">=</span> fonts<span class="operator">.</span>filter(<span class="type"><a href="qregexp.html">QRegExp</a></span>(<span class="string">"Courier|Fixed"</span>));
</pre>
<p>The <a href="qstringlist.html#contains">contains</a>() function
tells you whether the list contains a given string, while the
<a href="qstringlist.html#indexOf">indexOf</a>() function returns
the index of the first occurrence of the given string. The <a href="qstringlist.html#lastIndexOf">lastIndexOf</a>() function on the
other hand, returns the index of the last occurrence of the
string.</p>
<p>Finally, the <a href="qstringlist.html#replaceInStrings">replaceInStrings</a>() function
calls <a href="qstring.html#replace">QString.replace</a>() on each
string in the string list in turn. For example:</p>
<pre class="cpp">
<span class="type">QStringList</span> files;
files <span class="operator"><</span><span class="operator"><</span> <span class="string">"$QTDIR/src/moc/moc.y"</span>
<span class="operator"><</span><span class="operator"><</span> <span class="string">"$QTDIR/src/moc/moc.l"</span>
<span class="operator"><</span><span class="operator"><</span> <span class="string">"$QTDIR/include/qconfig.h"</span>;
files<span class="operator">.</span>replaceInStrings(<span class="string">"$QTDIR"</span><span class="operator">,</span> <span class="string">"/usr/lib/qt"</span>);
<span class="comment">// files: [ "/usr/lib/qt/src/moc/moc.y", ...]</span>
</pre><hr /><h2>Method Documentation</h2><h3 class="fn"><a name="QStringList" />QStringList.__init__ (<i>self</i>)</h3><p>Constructs an empty string list.</p>
<h3 class="fn"><a name="QStringList-2" />QStringList.__init__ (<i>self</i>, QString <i>i</i>)</h3><p>Constructs a string list that contains the given string,
<i>str</i>. Longer lists are easily created like this:</p>
<pre class="cpp">
<span class="type"><a href="qstringlist.html">QStringList</a></span> longerList <span class="operator">=</span> (<span class="type"><a href="qstringlist.html">QStringList</a></span>() <span class="operator"><</span><span class="operator"><</span> str1 <span class="operator"><</span><span class="operator"><</span> str2 <span class="operator"><</span><span class="operator"><</span> str3);
</pre>
<p><b>See also</b> <a href="qlist.html#append">append</a>().</p>
<h3 class="fn"><a name="QStringList-3" />QStringList.__init__ (<i>self</i>, QStringList <i>l</i>)</h3><p>Constructs a copy of the <i>other</i> string list.</p>
<p>This operation takes <a href="containers.html#constant-time">constant time</a> because <a href="qstringlist.html">QStringList</a> is <a href="implicit-sharing.html#implicitly-shared">implicitly shared</a>,
making the process of returning a <a href="qstringlist.html">QStringList</a> from a function very fast. If a
shared instance is modified, it will be copied (copy-on-write), and
that takes <a href="containers.html#linear-time">linear
time</a>.</p>
<p><b>See also</b> <a href="qlist.html#operator-eq">operator=</a>().</p>
<h3 class="fn"><a name="append" />QStringList.append (<i>self</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="clear" />QStringList.clear (<i>self</i>)</h3><h3 class="fn"><a name="contains" />bool QStringList.contains (<i>self</i>, QString <i>str</i>, <a href="qt.html#CaseSensitivity-enum">Qt.CaseSensitivity</a> <i>cs</i> = Qt.CaseSensitive)</h3><p>Returns true if the list contains the string <i>str</i>;
otherwise returns false. The search is case insensitive if
<i>cs</i> is <a href="qt.html#CaseSensitivity-enum">Qt.CaseInsensitive</a>; the search
is case sensitive by default.</p>
<p><b>See also</b> <a href="qstringlist.html#indexOf">indexOf</a>(), <a href="qstringlist.html#lastIndexOf">lastIndexOf</a>(), and <a href="qstring.html#contains">QString.contains</a>().</p>
<h3 class="fn"><a name="count" />int QStringList.count (<i>self</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="count-2" />int QStringList.count (<i>self</i>)</h3><h3 class="fn"><a name="filter" />QStringList QStringList.filter (<i>self</i>, QString <i>str</i>, <a href="qt.html#CaseSensitivity-enum">Qt.CaseSensitivity</a> <i>cs</i> = Qt.CaseSensitive)</h3><p>Returns a list of all the strings containing the substring
<i>str</i>.</p>
<p>If <i>cs</i> is <a href="qt.html#CaseSensitivity-enum">Qt.CaseSensitive</a> (the default),
the string comparison is case sensitive; otherwise the comparison
is case insensitive.</p>
<pre class="cpp">
<span class="type"><a href="qstringlist.html">QStringList</a></span> list;
list <span class="operator"><</span><span class="operator"><</span> <span class="string">"Bill Murray"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"John Doe"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"Bill Clinton"</span>;
<span class="type"><a href="qstringlist.html">QStringList</a></span> result;
result <span class="operator">=</span> list<span class="operator">.</span>filter(<span class="string">"Bill"</span>);
<span class="comment">// result: ["Bill Murray", "Bill Clinton"]</span>
</pre>
<p>This is equivalent to</p>
<pre class="cpp">
<span class="type"><a href="qstringlist.html">QStringList</a></span> result;
foreach (<span class="keyword">const</span> <span class="type"><a href="qstring.html">QString</a></span> <span class="operator">&</span>str<span class="operator">,</span> list) {
<span class="keyword">if</span> (str<span class="operator">.</span>contains(<span class="string">"Bill"</span>))
result <span class="operator">+</span><span class="operator">=</span> str;
}
</pre>
<p><b>See also</b> <a href="qstringlist.html#contains">contains</a>().</p>
<h3 class="fn"><a name="filter-2" />QStringList QStringList.filter (<i>self</i>, <a href="qregexp.html">QRegExp</a> <i>rx</i>)</h3><p>This is an overloaded function.</p>
<p>Returns a list of all the strings that match the regular
expression <i>rx</i>.</p>
<h3 class="fn"><a name="first" />QString QStringList.first (<i>self</i>)</h3><h3 class="fn"><a name="indexOf" />int QStringList.indexOf (<i>self</i>, QString <i>value</i>, int <i>from</i> = 0)</h3><p>Returns the index position of the first exact match of <i>rx</i>
in the list, searching forward from index position <i>from</i>.
Returns -1 if no item matched.</p>
<p>By default, this function is case sensitive.</p>
<p><b>See also</b> <a href="qstringlist.html#lastIndexOf">lastIndexOf</a>(), <a href="qstringlist.html#contains">contains</a>(), and <a href="qregexp.html#exactMatch">QRegExp.exactMatch</a>().</p>
<h3 class="fn"><a name="indexOf-2" />int QStringList.indexOf (<i>self</i>, <a href="qregexp.html">QRegExp</a> <i>rx</i>, int <i>from</i> = 0)</h3><p>Returns the index position of the first occurrence of
<i>value</i> in the list, searching forward from index position
<i>from</i>. Returns -1 if no item matched.</p>
<p><b>See also</b> <a href="qstringlist.html#lastIndexOf">lastIndexOf</a>(), <a href="qstringlist.html#contains">contains</a>(), and <a href="qlist.html#indexOf">QList.indexOf</a>().</p>
<h3 class="fn"><a name="insert" />QStringList.insert (<i>self</i>, int <i>i</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="isEmpty" />bool QStringList.isEmpty (<i>self</i>)</h3><h3 class="fn"><a name="join" />QString QStringList.join (<i>self</i>, QString <i>sep</i>)</h3><p>Joins all the string list's strings into a single string with
each element separated by the given <i>separator</i> (which can be
an empty string).</p>
<p><b>See also</b> <a href="qstring.html#split">QString.split</a>().</p>
<h3 class="fn"><a name="last" />QString QStringList.last (<i>self</i>)</h3><h3 class="fn"><a name="lastIndexOf" />int QStringList.lastIndexOf (<i>self</i>, QString <i>value</i>, int <i>from</i> = -1)</h3><p>Returns the index position of the last exact match of <i>rx</i>
in the list, searching backward from index position <i>from</i>. If
<i>from</i> is -1 (the default), the search starts at the last
item. Returns -1 if no item matched.</p>
<p>By default, this function is case sensitive.</p>
<p><b>See also</b> <a href="qstringlist.html#indexOf">indexOf</a>(), <a href="qstringlist.html#contains">contains</a>(), and <a href="qregexp.html#exactMatch">QRegExp.exactMatch</a>().</p>
<h3 class="fn"><a name="lastIndexOf-2" />int QStringList.lastIndexOf (<i>self</i>, <a href="qregexp.html">QRegExp</a> <i>rx</i>, int <i>from</i> = -1)</h3><p>Returns the index position of the last occurrence of
<i>value</i> in the list, searching backward from index position
<i>from</i>. If <i>from</i> is -1 (the default), the search starts
at the last item. Returns -1 if no item matched.</p>
<p>By default, this function is case sensitive.</p>
<p><b>See also</b> <a href="qstringlist.html#indexOf">indexOf</a>()
and <a href="qlist.html#lastIndexOf">QList.lastIndexOf</a>().</p>
<h3 class="fn"><a name="mid" />QStringList QStringList.mid (<i>self</i>, int <i>pos</i>, int <i>length</i> = -1)</h3><h3 class="fn"><a name="move" />QStringList.move (<i>self</i>, int <i>from</i>, int <i>to</i>)</h3><h3 class="fn"><a name="prepend" />QStringList.prepend (<i>self</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="removeAll" />int QStringList.removeAll (<i>self</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="removeAt" />QStringList.removeAt (<i>self</i>, int <i>i</i>)</h3><h3 class="fn"><a name="removeDuplicates" />int QStringList.removeDuplicates (<i>self</i>)</h3><p>This function removes duplicate entries from a list. The entries
do not have to be sorted. They will retain their original
order.</p>
<p>Returns the number of removed entries.</p>
<p>This function was introduced in Qt 4.5.</p>
<h3 class="fn"><a name="replace" />QStringList.replace (<i>self</i>, int <i>i</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="replaceInStrings" />QStringList QStringList.replaceInStrings (<i>self</i>, QString <i>before</i>, QString <i>after</i>, <a href="qt.html#CaseSensitivity-enum">Qt.CaseSensitivity</a> <i>cs</i> = Qt.CaseSensitive)</h3><p>Returns a string list where every string has had the
<i>before</i> text replaced with the <i>after</i> text wherever the
<i>before</i> text is found. The <i>before</i> text is matched
case-sensitively or not depending on the <i>cs</i> flag.</p>
<p>For example:</p>
<pre class="cpp">
<span class="type"><a href="qstringlist.html">QStringList</a></span> list;
list <span class="operator"><</span><span class="operator"><</span> <span class="string">"alpha"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"beta"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"gamma"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"epsilon"</span>;
list<span class="operator">.</span>replaceInStrings(<span class="string">"a"</span><span class="operator">,</span> <span class="string">"o"</span>);
<span class="comment">// list == ["olpho", "beto", "gommo", "epsilon"]</span>
</pre>
<p><b>See also</b> <a href="qstring.html#replace">QString.replace</a>().</p>
<h3 class="fn"><a name="replaceInStrings-2" />QStringList QStringList.replaceInStrings (<i>self</i>, <a href="qregexp.html">QRegExp</a> <i>rx</i>, QString <i>after</i>)</h3><p>This is an overloaded function.</p>
<p>Replaces every occurrence of the regexp <i>rx</i>, in each of
the string lists's strings, with <i>after</i>. Returns a reference
to the string list.</p>
<p>For example:</p>
<pre class="cpp">
<span class="type"><a href="qstringlist.html">QStringList</a></span> list;
list <span class="operator"><</span><span class="operator"><</span> <span class="string">"alpha"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"beta"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"gamma"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"epsilon"</span>;
list<span class="operator">.</span>replaceInStrings(<span class="type"><a href="qregexp.html">QRegExp</a></span>(<span class="string">"^a"</span>)<span class="operator">,</span> <span class="string">"o"</span>);
<span class="comment">// list == ["olpha", "beta", "gamma", "epsilon"]</span>
</pre>
<p>For regular expressions that contain <a href="qregexp.html#capturing-parentheses">capturing parentheses</a>,
occurrences of <b>\1</b>, <b>\2</b>, ..., in <i>after</i> are
replaced with <i>rx</i>.cap(1), <i>rx</i>.cap(2), ...</p>
<p>For example:</p>
<pre class="cpp">
<span class="type"><a href="qstringlist.html">QStringList</a></span> list;
list <span class="operator"><</span><span class="operator"><</span> <span class="string">"Bill Clinton"</span> <span class="operator"><</span><span class="operator"><</span> <span class="string">"Murray, Bill"</span>;
list<span class="operator">.</span>replaceInStrings(<span class="type"><a href="qregexp.html">QRegExp</a></span>(<span class="string">"^(.*), (.*)$"</span>)<span class="operator">,</span> <span class="string">"\\2 \\1"</span>);
<span class="comment">// list == ["Bill Clinton", "Bill Murray"]</span>
</pre>
<h3 class="fn"><a name="sort" />QStringList.sort (<i>self</i>)</h3><p>Sorts the list of strings in ascending order (case
sensitively).</p>
<p>Sorting is performed using Qt's <a href="qtalgorithms.html#qSort">qSort</a>() algorithm, which operates in
<a href="containers.html#linear-logarithmic-time">linear-logarithmic
time</a>, i.e. O(<i>n</i> log <i>n</i>).</p>
<p>If you want to sort your strings in an arbitrary order, consider
using the <a href="qmap.html">QMap</a> class. For example, you
could use a <a href="qmap.html">QMap</a><<a href="qstring.html">QString</a>, <a href="qstring.html">QString</a>>
to create a case-insensitive ordering (e.g. with the keys being
lower-case versions of the strings, and the values being the
strings), or a <a href="qmap.html">QMap</a><int, <a href="qstring.html">QString</a>> to sort the strings by some integer
index.</p>
<p><b>See also</b> <a href="qtalgorithms.html#qSort">qSort</a>().</p>
<h3 class="fn"><a name="swap" />QStringList.swap (<i>self</i>, int <i>i</i>, int <i>j</i>)</h3><h3 class="fn"><a name="takeAt" />QString QStringList.takeAt (<i>self</i>, int <i>i</i>)</h3><h3 class="fn"><a name="takeFirst" />QString QStringList.takeFirst (<i>self</i>)</h3><h3 class="fn"><a name="takeLast" />QString QStringList.takeLast (<i>self</i>)</h3><h3 class="fn"><a name="__add__" />QStringList QStringList.__add__ (<i>self</i>, QStringList <i>other</i>)</h3><h3 class="fn"><a name="__contains__" />int QStringList.__contains__ (<i>self</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="__delitem__" />QStringList.__delitem__ (<i>self</i>, int <i>i</i>)</h3><h3 class="fn"><a name="__delitem__-2" />QStringList.__delitem__ (<i>self</i>, slice <i>slice</i>)</h3><h3 class="fn"><a name="__eq__" />bool QStringList.__eq__ (<i>self</i>, QStringList <i>other</i>)</h3><h3 class="fn"><a name="__getitem__" />QString QStringList.__getitem__ (<i>self</i>, int <i>i</i>)</h3><h3 class="fn"><a name="__getitem__-2" />QStringList QStringList.__getitem__ (<i>self</i>, slice <i>slice</i>)</h3><h3 class="fn"><a name="__iadd__" />QStringList QStringList.__iadd__ (<i>self</i>, QStringList <i>other</i>)</h3><h3 class="fn"><a name="__iadd__-2" />QStringList QStringList.__iadd__ (<i>self</i>, QString <i>value</i>)</h3><h3 class="fn"><a name="__imul__" />QStringList QStringList.__imul__ (<i>self</i>, int <i>by</i>)</h3><h3 class="fn"><a name="__len__" /> QStringList.__len__ (<i>self</i>)</h3><h3 class="fn"><a name="__lshift__" />QStringList QStringList.__lshift__ (<i>self</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="__lshift__-2" />QStringList QStringList.__lshift__ (<i>self</i>, QStringList <i>l</i>)</h3><h3 class="fn"><a name="__mul__" />QStringList QStringList.__mul__ (<i>self</i>, int <i>by</i>)</h3><h3 class="fn"><a name="__ne__" />bool QStringList.__ne__ (<i>self</i>, QStringList <i>other</i>)</h3><h3 class="fn"><a name="__setitem__" />QStringList.__setitem__ (<i>self</i>, int <i>i</i>, QString <i>str</i>)</h3><h3 class="fn"><a name="__setitem__-2" />QStringList.__setitem__ (<i>self</i>, slice <i>slice</i>, QStringList <i>list</i>)</h3><address><hr /><div align="center"><table border="0" cellspacing="0" width="100%"><tr class="address"><td align="left" width="25%">PyQt 4.10.3 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2012</td><td align="right" width="25%">Qt 4.8.5</td></tr></table></div></address></body></html>
