File: qstringlist.html

package info (click to toggle)
python-qt4 4.7.3-1%2Bsqueeze1
  • links: PTS, VCS
  • area: main
  • in suites: squeeze
  • size: 28,504 kB
  • ctags: 4,680
  • sloc: python: 28,738; cpp: 8,897; sh: 245; xml: 243; makefile: 150
file content (138 lines) | stat: -rw-r--r-- 26,459 bytes parent folder | download
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
<?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">&#160;&#160;</td><td class="postheader" valign="center"><a href="../pyqt4ref.html"><font color="#004faf">Home</font></a>&#160;&#183; <a href="classes.html"><font color="#004faf">All Classes</font></a>&#160;&#183; <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)</li><li><div class="fn" /><b><a href="qstringlist.html#QStringList-3">__init__</a></b> (<i>self</i>, QStringList)</li><li><div class="fn" /><b><a href="qstringlist.html#append">append</a></b> (<i>self</i>, QString&#160;<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, Qt.CaseSensitivity&#160;<i>cs</i>&#160;=&#160;Qt.CaseSensitive)</li><li><div class="fn" />int <b><a href="qstringlist.html#count">count</a></b> (<i>self</i>, QString&#160;<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, Qt.CaseSensitivity&#160;<i>cs</i>&#160;=&#160;Qt.CaseSensitive)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#filter-2">filter</a></b> (<i>self</i>, QRegExp)</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, int&#160;<i>from</i>&#160;=&#160;0)</li><li><div class="fn" />int <b><a href="qstringlist.html#indexOf-2">indexOf</a></b> (<i>self</i>, QRegExp, int&#160;<i>from</i>&#160;=&#160;0)</li><li><div class="fn" /><b><a href="qstringlist.html#insert">insert</a></b> (<i>self</i>, int&#160;<i>i</i>, QString&#160;<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)</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, int&#160;<i>from</i>&#160;=&#160;-1)</li><li><div class="fn" />int <b><a href="qstringlist.html#lastIndexOf-2">lastIndexOf</a></b> (<i>self</i>, QRegExp, int&#160;<i>from</i>&#160;=&#160;-1)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#mid">mid</a></b> (<i>self</i>, int&#160;<i>pos</i>, int&#160;<i>length</i>&#160;=&#160;-1)</li><li><div class="fn" /><b><a href="qstringlist.html#move">move</a></b> (<i>self</i>, int&#160;<i>from</i>, int&#160;<i>to</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#prepend">prepend</a></b> (<i>self</i>, QString&#160;<i>str</i>)</li><li><div class="fn" />int <b><a href="qstringlist.html#removeAll">removeAll</a></b> (<i>self</i>, QString&#160;<i>str</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#removeAt">removeAt</a></b> (<i>self</i>, int&#160;<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&#160;<i>i</i>, QString&#160;<i>str</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#replaceInStrings">replaceInStrings</a></b> (<i>self</i>, QString, QString, Qt.CaseSensitivity&#160;<i>cs</i>&#160;=&#160;Qt.CaseSensitive)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#replaceInStrings-2">replaceInStrings</a></b> (<i>self</i>, QRegExp, QString)</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&#160;<i>i</i>, int&#160;<i>j</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#takeAt">takeAt</a></b> (<i>self</i>, int&#160;<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)</li><li><div class="fn" />int <b><a href="qstringlist.html#__contains__">__contains__</a></b> (<i>self</i>, QString&#160;<i>str</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#__delitem__">__delitem__</a></b> (<i>self</i>, int&#160;<i>i</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#__delitem__-2">__delitem__</a></b> (<i>self</i>, slice&#160;<i>slice</i>)</li><li><div class="fn" />bool <b><a href="qstringlist.html#__eq__">__eq__</a></b> (<i>self</i>, QStringList&#160;<i>other</i>)</li><li><div class="fn" />QString <b><a href="qstringlist.html#__getitem__">__getitem__</a></b> (<i>self</i>, int&#160;<i>i</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__getitem__-2">__getitem__</a></b> (<i>self</i>, slice&#160;<i>slice</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__iadd__">__iadd__</a></b> (<i>self</i>, QStringList&#160;<i>other</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__iadd__-2">__iadd__</a></b> (<i>self</i>, QString&#160;<i>value</i>)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__imul__">__imul__</a></b> (<i>self</i>, int&#160;<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)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__lshift__-2">__lshift__</a></b> (<i>self</i>, QStringList)</li><li><div class="fn" />QStringList <b><a href="qstringlist.html#__mul__">__mul__</a></b> (<i>self</i>, int&#160;<i>by</i>)</li><li><div class="fn" />bool <b><a href="qstringlist.html#__ne__">__ne__</a></b> (<i>self</i>, QStringList&#160;<i>other</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#__setitem__">__setitem__</a></b> (<i>self</i>, int&#160;<i>i</i>, QString&#160;<i>str</i>)</li><li><div class="fn" /><b><a href="qstringlist.html#__setitem__-2">__setitem__</a></b> (<i>self</i>, slice&#160;<i>slice</i>, QStringList&#160;<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>&lt;<a href="qstring.html">QString</a>&gt;. 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>
<ul><li><a href="#adding-strings">Adding strings</a></li>
<li><a href="#iterating-over-the-strings">Iterating over the strings</a></li>
<li><a href="#manipulating-the-strings">Manipulating the strings</a></li>
</ul>
<a 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&lt;&lt;</a>() functions. For example:</p>
<pre>     QStringList fonts;
     fonts &lt;&lt; "Arial" &lt;&lt; "Helvetica" &lt;&lt; "Times" &lt;&lt; "Courier";</pre>
