1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
|
<?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" />int <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__" />int 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.12.1 for X11</td><td align="center" width="50%">Copyright © <a href="http://www.riverbankcomputing.com">Riverbank Computing Ltd</a> and <a href="http://www.qt.io">The Qt Company</a> 2015</td><td align="right" width="25%">Qt 4.8.7</td></tr></table></div></address></body></html>
|
