~oif-team/ubuntu/natty/qt4-x11/xi2.1

<td width="1">  </td><td class="postheader" valign="center"><a href="index.html">Home</a> · <a href="classes.html">All Classes</a> · <a href="mainclasses.html">Main Classes</a> · <a href="annotated.html">Annotated</a> · <a href="groups.html">Grouped Classes</a> · <a href="functions.html">Functions</a></td>

<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">Q3CString Class Reference</h1>

The Q3CString class provides an abstraction of the classic C zero-terminated char array (char *). <a href="#details">More...</a>

<pre>#include <Q3CString></pre>This class is part of the Qt 3 support library. It is provided to keep old source code working. We strongly advise against using it in new code. See the <a href="porting4.html">Porting Guide</a> for more information.

Part of the <a href="qt3support.html">Qt3Support</a> module.

Inherits <a href="qbytearray.html">QByteArray</a>.

Note: All the functions in this class are <a href="threads.html#reentrant">reentrant</a>.

<ul>

<li><a href="q3cstring-members.html">List of all members, including inherited members</a></li>

</ul>

<h3>Public Functions</h3>

<ul>

<li><div class="fn"/><a href="q3cstring.html#Q3CString">Q3CString</a> ()</li>

<li><div class="fn"/><a href="q3cstring.html#Q3CString-2">Q3CString</a> ( int size )</li>

<li><div class="fn"/><a href="q3cstring.html#Q3CString-3">Q3CString</a> ( const Q3CString & s )</li>

<li><div class="fn"/><a href="q3cstring.html#Q3CString-4">Q3CString</a> ( const QByteArray & ba )</li>

<li><div class="fn"/><a href="q3cstring.html#Q3CString-5">Q3CString</a> ( const char * str )</li>

<li><div class="fn"/><a href="q3cstring.html#Q3CString-6">Q3CString</a> ( const char * str, uint maxsize )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#append">append</a> ( const char * str )</li>

<li><div class="fn"/>Q3CString <a href="q3cstring.html#copy">copy</a> () const</li>

<li><div class="fn"/>Q3CString <a href="q3cstring.html#leftJustify">leftJustify</a> ( uint width, char fill = ' ', bool truncate = false ) const</li>

<li><div class="fn"/>Q3CString <a href="q3cstring.html#lower">lower</a> () const</li>

<li><div class="fn"/>Q3CString <a href="q3cstring.html#rightJustify">rightJustify</a> ( uint width, char fill = ' ', bool truncate = false ) const</li>

<li><div class="fn"/>bool <a href="q3cstring.html#setExpand">setExpand</a> ( uint index, char c )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setNum">setNum</a> ( double n, char f = 'g', int prec = 6 )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setNum-2">setNum</a> ( long n )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setNum-3">setNum</a> ( ulong n )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setNum-4">setNum</a> ( int n )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setNum-5">setNum</a> ( uint n )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setNum-6">setNum</a> ( short n )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setNum-7">setNum</a> ( ushort n )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setNum-8">setNum</a> ( float n, char f = 'g', int prec = 6 )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#setStr">setStr</a> ( const char * str )</li>

<li><div class="fn"/>Q3CString <a href="q3cstring.html#simplifyWhiteSpace">simplifyWhiteSpace</a> () const</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#sprintf">sprintf</a> ( const char * format, ... )</li>

<li><div class="fn"/>Q3CString <a href="q3cstring.html#stripWhiteSpace">stripWhiteSpace</a> () const</li>

<li><div class="fn"/>double <a href="q3cstring.html#toDouble">toDouble</a> ( bool * ok = 0 ) const</li>

<li><div class="fn"/>float <a href="q3cstring.html#toFloat">toFloat</a> ( bool * ok = 0 ) const</li>

<li><div class="fn"/>int <a href="q3cstring.html#toInt">toInt</a> ( bool * ok = 0 ) const</li>

<li><div class="fn"/>long <a href="q3cstring.html#toLong">toLong</a> ( bool * ok = 0 ) const</li>

<li><div class="fn"/>short <a href="q3cstring.html#toShort">toShort</a> ( bool * ok = 0 ) const</li>

<li><div class="fn"/>uint <a href="q3cstring.html#toUInt">toUInt</a> ( bool * ok = 0 ) const</li>

<li><div class="fn"/>ulong <a href="q3cstring.html#toULong">toULong</a> ( bool * ok = 0 ) const</li>