<a 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>     for (int i = 0; i &lt; fonts.size(); ++i)
          cout &lt;&lt; fonts.at(i).toLocal8Bit().constData() &lt;&lt; endl;</pre>
<p>Java-style iterator:</p>
<pre>     QStringListIterator javaStyleIterator(fonts);
     while (javaStyleIterator.hasNext())
          cout &lt;&lt; javaStyleIterator.next().toLocal8Bit().constData() &lt;&lt; endl;</pre>
<p>STL-style iterator:</p>
<pre>     QStringList.const_iterator constIterator;
     for (constIterator = fonts.constBegin(); constIterator != fonts.constEnd();
            ++constIterator)
         cout &lt;&lt; (*constIterator).toLocal8Bit().constData() &lt;&lt; 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>&lt;<a href="qstring.html">QString</a>&gt;. 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>&lt;<a href="qstring.html">QString</a>&gt;.</p>
<a 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>     QString str = fonts.join(",");
      <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>     QStringList list;
     list = str.split(",");
      <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>     QStringList monospacedFonts = fonts.filter(QRegExp("Courier|Fixed"));</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>     QStringList files;
     files &lt;&lt; "$QTDIR/src/moc/moc.y"
           &lt;&lt; "$QTDIR/src/moc/moc.l"
           &lt;&lt; "$QTDIR/include/qconfig.h";

     files.replaceInStrings("$QTDIR", "/usr/lib/qt");
     <span class="comment">// files: [ "/usr/lib/qt/src/moc/moc.y", ...]</span></pre>
