1
<?xml version="1.0" encoding="iso-8859-1"?>
3
PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5
<!-- /tmp/qt-4.0.0-espenr-1119621036935/qt-x11-opensource-desktop-4.0.0/src/corelib/tools/qstring.cpp -->
7
<title>Qt 4.0: Qt 3 Support Members for QString</title>
8
<style>h3.fn,span.fn { margin-left: 1cm; text-indent: -1cm; }
9
a:link { color: #004faf; text-decoration: none }
10
a:visited { color: #672967; text-decoration: none }
11
td.postheader { font-family: sans-serif }
12
tr.address { font-family: sans-serif }
13
body { background: #ffffff; color: black; }</style>
16
<table border="0" cellpadding="0" cellspacing="0" width="100%">
18
<td align="left" valign="top" width="32"><img src="images/qt-logo.png" align="left" width="32" height="32" border="0" /></td>
19
<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="mainclasses.html"><font color="#004faf">Main Classes</font></a> · <a href="annotated.html"><font color="#004faf">Annotated</font></a> · <a href="groups.html"><font color="#004faf">Grouped Classes</font></a> · <a href="functions.html"><font color="#004faf">Functions</font></a></td>
20
<td align="right" valign="top" width="230"><img src="images/trolltech-logo.png" align="right" width="203" height="32" border="0" /></td></tr></table><h1 align="center">Qt 3 Support Members for QString</h1>
21
<p><b>The following class members are part of the Qt 3 support layer.</b> They are provided to help you port old code to Qt 4. We advise against using them in new code.</p>
22
<p><ul><li><a href="qstring.html">QString class reference</a></li></ul></p>
23
<h3>Public Functions</h3>
25
<li><div class="fn"/>const char * <b><a href="qstring-qt3.html#ascii">ascii</a></b> () const</li>
26
<li><div class="fn"/>QChar <b><a href="qstring-qt3.html#constref">constref</a></b> ( uint <i>i</i> ) const</li>
27
<li><div class="fn"/>bool <b><a href="qstring-qt3.html#contains-2">contains</a></b> ( QChar <i>c</i>, bool <i>cs</i> ) const</li>
28
<li><div class="fn"/>bool <b><a href="qstring-qt3.html#contains-3">contains</a></b> ( const QString & <i>s</i>, bool <i>cs</i> ) const</li>
29
<li><div class="fn"/>QString <b><a href="qstring-qt3.html#copy">copy</a></b> () const</li>
30
<li><div class="fn"/>bool <b><a href="qstring-qt3.html#endsWith-2">endsWith</a></b> ( const QString & <i>s</i>, bool <i>cs</i> ) const</li>
31
<li><div class="fn"/>int <b><a href="qstring-qt3.html#find">find</a></b> ( QChar <i>c</i>, int <i>i</i> = 0, bool <i>cs</i> = true ) const</li>
32
<li><div class="fn"/>int <b><a href="qstring-qt3.html#find-2">find</a></b> ( const QString & <i>s</i>, int <i>i</i> = 0, bool <i>cs</i> = true ) const</li>
33
<li><div class="fn"/>int <b><a href="qstring-qt3.html#find-3">find</a></b> ( const QRegExp & <i>rx</i>, int <i>i</i> = 0 ) const</li>
34
<li><div class="fn"/>int <b><a href="qstring-qt3.html#findRev">findRev</a></b> ( QChar <i>c</i>, int <i>i</i> = -1, bool <i>cs</i> = true ) const</li>
35
<li><div class="fn"/>int <b><a href="qstring-qt3.html#findRev-2">findRev</a></b> ( const QString & <i>s</i>, int <i>i</i> = -1, bool <i>cs</i> = true ) const</li>
36
<li><div class="fn"/>int <b><a href="qstring-qt3.html#findRev-3">findRev</a></b> ( const QRegExp & <i>rx</i>, int <i>i</i> = -1 ) const</li>
37
<li><div class="fn"/>const char * <b><a href="qstring-qt3.html#latin1">latin1</a></b> () const</li>
38
<li><div class="fn"/>QString <b><a href="qstring-qt3.html#leftJustify">leftJustify</a></b> ( int <i>width</i>, QChar <i>fill</i> = QLatin1Char( ' ' ), bool <i>trunc</i> = false ) const</li>
39
<li><div class="fn"/>QByteArray <b><a href="qstring-qt3.html#local8Bit">local8Bit</a></b> () const</li>
40
<li><div class="fn"/>QString <b><a href="qstring-qt3.html#lower">lower</a></b> () const</li>
41
<li><div class="fn"/>QChar & <b><a href="qstring-qt3.html#ref">ref</a></b> ( uint <i>i</i> )</li>
42
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#remove-2">remove</a></b> ( QChar <i>c</i>, bool <i>cs</i> )</li>
43
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#remove-3">remove</a></b> ( const QString & <i>s</i>, bool <i>cs</i> )</li>
44
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#replace-2">replace</a></b> ( QChar <i>c</i>, const QString & <i>after</i>, bool <i>cs</i> )</li>
45
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#replace-3">replace</a></b> ( const QString & <i>before</i>, const QString & <i>after</i>, bool <i>cs</i> )</li>
46
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#replace-4">replace</a></b> ( char <i>c</i>, const QString & <i>after</i>, bool <i>cs</i> )</li>
47
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#replace-5">replace</a></b> ( char <i>c</i>, const QString & <i>after</i>, Qt::CaseSensitivity <i>cs</i> )</li>
48
<li><div class="fn"/>QString <b><a href="qstring-qt3.html#rightJustify">rightJustify</a></b> ( int <i>width</i>, QChar <i>fill</i> = QLatin1Char( ' ' ), bool <i>trunc</i> = false ) const</li>
49
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#setAscii">setAscii</a></b> ( const char * <i>str</i>, int <i>len</i> = -1 )</li>
50
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#setLatin1">setLatin1</a></b> ( const char * <i>str</i>, int <i>len</i> = -1 )</li>
51
<li><div class="fn"/>void <b><a href="qstring-qt3.html#setLength">setLength</a></b> ( int <i>nl</i> )</li>
52
<li><div class="fn"/>QString & <b><a href="qstring-qt3.html#setUnicodeCodes">setUnicodeCodes</a></b> ( const ushort * <i>unicode_as_ushorts</i>, int <i>size</i> )</li>
53
<li><div class="fn"/>QString <b><a href="qstring-qt3.html#simplifyWhiteSpace">simplifyWhiteSpace</a></b> () const</li>
54
<li><div class="fn"/>bool <b><a href="qstring-qt3.html#startsWith-2">startsWith</a></b> ( const QString & <i>s</i>, bool <i>cs</i> ) const</li>
55
<li><div class="fn"/>QString <b><a href="qstring-qt3.html#stripWhiteSpace">stripWhiteSpace</a></b> () const</li>
56
<li><div class="fn"/>const ushort * <b><a href="qstring-qt3.html#ucs2">ucs2</a></b> () const</li>
57
<li><div class="fn"/>QString <b><a href="qstring-qt3.html#upper">upper</a></b> () const</li>
58
<li><div class="fn"/>QByteArray <b><a href="qstring-qt3.html#utf8">utf8</a></b> () const</li>
59
<li><div class="fn"/><b><a href="qstring-qt3.html#operator-const-char--2a">operator const char *</a></b> () const</li>
61
<h3>Static Public Members</h3>
63
<li><div class="fn"/>QString <b><a href="qstring-qt3.html#fromUcs2">fromUcs2</a></b> ( const ushort * <i>unicode</i>, int <i>size</i> = -1 )</li>
66
<h2>Member Function Documentation</h2>
67
<h3 class="fn"><a name="ascii"></a>const char * QString::ascii () const</h3>
68
<p>Use <a href="qstring.html#toAscii">toAscii</a>() instead.</p>
69
<h3 class="fn"><a name="constref"></a><a href="qchar.html">QChar</a> QString::constref ( <a href="qtglobal.html#uint-typedef">uint</a> <i>i</i> ) const</h3>
70
<p>Use <a href="qstring.html#at">at</a>() instead.</p>
71
<h3 class="fn"><a name="contains-2"></a>bool QString::contains ( <a href="qchar.html">QChar</a> <i>c</i>, bool <i>cs</i> ) const</h3>
72
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
73
<p>Use the contains(<a href="qchar.html">QChar</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
74
<h3 class="fn"><a name="contains-3"></a>bool QString::contains ( const QString & <i>s</i>, bool <i>cs</i> ) const</h3>
75
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
76
<p>Use the contains(<a href="qstring.html">QString</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
77
<h3 class="fn"><a name="copy"></a>QString QString::copy () const</h3>
78
<p>Use simple assignment instead. <a href="qstring.html">QString</a> is implicitly shared so if a copy is modified only the copy is changed.</p>
79
<h3 class="fn"><a name="endsWith-2"></a>bool QString::endsWith ( const QString & <i>s</i>, bool <i>cs</i> ) const</h3>
80
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
81
<p>Use the endsWith(<a href="qstring.html">QString</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
82
<h3 class="fn"><a name="find"></a>int QString::find ( <a href="qchar.html">QChar</a> <i>c</i>, int <i>i</i> = 0, bool <i>cs</i> = true ) const</h3>
83
<p>Use <a href="qstring.html#indexOf">indexOf</a>() instead.</p>
84
<h3 class="fn"><a name="find-2"></a>int QString::find ( const QString & <i>s</i>, int <i>i</i> = 0, bool <i>cs</i> = true ) const</h3>
85
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
86
<p>Use <a href="qstring.html#indexOf">indexOf</a>() instead.</p>
87
<h3 class="fn"><a name="find-3"></a>int QString::find ( const <a href="qregexp.html">QRegExp</a> & <i>rx</i>, int <i>i</i> = 0 ) const</h3>
88
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
89
<p>Use <a href="qstring.html#indexOf">indexOf</a>() instead.</p>
90
<h3 class="fn"><a name="findRev"></a>int QString::findRev ( <a href="qchar.html">QChar</a> <i>c</i>, int <i>i</i> = -1, bool <i>cs</i> = true ) const</h3>
91
<p>Use <a href="qstring.html#lastIndexOf">lastIndexOf</a>() instead.</p>
92
<h3 class="fn"><a name="findRev-2"></a>int QString::findRev ( const QString & <i>s</i>, int <i>i</i> = -1, bool <i>cs</i> = true ) const</h3>
93
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
94
<p>Use <a href="qstring.html#lastIndexOf">lastIndexOf</a>() instead.</p>
95
<h3 class="fn"><a name="findRev-3"></a>int QString::findRev ( const <a href="qregexp.html">QRegExp</a> & <i>rx</i>, int <i>i</i> = -1 ) const</h3>
96
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
97
<p>Use <a href="qstring.html#lastIndexOf">lastIndexOf</a>() instead.</p>
98
<h3 class="fn"><a name="fromUcs2"></a>QString QString::fromUcs2 ( const <a href="qtglobal.html#ushort-typedef">ushort</a> * <i>unicode</i>, int <i>size</i> = -1 ) <tt> [static]</tt></h3>
99
<p>Use <a href="qstring.html#fromUtf16">fromUtf16</a>() instead.</p>
100
<h3 class="fn"><a name="latin1"></a>const char * QString::latin1 () const</h3>
101
<p>Use <a href="qstring.html#toLatin1">toLatin1</a>() instead.</p>
102
<h3 class="fn"><a name="leftJustify"></a>QString QString::leftJustify ( int <i>width</i>, <a href="qchar.html">QChar</a> <i>fill</i> = QLatin1Char( ' ' ), bool <i>trunc</i> = false ) const</h3>
103
<p>Use <a href="qstring.html#leftJustified">leftJustified</a>() instead.</p>
104
<h3 class="fn"><a name="local8Bit"></a><a href="qbytearray.html">QByteArray</a> QString::local8Bit () const</h3>
105
<p>Use <a href="qstring.html#toLocal8Bit">toLocal8Bit</a>() instead.</p>
106
<h3 class="fn"><a name="lower"></a>QString QString::lower () const</h3>
107
<p>Use <a href="qstring.html#toLower">toLower</a>() instead.</p>
108
<h3 class="fn"><a name="ref"></a><a href="qchar.html">QChar</a> & QString::ref ( <a href="qtglobal.html#uint-typedef">uint</a> <i>i</i> )</h3>
109
<p>Use operator[]() instead.</p>
110
<h3 class="fn"><a name="remove-2"></a>QString & QString::remove ( <a href="qchar.html">QChar</a> <i>c</i>, bool <i>cs</i> )</h3>
111
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
112
<p>Use the remove(<a href="qchar.html">QChar</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
113
<h3 class="fn"><a name="remove-3"></a>QString & QString::remove ( const QString & <i>s</i>, bool <i>cs</i> )</h3>
114
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
115
<p>Use the remove(<a href="qstring.html">QString</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
116
<h3 class="fn"><a name="replace-2"></a>QString & QString::replace ( <a href="qchar.html">QChar</a> <i>c</i>, const QString & <i>after</i>, bool <i>cs</i> )</h3>
117
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
118
<p>Use the replace(<a href="qchar.html">QChar</a>, <a href="qstring.html">QString</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
119
<h3 class="fn"><a name="replace-3"></a>QString & QString::replace ( const QString & <i>before</i>, const QString & <i>after</i>, bool <i>cs</i> )</h3>
120
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
121
<p>Use the replace(<a href="qstring.html">QString</a>, <a href="qstring.html">QString</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
122
<h3 class="fn"><a name="replace-4"></a>QString & QString::replace ( char <i>c</i>, const QString & <i>after</i>, bool <i>cs</i> )</h3>
123
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
124
<p>Use the replace(<a href="qchar.html">QChar</a>, <a href="qstring.html">QString</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
125
<h3 class="fn"><a name="replace-5"></a>QString & QString::replace ( char <i>c</i>, const QString & <i>after</i>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitivity</a> <i>cs</i> )</h3>
126
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
127
<p>Use the replace(<a href="qchar.html">QChar</a>, <a href="qstring.html">QString</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
128
<h3 class="fn"><a name="rightJustify"></a>QString QString::rightJustify ( int <i>width</i>, <a href="qchar.html">QChar</a> <i>fill</i> = QLatin1Char( ' ' ), bool <i>trunc</i> = false ) const</h3>
129
<p>Use <a href="qstring.html#rightJustified">rightJustified</a>() instead.</p>
130
<h3 class="fn"><a name="setAscii"></a>QString & QString::setAscii ( const char * <i>str</i>, int <i>len</i> = -1 )</h3>
131
<p>Use <a href="qstring.html#fromAscii">fromAscii</a>() instead.</p>
132
<h3 class="fn"><a name="setLatin1"></a>QString & QString::setLatin1 ( const char * <i>str</i>, int <i>len</i> = -1 )</h3>
133
<p>Use <a href="qstring.html#fromLatin1">fromLatin1</a>() instead.</p>
134
<h3 class="fn"><a name="setLength"></a>void QString::setLength ( int <i>nl</i> )</h3>
135
<p>Use <a href="qstring.html#resize">resize</a>() instead.</p>
136
<h3 class="fn"><a name="setUnicodeCodes"></a>QString & QString::setUnicodeCodes ( const <a href="qtglobal.html#ushort-typedef">ushort</a> * <i>unicode_as_ushorts</i>, int <i>size</i> )</h3>
137
<p>Use <a href="qstring.html#setUtf16">setUtf16</a>() instead.</p>
138
<h3 class="fn"><a name="simplifyWhiteSpace"></a>QString QString::simplifyWhiteSpace () const</h3>
139
<p>Use <a href="qstring.html#simplified">simplified</a>() instead.</p>
140
<h3 class="fn"><a name="startsWith-2"></a>bool QString::startsWith ( const QString & <i>s</i>, bool <i>cs</i> ) const</h3>
141
<p>This is an overloaded member function, provided for convenience. It behaves essentially like the above function.</p>
142
<p>Use the startsWith(<a href="qstring.html">QString</a>, <a href="qt.html#CaseSensitivity-enum">Qt::CaseSensitive</a>) overload instead.</p>
143
<h3 class="fn"><a name="stripWhiteSpace"></a>QString QString::stripWhiteSpace () const</h3>
144
<p>Use <a href="qstring.html#trimmed">trimmed</a>() instead.</p>
145
<h3 class="fn"><a name="ucs2"></a>const <a href="qtglobal.html#ushort-typedef">ushort</a> * QString::ucs2 () const</h3>
146
<p>Use <a href="qstring.html#utf16">utf16</a>() instead.</p>
147
<h3 class="fn"><a name="upper"></a>QString QString::upper () const</h3>
148
<p>Use <a href="qstring.html#toUpper">toUpper</a>() instead.</p>
149
<h3 class="fn"><a name="utf8"></a><a href="qbytearray.html">QByteArray</a> QString::utf8 () const</h3>
150
<p>Use <a href="qstring.html#toUtf8">toUtf8</a>() instead.</p>
151
<h3 class="fn"><a name="operator-const-char--2a"></a>QString::operator const char * () const</h3>
152
<p>Use <a href="qstring.html#toAscii">toAscii</a>().<a href="qstring.html#constData">constData</a>() instead.</p>
153
<p /><address><hr /><div align="center">
154
<table width="100%" cellspacing="0" border="0"><tr class="address">
155
<td width="30%">Copyright © 2005 <a href="trolltech.html">Trolltech</a></td>
156
<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>
157
<td width="30%" align="right"><div align="right">Qt 4.0.0</div></td>
158
</tr></table></div></address></body>