<li><div class="fn"/>ushort <a href="q3cstring.html#toUShort">toUShort</a> ( bool * ok = 0 ) const</li>

<li><div class="fn"/>Q3CString <a href="q3cstring.html#upper">upper</a> () const</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#operator-eq">operator=</a> ( const Q3CString & s )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#operator-eq-2">operator=</a> ( const QByteArray & ba )</li>

<li><div class="fn"/>Q3CString & <a href="q3cstring.html#operator-eq-3">operator=</a> ( const char * str )</li>

</ul>

<ul>

<li><div class="fn"/>112 public functions inherited from <a href="qbytearray.html#public-functions">QByteArray</a></li>

</ul>

<h3>Related Non-Members</h3>

<ul>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-not-eq-26">operator!=</a> ( const Q3CString & s1, const Q3CString & s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-not-eq-31">operator!=</a> ( const Q3CString & s1, const char * s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-not-eq-32">operator!=</a> ( const char * s1, const Q3CString & s2 )</li>

<li><div class="fn"/>const Q3CString <a href="q3cstring.html#operator-2b-13">operator+</a> ( const Q3CString & s1, const Q3CString & s2 )</li>

<li><div class="fn"/>const Q3CString <a href="q3cstring.html#operator-2b-24">operator+</a> ( const Q3CString & s1, const char * s2 )</li>

<li><div class="fn"/>const Q3CString <a href="q3cstring.html#operator-2b-25">operator+</a> ( const char * s1, const Q3CString & s2 )</li>

<li><div class="fn"/>const Q3CString <a href="q3cstring.html#operator-2b-26">operator+</a> ( const Q3CString & s, char c )</li>

<li><div class="fn"/>const Q3CString <a href="q3cstring.html#operator-2b-27">operator+</a> ( char c, const Q3CString & s )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-lt-7">operator<</a> ( const Q3CString & s1, const char * s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-lt-12">operator<</a> ( const char * s1, const Q3CString & s2 )</li>

<li><div class="fn"/>QDataStream & <a href="q3cstring.html#operator-lt-lt-85">operator<<</a> ( QDataStream & s, const Q3CString & str )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-lt-eq-7">operator<=</a> ( const Q3CString & s1, const char * s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-lt-eq-12">operator<=</a> ( const char * s1, const Q3CString & s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-eq-eq-36">operator==</a> ( const Q3CString & s1, const Q3CString & s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-eq-eq-41">operator==</a> ( const Q3CString & s1, const char * s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-eq-eq-42">operator==</a> ( const char * s1, const Q3CString & s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-gt-7">operator></a> ( const Q3CString & s1, const char * s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-gt-12">operator></a> ( const char * s1, const Q3CString & s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-gt-eq-7">operator>=</a> ( const Q3CString & s1, const char * s2 )</li>

<li><div class="fn"/>bool <a href="q3cstring.html#operator-gt-eq-12">operator>=</a> ( const char * s1, const Q3CString & s2 )</li>

<li><div class="fn"/>QDataStream & <a href="q3cstring.html#operator-gt-gt-57">operator>></a> ( QDataStream & s, Q3CString & str )</li>

</ul>

<h3>Additional Inherited Members</h3>

<ul>

<li><div class="fn"/>7 static public members inherited from <a href="qbytearray.html#static-public-members">QByteArray</a></li>

100

</ul>

101

102

<hr />

103

<h2>Detailed Description</h2>

104

The Q3CString class provides an abstraction of the classic C zero-terminated char array (char *).

105

Q3CString tries to behave like a more convenient <tt>const char *</tt>. The price of doing this is that some algorithms will perform badly. For example, <a href="q3cstring.html#append">append</a>() is O(<a href="qbytearray.html#length">length</a>()) since it scans for a null terminator. Although you might use Q3CString for text that is never exposed to the user, for most purposes, and especially for user-visible text, you should use <a href="qstring.html">QString</a>. <a href="qstring.html">QString</a> provides implicit sharing, Unicode and other internationalization support, and is well optimized.

106

Note that for the Q3CString methods that take a <tt>const char *</tt> parameter the <tt>const char *</tt> must either be 0 (null) or not-null and '\0' (NUL byte) terminated; otherwise the results are undefined.

107

A Q3CString that has not been assigned to anything is null, i.e. both the length and the data pointer is 0. A Q3CString that references the empty string ("", a single '\0' char) is empty. Both null and empty Q3CStrings are legal parameters to the methods. Assigning <tt>const char *</tt> 0 to Q3CString produces a null Q3CString.

108

The <a href="qbytearray.html#length">length</a>() function returns the length of the string; <a href="qbytearray.html#resize">resize</a>() resizes the string and <a href="qbytearray.html#truncate">truncate</a>() truncates the string. A string can be filled with a character using <a href="qbytearray.html#fill">fill</a>(). Strings can be left or right padded with characters using <a href="q3cstring.html#leftJustify">leftJustify</a>() and <a href="q3cstring.html#rightJustify">rightJustify</a>(). Characters, strings and regular expressions can be searched for using <a href="qbytearray-qt3.html#find">find</a>() and <a href="qbytearray-qt3.html#findRev">findRev</a>(), and counted using <a href="qbytearray.html#contains">contains</a>().

109

Strings and characters can be inserted with <a href="q3cstring.html#insert">insert</a>() and appended with <a href="q3cstring.html#append">append</a>(). A string can be prepended with <a href="q3cstring.html#prepend">prepend</a>(). Characters can be removed from the string with <a href="q3cstring.html#remove">remove</a>() and replaced with <a href="q3cstring.html#replace">replace</a>().

110

Portions of a string can be extracted using <a href="q3cstring.html#left">left</a>(), <a href="q3cstring.html#right">right</a>() and <a href="q3cstring.html#mid">mid</a>(). Whitespace can be removed using <a href="q3cstring.html#stripWhiteSpace">stripWhiteSpace</a>() and <a href="q3cstring.html#simplifyWhiteSpace">simplifyWhiteSpace</a>(). Strings can be converted to uppercase or lowercase with <a href="q3cstring.html#upper">upper</a>() and <a href="q3cstring.html#lower">lower</a>() respectively.

111

Strings that contain numbers can be converted to numbers with <a href="q3cstring.html#toShort">toShort</a>(), <a href="q3cstring.html#toInt">toInt</a>(), <a href="q3cstring.html#toLong">toLong</a>(), <a href="q3cstring.html#toULong">toULong</a>(), <a href="q3cstring.html#toFloat">toFloat</a>() and <a href="q3cstring.html#toDouble">toDouble</a>(). Numbers can be converted to strings with <a href="q3cstring.html#setNum">setNum</a>().

112

Many operators are overloaded to work with Q3CStrings. Q3CString also supports some more obscure functions, e.g. <a href="q3cstring.html#sprintf">sprintf</a>(), <a href="q3cstring.html#setStr">setStr</a>() and <a href="q3cstring.html#setExpand">setExpand</a>().

113

Note on Character Comparisons

114

In Q3CString the notion of uppercase and lowercase and of which character is greater than or less than another character is locale dependent. This affects functions which support a case insensitive option or which compare or lowercase or uppercase their arguments. Case insensitive operations and comparisons will be accurate if both strings contain only ASCII characters. (If <tt>$LC_CTYPE</tt> is set, most Unix systems do "the right thing".) Functions that this affects include <a href="qbytearray.html#contains">contains</a>(), <a href="qbytearray-qt3.html#find">find</a>(), <a href="qbytearray-qt3.html#findRev">findRev</a>(), <a href="qbytearray.html#operator-lt">operator<</a>(), <a href="qbytearray.html#operator-lt-eq">operator<=</a>(), <a href="qbytearray.html#operator-gt">operator></a>(), <a href="qbytearray.html#operator-gt-eq">operator>=</a>(), <a href="q3cstring.html#lower">lower</a>() and <a href="q3cstring.html#upper">upper</a>().

115

This issue does not apply to <a href="qstring.html">QString</a>s since they represent characters using Unicode.

116

Performance note: The Q3CString methods for <a href="qregexp.html">QRegExp</a> searching are implemented by converting the Q3CString to a <a href="qstring.html">QString</a> and performing the search on that. This implies a deep copy of the Q3CString data. If you are going to perform many <a href="qregexp.html">QRegExp</a> searches on a large Q3CString, you will get better performance by converting the Q3CString to a <a href="qstring.html">QString</a> yourself, and then searching in the <a href="qstring.html">QString</a>.

117

<hr />

118

<h2>Member Function Documentation</h2>

119

<h3 class="fn"><a name="Q3CString"></a>Q3CString::Q3CString ()</h3>

120

Constructs a null string.

121

See also <a href="qbytearray.html#isNull">isNull</a>().

122

<h3 class="fn"><a name="Q3CString-2"></a>Q3CString::Q3CString ( int size )</h3>

123

Constructs a string with room for size characters, including the '\0'-terminator. Makes a null string if size == 0.

124

If size > 0, then the first and last characters in the string are initialized to '\0'. All other characters are uninitialized.

125

See also <a href="qbytearray.html#resize">resize</a>() and <a href="qbytearray.html#isNull">isNull</a>().

126

<h3 class="fn"><a name="Q3CString-3"></a>Q3CString::Q3CString ( const Q3CString & s )</h3>

127

Constructs a shallow copy s.

128

<h3 class="fn"><a name="Q3CString-4"></a>Q3CString::Q3CString ( const <a href="qbytearray.html">QByteArray</a> & ba )</h3>

129

Constructs a copy of ba.

130

<h3 class="fn"><a name="Q3CString-5"></a>Q3CString::Q3CString ( const char * str )</h3>

131

Constructs a string that is a deep copy of str.

132

If str is 0 a null string is created.

133

See also <a href="qbytearray.html#isNull">isNull</a>().

134

<h3 class="fn"><a name="Q3CString-6"></a>Q3CString::Q3CString ( const char * str, <a href="qtglobal.html#uint-typedef">uint</a> maxsize )</h3>

135

Constructs a string that is a deep copy of str. The copy will be at most maxsize bytes long including the '\0'-terminator.

136

Example:

137

<pre>  Q3CString str("helloworld", 6); // assigns "hello" to str</pre>

138

If str contains a 0 byte within the first maxsize bytes, the resulting <a href="q3cstring.html">Q3CString</a> will be terminated by this 0. If str is 0 a null string is created.

139

See also <a href="qbytearray.html#isNull">isNull</a>().

140

<h3 class="fn"><a name="append"></a>Q3CString & Q3CString::append ( const char * str )</h3>

141

Appends string str to the string and returns a reference to the string. Equivalent to operator+=().

142

<h3 class="fn"><a name="copy"></a>Q3CString Q3CString::copy () const</h3>

143

Returns a deep copy of this string.

144

See also <a href="qbytearray.html#detach">detach</a>().

145

<h3 class="fn"><a name="leftJustify"></a>Q3CString Q3CString::leftJustify ( <a href="qtglobal.html#uint-typedef">uint</a> width, char fill = ' ', bool truncate = false ) const</h3>

146

Returns a string of length width (plus one for the terminating '\0') that contains this string padded with the fill character.

147

If the length of the string exceeds width and truncate is false (the default), then the returned string is a copy of the string. If the length of the string exceeds width and truncate is true, then the returned string is a left(width).

148

Example:

149

<pre>  Q3CString s("apple");

150

Q3CString t = s.leftJustify(8, '.'); // t == "apple..."</pre>

151

See also <a href="q3cstring.html#rightJustify">rightJustify</a>().

152

<h3 class="fn"><a name="lower"></a>Q3CString Q3CString::lower () const</h3>

153

Use <a href="qbytearray.html#toLower">QByteArray::toLower</a>() instead.

154

<h3 class="fn"><a name="rightJustify"></a>Q3CString Q3CString::rightJustify ( <a href="qtglobal.html#uint-typedef">uint</a> width, char fill = ' ', bool truncate = false ) const</h3>

155

Returns a string of length width (plus one for the terminating '\0') that contains zero or more of the fill character followed by this string.

156

157

Example:

158

<pre>  Q3CString s("pie");

159

Q3CString t = s.rightJustify(8, '.'); // t == ".....pie"</pre>

160

See also <a href="q3cstring.html#leftJustify">leftJustify</a>().

161

<h3 class="fn"><a name="setExpand"></a>bool Q3CString::setExpand ( <a href="qtglobal.html#uint-typedef">uint</a> index, char c )</h3>

162

Sets the character at position index to c and expands the string if necessary, padding with spaces.

163

Returns false if index was out of range and the string could not be expanded; otherwise returns true.

164

<h3 class="fn"><a name="setNum"></a>Q3CString & Q3CString::setNum ( double n, char f = 'g', int prec = 6 )</h3>

165

Sets the string to the string representation of the number n and returns a reference to the string.

166

The format of the string representation is specified by the format character f, and the precision (number of digits after the decimal point) is specified with prec.

167

The valid formats for f are 'e', 'E', 'f', 'g' and 'G'. The formats are the same as for <a href="q3cstring.html#sprintf">sprintf</a>(); they are explained in <a href="qstring.html#arg">QString::arg</a>().

168

<h3 class="fn"><a name="setNum-2"></a>Q3CString & Q3CString::setNum ( long n )</h3>

169

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

170

Sets the string to the string representation of the number n and returns a reference to the string.

171

<h3 class="fn"><a name="setNum-3"></a>Q3CString & Q3CString::setNum ( <a href="qtglobal.html#ulong-typedef">ulong</a> n )</h3>

172

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

173

Sets the string to the string representation of the number n and returns a reference to the string.

174

<h3 class="fn"><a name="setNum-4"></a>Q3CString & Q3CString::setNum ( int n )</h3>

175

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

176

Sets the string to the string representation of the number n and returns a reference to the string.

177

<h3 class="fn"><a name="setNum-5"></a>Q3CString & Q3CString::setNum ( <a href="qtglobal.html#uint-typedef">uint</a> n )</h3>

178

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

179

Sets the string to the string representation of the number n and returns a reference to the string.

180

<h3 class="fn"><a name="setNum-6"></a>Q3CString & Q3CString::setNum ( short n )</h3>

181

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

182

Sets the string to the string representation of the number n and returns a reference to the string.

183

<h3 class="fn"><a name="setNum-7"></a>Q3CString & Q3CString::setNum ( <a href="qtglobal.html#ushort-typedef">ushort</a> n )</h3>

184

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

185

Sets the string to the string representation of the number n and returns a reference to the string.

186

<h3 class="fn"><a name="setNum-8"></a>Q3CString & Q3CString::setNum ( float n, char f = 'g', int prec = 6 )</h3>

187

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

188

<h3 class="fn"><a name="setStr"></a>Q3CString & Q3CString::setStr ( const char * str )</h3>

189

Makes a deep copy of str. Returns a reference to the string.

190

<h3 class="fn"><a name="simplifyWhiteSpace"></a>Q3CString Q3CString::simplifyWhiteSpace () const</h3>

191

Use <a href="qbytearray.html#simplified">QByteArray::simplified</a>() instead.

192

<h3 class="fn"><a name="sprintf"></a>Q3CString & Q3CString::sprintf ( const char * format, ... )</h3>

193

Implemented as a call to the native vsprintf() (see the manual for your C library).

194

If the string is shorter than 256 characters, this sprintf() calls resize(256) to decrease the chance of memory corruption. The string is resized back to its actual length before sprintf() returns.

195

Example:

196

<pre>  Q3CString s;

197

s.sprintf("%d - %s", 1, "first"); // result < 256 chars

198

199

Q3CString big(25000); // very long string

200

big.sprintf("%d - %s", 2, longString); // result < 25000 chars</pre>

201

Warning: All vsprintf() implementations will write past the end of the target string (*this) if the format specification and arguments happen to be longer than the target string, and some will also fail if the target string is longer than some arbitrary implementation limit.

202

Giving user-supplied arguments to sprintf() is risky: Sooner or later someone will paste a huge line into your application.

203

<h3 class="fn"><a name="stripWhiteSpace"></a>Q3CString Q3CString::stripWhiteSpace () const</h3>

204

Use <a href="qbytearray.html#trimmed">QByteArray::trimmed</a>() instead.

205

<h3 class="fn"><a name="toDouble"></a>double Q3CString::toDouble ( bool * ok = 0 ) const</h3>

206

Returns the string converted to a <tt>double</tt> value.

207

If ok is not 0: *ok is set to false if the string is not a number, or if it has trailing garbage; otherwise *ok is set to true.

208

<h3 class="fn"><a name="toFloat"></a>float Q3CString::toFloat ( bool * ok = 0 ) const</h3>

209

Returns the string converted to a <tt>float</tt> value.

210

If ok is not 0: *ok is set to false if the string is not a number, or if it has trailing garbage; otherwise *ok is set to true.

211

<h3 class="fn"><a name="toInt"></a>int Q3CString::toInt ( bool * ok = 0 ) const</h3>

212

Returns the string converted to a <tt>int</tt> value.

213

If ok is not 0: *ok is set to false if the string is not a number, or if it has trailing garbage; otherwise *ok is set to true.

214

<h3 class="fn"><a name="toLong"></a>long Q3CString::toLong ( bool * ok = 0 ) const</h3>

215

Returns the string converted to a <tt>long</tt> value.

216

If ok is not 0: *ok is set to false if the string is not a number, or if it has trailing garbage; otherwise *ok is set to true.

217

<h3 class="fn"><a name="toShort"></a>short Q3CString::toShort ( bool * ok = 0 ) const</h3>

218

Returns the string converted to a <tt>short</tt> value.

219

If ok is not 0: *ok is set to false if the string is not a number, is out of range, or if it has trailing garbage; otherwise *ok is set to true.

220

<h3 class="fn"><a name="toUInt"></a><a href="qtglobal.html#uint-typedef">uint</a> Q3CString::toUInt ( bool * ok = 0 ) const</h3>

221

Returns the string converted to an <tt>unsigned int</tt> value.

222

If ok is not 0: *ok is set to false if the string is not a number, or if it has trailing garbage; otherwise *ok is set to true.

223

<h3 class="fn"><a name="toULong"></a><a href="qtglobal.html#ulong-typedef">ulong</a> Q3CString::toULong ( bool * ok = 0 ) const</h3>

224

Returns the string converted to an <tt>unsigned long</tt> value.

225

If ok is not 0: *ok is set to false if the string is not a number, or if it has trailing garbage; otherwise *ok is set to true.

226

<h3 class="fn"><a name="toUShort"></a><a href="qtglobal.html#ushort-typedef">ushort</a> Q3CString::toUShort ( bool * ok = 0 ) const</h3>

227

Returns the string converted to an <tt>unsigned short</tt> value.

228

If ok is not 0: *ok is set to false if the string is not a number, is out of range, or if it has trailing garbage; otherwise *ok is set to true.

229

<h3 class="fn"><a name="upper"></a>Q3CString Q3CString::upper () const</h3>

230

Use <a href="qbytearray.html#toUpper">QByteArray::toUpper</a>() instead.

231

<h3 class="fn"><a name="operator-eq"></a>Q3CString & Q3CString::operator= ( const Q3CString & s )</h3>

232

Assigns a shallow copy of s to this string and returns a reference to this string.

233

<h3 class="fn"><a name="operator-eq-2"></a>Q3CString & Q3CString::operator= ( const <a href="qbytearray.html">QByteArray</a> & ba )</h3>

234

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

235

Assigns byte array ba to this <a href="q3cstring.html">Q3CString</a>.

236

<h3 class="fn"><a name="operator-eq-3"></a>Q3CString & Q3CString::operator= ( const char * str )</h3>

237

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

238

Assigns a deep copy of str to this string and returns a reference to this string.

239

If str is 0 a null string is created.

240

See also <a href="qbytearray.html#isNull">isNull</a>().

241

<hr />

242

<h2>Related Non-Members</h2>

243

<h3 class="fn"><a name="operator-not-eq-26"></a>bool operator!= ( const Q3CString & s1, const Q3CString & s2 )</h3>

244

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

245

Returns true if s1 and s2 are different; otherwise returns false.

246

Equivalent to qstrcmp(s1, s2) != 0.

247

<h3 class="fn"><a name="operator-not-eq-31"></a>bool operator!= ( const Q3CString & s1, const char * s2 )</h3>

248

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

249

Returns true if s1 and s2 are different; otherwise returns false.

250

Equivalent to qstrcmp(s1, s2) != 0.

251

<h3 class="fn"><a name="operator-not-eq-32"></a>bool operator!= ( const char * s1, const Q3CString & s2 )</h3>

252

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

253

Returns true if s1 and s2 are different; otherwise returns false.

254

Equivalent to qstrcmp(s1, s2) != 0.

255

<h3 class="fn"><a name="operator-2b-13"></a>const Q3CString operator+ ( const Q3CString & s1, const Q3CString & s2 )</h3>

256

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

257

Returns a string which consists of the concatenation of s1 and s2.

258

<h3 class="fn"><a name="operator-2b-24"></a>const Q3CString operator+ ( const Q3CString & s1, const char * s2 )</h3>

259

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

260

Returns a string which consists of the concatenation of s1 and s2.

261

<h3 class="fn"><a name="operator-2b-25"></a>const Q3CString operator+ ( const char * s1, const Q3CString & s2 )</h3>

262

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

263

Returns a string which consists of the concatenation of s1 and s2.

264

<h3 class="fn"><a name="operator-2b-26"></a>const Q3CString operator+ ( const Q3CString & s, char c )</h3>

265

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

266

Returns a string which consists of the concatenation of s and c.

267

<h3 class="fn"><a name="operator-2b-27"></a>const Q3CString operator+ ( char c, const Q3CString & s )</h3>

268

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

269

Returns a string which consists of the concatenation of c and s.

270

<h3 class="fn"><a name="operator-lt-7"></a>bool operator< ( const Q3CString & s1, const char * s2 )</h3>

271

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

272

Returns true if s1 is less than s2; otherwise returns false.

273

Equivalent to qstrcmp(s1, s2) < 0.

274

<h3 class="fn"><a name="operator-lt-12"></a>bool operator< ( const char * s1, const Q3CString & s2 )</h3>

275

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

276

Returns true if s1 is less than s2; otherwise returns false.

277

Equivalent to qstrcmp(s1, s2) < 0.

278

<h3 class="fn"><a name="operator-lt-lt-85"></a><a href="qdatastream.html">QDataStream</a> & operator<< ( <a href="qdatastream.html">QDataStream</a> & s, const Q3CString & str )</h3>

279

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

280

Writes string str to the stream s.

281

See also <a href="datastreamformat.html">Format of the QDataStream operators</a>.

282

<h3 class="fn"><a name="operator-lt-eq-7"></a>bool operator<= ( const Q3CString & s1, const char * s2 )</h3>

283

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

284

Returns true if s1 is less than or equal to s2; otherwise returns false.

285

Equivalent to qstrcmp(s1, s2) <= 0.

286

<h3 class="fn"><a name="operator-lt-eq-12"></a>bool operator<= ( const char * s1, const Q3CString & s2 )</h3>

287

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

288

Returns true if s1 is less than or equal to s2; otherwise returns false.

289

Equivalent to qstrcmp(s1, s2) <= 0.

290

<h3 class="fn"><a name="operator-eq-eq-36"></a>bool operator== ( const Q3CString & s1, const Q3CString & s2 )</h3>

291

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

292

Returns true if s1 and s2 are equal; otherwise returns false.

293

Equivalent to qstrcmp(s1, s2) == 0.

294

<h3 class="fn"><a name="operator-eq-eq-41"></a>bool operator== ( const Q3CString & s1, const char * s2 )</h3>

295

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

296

Returns true if s1 and s2 are equal; otherwise returns false.

297

Equivalent to qstrcmp(s1, s2) == 0.

298

<h3 class="fn"><a name="operator-eq-eq-42"></a>bool operator== ( const char * s1, const Q3CString & s2 )</h3>

299

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

300

Returns true if s1 and s2 are equal; otherwise returns false.

301

Equivalent to qstrcmp(s1, s2) == 0.

302

<h3 class="fn"><a name="operator-gt-7"></a>bool operator> ( const Q3CString & s1, const char * s2 )</h3>

303

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

304

Returns true if s1 is greater than s2; otherwise returns false.

305

Equivalent to qstrcmp(s1, s2) > 0.

306

<h3 class="fn"><a name="operator-gt-12"></a>bool operator> ( const char * s1, const Q3CString & s2 )</h3>

307

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

308

Returns true if s1 is greater than s2; otherwise returns false.

309

Equivalent to qstrcmp(s1, s2) > 0.

310

<h3 class="fn"><a name="operator-gt-eq-7"></a>bool operator>= ( const Q3CString & s1, const char * s2 )</h3>

311

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

312

Returns true if s1 is greater than or equal to s2; otherwise returns false.

313

Equivalent to qstrcmp(s1, s2) >= 0.

314

<h3 class="fn"><a name="operator-gt-eq-12"></a>bool operator>= ( const char * s1, const Q3CString & s2 )</h3>

315

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

316

Returns true if s1 is greater than or equal to s2; otherwise returns false.

317

Equivalent to qstrcmp(s1, s2) >= 0.

318

<h3 class="fn"><a name="operator-gt-gt-57"></a><a href="qdatastream.html">QDataStream</a> & operator>> ( <a href="qdatastream.html">QDataStream</a> & s, Q3CString & str )</h3>

319

This is an overloaded member function, provided for convenience. It behaves essentially like the above function.

320

Reads a string into str from the stream s.

321

See also <a href="datastreamformat.html">Format of the QDataStream operators</a>.

322

323

324

325

<td width="40%" align="center"><a href="trademarks.html">Trademarks</a></td>

326

327

</tr></table></div></address></body>

328

</html>

Older »