<p>See also <a href="qstring.html">QString</a>.</p>
<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)</h3><p>Constructs a string list that contains the given string, <i>str</i>. Longer lists are easily created like this:</p>
<pre>     QStringList longerList = (QStringList() &lt;&lt; str1 &lt;&lt; str2 &lt;&lt; str3);</pre>
<p>See also <a href="qlist.html#append">append</a>().</p>
<h3 class="fn"><a name="QStringList-3" />QStringList.__init__ (<i>self</i>, QStringList)</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>See also <a href="qlist.html#operator-eq">operator=</a>().</p>
<h3 class="fn"><a name="append" />QStringList.append (<i>self</i>, QString&#160;<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, <a href="qt.html#CaseSensitivity-enum">Qt.CaseSensitivity</a>&#160;<i>cs</i>&#160;=&#160;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>See also <a href="qstringlist.html#indexOf">indexOf</a>(), <a href="qstringlist.html#lastIndexOf">lastIndexOf</a>(), and <a href="qstring.html#contains">QString.contains</a>().</p>
<a name="//apple_ref/cpp/instm/QStringList/filter" />
<h3 class="fn"><a name="count" />int QStringList.count (<i>self</i>, QString&#160;<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, <a href="qt.html#CaseSensitivity-enum">Qt.CaseSensitivity</a>&#160;<i>cs</i>&#160;=&#160;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>     QStringList list;
     list &lt;&lt; "Bill Murray" &lt;&lt; "John Doe" &lt;&lt; "Bill Clinton";

     QStringList result;
     result = list.filter("Bill");
     <span class="comment">// result: ["Bill Murray", "Bill Clinton"]</span></pre>
<p>This is equivalent to</p>
<pre>     QStringList result;
     foreach (QString str, list) {
         if (str.contains("Bill"))
             result += str;
     }</pre>
<p>See also <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>)</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>
<a name="//apple_ref/cpp/instm/QStringList/indexOf" />
<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, int&#160;<i>from</i>&#160;=&#160;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>See also <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>, int&#160;<i>from</i>&#160;=&#160;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>See also <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&#160;<i>i</i>, QString&#160;<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)</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>See also <a href="qstring.html#split">QString.split</a>().</p>
<a name="//apple_ref/cpp/instm/QStringList/lastIndexOf" />
<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, int&#160;<i>from</i>&#160;=&#160;-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>See also <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>, int&#160;<i>from</i>&#160;=&#160;-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>See also <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&#160;<i>pos</i>, int&#160;<i>length</i>&#160;=&#160;-1)</h3><h3 class="fn"><a name="move" />QStringList.move (<i>self</i>, int&#160;<i>from</i>, int&#160;<i>to</i>)</h3><h3 class="fn"><a name="prepend" />QStringList.prepend (<i>self</i>, QString&#160;<i>str</i>)</h3><h3 class="fn"><a name="removeAll" />int QStringList.removeAll (<i>self</i>, QString&#160;<i>str</i>)</h3><h3 class="fn"><a name="removeAt" />QStringList.removeAt (<i>self</i>, int&#160;<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>
<a name="//apple_ref/cpp/instm/QStringList/replaceInStrings" />
<h3 class="fn"><a name="replace" />QStringList.replace (<i>self</i>, int&#160;<i>i</i>, QString&#160;<i>str</i>)</h3><h3 class="fn"><a name="replaceInStrings" />QStringList QStringList.replaceInStrings (<i>self</i>, QString, QString, <a href="qt.html#CaseSensitivity-enum">Qt.CaseSensitivity</a>&#160;<i>cs</i>&#160;=&#160;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>     QStringList list;
     list &lt;&lt; "alpha" &lt;&lt; "beta" &lt;&lt; "gamma" &lt;&lt; "epsilon";
     list.replaceInStrings("a", "o");
     <span class="comment">// list == ["olpho", "beto", "gommo", "epsilon"]</span></pre>
<p>See also <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>, QString)</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>     QStringList list;
     list &lt;&lt; "alpha" &lt;&lt; "beta" &lt;&lt; "gamma" &lt;&lt; "epsilon";
     list.replaceInStrings(QRegExp("^a"), "o");
     <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>     QStringList list;
     list &lt;&lt; "Bill Clinton" &lt;&lt; "Murray, Bill";
     list.replaceInStrings(QRegExp("^(.*), (.*)$"), "\\2 \\1");
     <span class="comment">// list == ["Bill Clinton", "Bill Murray"]</span></pre>
<a name="//apple_ref/cpp/instm/QStringList/sort" />
<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>&lt;<a href="qstring.html">QString</a>, <a href="qstring.html">QString</a>&gt; 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>&lt;int, <a href="qstring.html">QString</a>&gt; to sort the strings by some integer index.</p>
<p>See also <a href="qtalgorithms.html#qSort">qSort</a>().</p>
<a name="//apple_ref/cpp/instm/QStringList/operator+" />
<h3 class="fn"><a name="swap" />QStringList.swap (<i>self</i>, int&#160;<i>i</i>, int&#160;<i>j</i>)</h3><h3 class="fn"><a name="takeAt" />QString QStringList.takeAt (<i>self</i>, int&#160;<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)</h3><h3 class="fn"><a name="__contains__" />int QStringList.__contains__ (<i>self</i>, QString&#160;<i>str</i>)</h3><h3 class="fn"><a name="__delitem__" />QStringList.__delitem__ (<i>self</i>, int&#160;<i>i</i>)</h3><h3 class="fn"><a name="__delitem__-2" />QStringList.__delitem__ (<i>self</i>, slice&#160;<i>slice</i>)</h3><h3 class="fn"><a name="__eq__" />bool QStringList.__eq__ (<i>self</i>, QStringList&#160;<i>other</i>)</h3><h3 class="fn"><a name="__getitem__" />QString QStringList.__getitem__ (<i>self</i>, int&#160;<i>i</i>)</h3><h3 class="fn"><a name="__getitem__-2" />QStringList QStringList.__getitem__ (<i>self</i>, slice&#160;<i>slice</i>)</h3><h3 class="fn"><a name="__iadd__" />QStringList QStringList.__iadd__ (<i>self</i>, QStringList&#160;<i>other</i>)</h3><h3 class="fn"><a name="__iadd__-2" />QStringList QStringList.__iadd__ (<i>self</i>, QString&#160;<i>value</i>)</h3><h3 class="fn"><a name="__imul__" />QStringList QStringList.__imul__ (<i>self</i>, int&#160;<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)</h3><h3 class="fn"><a name="__lshift__-2" />QStringList QStringList.__lshift__ (<i>self</i>, QStringList)</h3><h3 class="fn"><a name="__mul__" />QStringList QStringList.__mul__ (<i>self</i>, int&#160;<i>by</i>)</h3><h3 class="fn"><a name="__ne__" />bool QStringList.__ne__ (<i>self</i>, QStringList&#160;<i>other</i>)</h3><h3 class="fn"><a name="__setitem__" />QStringList.__setitem__ (<i>self</i>, int&#160;<i>i</i>, QString&#160;<i>str</i>)</h3><h3 class="fn"><a name="__setitem__-2" />QStringList.__setitem__ (<i>self</i>, slice&#160;<i>slice</i>, QStringList&#160;<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&#160;4.7.3 for X11</td><td align="center" width="50%">Copyright &#169; <a href="http://www.riverbankcomputing.com">Riverbank&#160;Computing&#160;Ltd</a> and <a href="http://www.qtsoftware.com">Nokia</a> 2010</td><td align="right" width="25%">Qt&#160;4.6.2</td></tr></table></div></address></body></html>