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

doc/html/qbytearray.html

<!DOCTYPE html

PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "DTD/xhtml1-strict.dtd">

<head>

<title>Qt 4.5: QByteArray Class Reference</title>

<title>Qt 4.6: QByteArray Class Reference</title>

</head>

<body>

<tr>

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

<td align="right" valign="top" width="230"></td></tr></table><h1 class="title">QByteArray Class Reference [<a href="qtcore.html">QtCore</a> module]

<td width="1">  </td><td class="postheader" valign="center"><a href="index.html">Home</a> · <a href="classes.html">All Classes</a> · <a href="functions.html">All Functions</a> · <a href="overviews.html">Overviews</a></td><td class="searchBar" align="right" valign="center"><form action="http://www.google.com/cse" id="cse-search-box"><div><input type="hidden" name="cx" value="000136343326384750312:dhbxnqlakyu" /><input type="hidden" name="ie" value="UTF-8" /><input type="text" name="q" size="31" /><input type="submit" name="sa" value="Search" /></div></form></td>

</tr></table><h1 class="title">QByteArray Class Reference [<a href="qtcore.html">QtCore</a> module]

</h1>

The QByteArray class provides an array of bytes. <a href="#details">More...</a>

<pre> #include <QByteArray></pre>Inherited by <a href="q3cstring.html" class="compat">Q3CString</a>.

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

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

<ul>

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

<li><a href="qbytearray-qt3.html">Qt 3 support members</a></li>

</ul>

<hr />

<h3>Public Functions</h3>

<ul>

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

<li><div class="fn"></div><a href="qbytearray.html#QByteArray-2">QByteArray</a> ( const char * str )</li>

<li><div class="fn"></div><a href="qbytearray.html#QByteArray-3">QByteArray</a> ( const char * data, int size )</li>

<li><div class="fn"></div><a href="qbytearray.html#QByteArray-4">QByteArray</a> ( int size, char ch )</li>

<li><div class="fn"></div><a href="qbytearray.html#QByteArray-5">QByteArray</a> ( const QByteArray & other )</li>

<li><div class="fn"></div><a href="qbytearray.html#dtor.QByteArray">~QByteArray</a> ()</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#append">append</a> ( const QByteArray & ba )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#append-2">append</a> ( const QString & str )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#append-3">append</a> ( const char * str )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#append-4">append</a> ( const char * str, int len )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#append-5">append</a> ( char ch )</li>

<li><div class="fn"></div>char <a href="qbytearray.html#at">at</a> ( int i ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#capacity">capacity</a> () const</li>

<li><div class="fn"></div>void <a href="qbytearray.html#clear">clear</a> ()</li>

<li><div class="fn"></div>const char * <a href="qbytearray.html#constData">constData</a> () const</li>

<li><div class="fn"></div>bool <a href="qbytearray.html#contains">contains</a> ( const QByteArray & ba ) const</li>

<li><div class="fn"></div>bool <a href="qbytearray.html#contains-2">contains</a> ( const char * str ) const</li>

<li><div class="fn"></div>bool <a href="qbytearray.html#contains-3">contains</a> ( char ch ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#count">count</a> ( const QByteArray & ba ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#count-2">count</a> ( const char * str ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#count-3">count</a> ( char ch ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#count-4">count</a> () const</li>

<li><div class="fn"></div>const char * <a href="qbytearray.html#data-2">data</a> () const</li>

<li><div class="fn"></div>bool <a href="qbytearray.html#endsWith">endsWith</a> ( const QByteArray & ba ) const</li>

<li><div class="fn"></div>bool <a href="qbytearray.html#endsWith-2">endsWith</a> ( const char * str ) const</li>

<li><div class="fn"></div>bool <a href="qbytearray.html#endsWith-3">endsWith</a> ( char ch ) const</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#fill">fill</a> ( char ch, int size = -1 )</li>

<li><div class="fn"></div>int <a href="qbytearray.html#indexOf">indexOf</a> ( const QByteArray & ba, int from = 0 ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#indexOf-2">indexOf</a> ( const QString & str, int from = 0 ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#indexOf-3">indexOf</a> ( const char * str, int from = 0 ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#indexOf-4">indexOf</a> ( char ch, int from = 0 ) const</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#insert">insert</a> ( int i, const QByteArray & ba )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#insert-2">insert</a> ( int i, const QString & str )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#insert-3">insert</a> ( int i, const char * str )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#insert-4">insert</a> ( int i, char ch )</li>

<li><div class="fn"></div>bool <a href="qbytearray.html#isEmpty">isEmpty</a> () const</li>

<li><div class="fn"></div>bool <a href="qbytearray.html#isNull">isNull</a> () const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#lastIndexOf">lastIndexOf</a> ( const QByteArray & ba, int from = -1 ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#lastIndexOf-2">lastIndexOf</a> ( const QString & str, int from = -1 ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#lastIndexOf-3">lastIndexOf</a> ( const char * str, int from = -1 ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#lastIndexOf-4">lastIndexOf</a> ( char ch, int from = -1 ) const</li>

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#left">left</a> ( int len ) const</li>

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#leftJustified">leftJustified</a> ( int width, char fill = ' ', bool truncate = false ) const</li>

<li><div class="fn"></div>int <a href="qbytearray.html#length">length</a> () const</li>

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#mid">mid</a> ( int pos, int len = -1 ) const</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#prepend">prepend</a> ( const QByteArray & ba )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#prepend-2">prepend</a> ( const char * str )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#prepend-3">prepend</a> ( char ch )</li>

<li><div class="fn"></div>void <a href="qbytearray.html#push_back">push_back</a> ( const QByteArray & other )</li>

<li><div class="fn"></div>void <a href="qbytearray.html#push_back-2">push_back</a> ( const char * str )</li>

<li><div class="fn"></div>void <a href="qbytearray.html#push_front">push_front</a> ( const QByteArray & other )</li>

<li><div class="fn"></div>void <a href="qbytearray.html#push_front-2">push_front</a> ( const char * str )</li>

<li><div class="fn"></div>void <a href="qbytearray.html#push_front-3">push_front</a> ( char ch )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#remove">remove</a> ( int pos, int len )</li>

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#repeated">repeated</a> ( int times ) const</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace">replace</a> ( int pos, int len, const QByteArray & after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-2">replace</a> ( int pos, int len, const char * after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-3">replace</a> ( const QByteArray & before, const QByteArray & after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-4">replace</a> ( const char * before, const QByteArray & after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-5">replace</a> ( const char * before, int bsize, const char * after, int asize )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-6">replace</a> ( const QByteArray & before, const char * after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-7">replace</a> ( const QString & before, const QByteArray & after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-8">replace</a> ( const QString & before, const char * after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-9">replace</a> ( const char * before, const char * after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-10">replace</a> ( char before, const QByteArray & after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-11">replace</a> ( char before, const QString & after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-12">replace</a> ( char before, const char * after )</li>

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#replace-13">replace</a> ( char before, char after )</li>

<li><div class="fn"></div>void <a href="qbytearray.html#reserve">reserve</a> ( int size )</li>

<li><div class="fn"></div>void <a href="qbytearray.html#resize">resize</a> ( int size )</li>

100

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#right">right</a> ( int len ) const</li>

101

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#rightJustified">rightJustified</a> ( int width, char fill = ' ', bool truncate = false ) const</li>

102

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#setNum">setNum</a> ( int n, int base = 10 )</li>

103

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#setNum-2">setNum</a> ( uint n, int base = 10 )</li>

104

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#setNum-3">setNum</a> ( short n, int base = 10 )</li>

105

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#setNum-4">setNum</a> ( ushort n, int base = 10 )</li>

106

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#setNum-5">setNum</a> ( qlonglong n, int base = 10 )</li>

107

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#setNum-6">setNum</a> ( qulonglong n, int base = 10 )</li>

108

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

109

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

110

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#simplified">simplified</a> () const</li>

111

<li><div class="fn"></div>int <a href="qbytearray.html#size">size</a> () const</li>

112

<li><div class="fn"></div>QList<QByteArray> <a href="qbytearray.html#split">split</a> ( char sep ) const</li>

113

<li><div class="fn"></div>void <a href="qbytearray.html#squeeze">squeeze</a> ()</li>

114

<li><div class="fn"></div>bool <a href="qbytearray.html#startsWith">startsWith</a> ( const QByteArray & ba ) const</li>

115

<li><div class="fn"></div>bool <a href="qbytearray.html#startsWith-2">startsWith</a> ( const char * str ) const</li>

116

<li><div class="fn"></div>bool <a href="qbytearray.html#startsWith-3">startsWith</a> ( char ch ) const</li>

117

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#toBase64">toBase64</a> () const</li>

118

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

119

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

120

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#toHex">toHex</a> () const</li>

121

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

122

<li><div class="fn"></div>long <a href="qbytearray.html#toLong">toLong</a> ( bool * ok = 0, int base = 10 ) const</li>

123

<li><div class="fn"></div>qlonglong <a href="qbytearray.html#toLongLong">toLongLong</a> ( bool * ok = 0, int base = 10 ) const</li>

124

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#toLower">toLower</a> () const</li>

125

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#toPercentEncoding">toPercentEncoding</a> ( const QByteArray & exclude = QByteArray(), const QByteArray & include = QByteArray(), char percent = '%' ) const</li>

126

<li><div class="fn"></div>short <a href="qbytearray.html#toShort">toShort</a> ( bool * ok = 0, int base = 10 ) const</li>

127

<li><div class="fn"></div>uint <a href="qbytearray.html#toUInt">toUInt</a> ( bool * ok = 0, int base = 10 ) const</li>

128

<li><div class="fn"></div>ulong <a href="qbytearray.html#toULong">toULong</a> ( bool * ok = 0, int base = 10 ) const</li>

129

<li><div class="fn"></div>qulonglong <a href="qbytearray.html#toULongLong">toULongLong</a> ( bool * ok = 0, int base = 10 ) const</li>

130

<li><div class="fn"></div>ushort <a href="qbytearray.html#toUShort">toUShort</a> ( bool * ok = 0, int base = 10 ) const</li>

131

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#toUpper">toUpper</a> () const</li>

132

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#trimmed">trimmed</a> () const</li>

133

<li><div class="fn"></div>void <a href="qbytearray.html#truncate">truncate</a> ( int pos )</li>

134

<li><div class="fn"></div><a href="qbytearray.html#operator-const-char--2a">operator const char *</a> () const</li>

135

<li><div class="fn"></div><a href="qbytearray.html#operator-const-void--2a">operator const void *</a> () const</li>

136

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-not-eq">operator!=</a> ( const QString & str ) const</li>

137

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

138

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#operator-2b-eq-2">operator+=</a> ( const QString & str )</li>

139

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#operator-2b-eq-3">operator+=</a> ( const char * str )</li>

140

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#operator-2b-eq-4">operator+=</a> ( char ch )</li>

141

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-lt">operator<</a> ( const QString & str ) const</li>

142

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-lt-eq">operator<=</a> ( const QString & str ) const</li>

143

<li><div class="fn"></div>QByteArray & <a href="qbytearray.html#operator-eq">operator=</a> ( const QByteArray & other )</li>

144

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

145

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-eq-eq">operator==</a> ( const QString & str ) const</li>

146

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-gt">operator></a> ( const QString & str ) const</li>

147

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-gt-eq">operator>=</a> ( const QString & str ) const</li>

148

<li><div class="fn"></div>QByteRef <a href="qbytearray.html#operator-5b-5d">operator[]</a> ( int i )</li>

149

<li><div class="fn"></div>char <a href="qbytearray.html#operator-5b-5d-2">operator[]</a> ( int i ) const</li>

150

<li><div class="fn"></div>QByteRef <a href="qbytearray.html#operator-5b-5d-3">operator[]</a> ( uint i )</li>

151

<li><div class="fn"></div>char <a href="qbytearray.html#operator-5b-5d-4">operator[]</a> ( uint i ) const</li>

152

</ul>

<h2>Public Functions</h2>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#QByteArray">QByteArray</a> ()</td></tr>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#QByteArray-2">QByteArray</a> ( const char * str )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#QByteArray-3">QByteArray</a> ( const char * data, int size )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#QByteArray-4">QByteArray</a> ( int size, char ch )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#QByteArray-6">QByteArray</a> ( const QByteArray & other )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#dtor.QByteArray">~QByteArray</a> ()</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#append">append</a> ( const QByteArray & ba )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#append-2">append</a> ( const QString & str )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#append-3">append</a> ( const char * str )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#append-4">append</a> ( const char * str, int len )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#append-5">append</a> ( char ch )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">char </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#at">at</a> ( int i ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#capacity">capacity</a> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#clear">clear</a> ()</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#constData">constData</a> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#contains">contains</a> ( const QByteArray & ba ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#contains-2">contains</a> ( const char * str ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#contains-3">contains</a> ( char ch ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#count">count</a> ( const QByteArray & ba ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#count-2">count</a> ( const char * str ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#count-3">count</a> ( char ch ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#count-4">count</a> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#data-2">data</a> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#endsWith">endsWith</a> ( const QByteArray & ba ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#endsWith-2">endsWith</a> ( const char * str ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#endsWith-3">endsWith</a> ( char ch ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#fill">fill</a> ( char ch, int size = -1 )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#indexOf">indexOf</a> ( const QByteArray & ba, int from = 0 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#indexOf-2">indexOf</a> ( const QString & str, int from = 0 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#indexOf-3">indexOf</a> ( const char * str, int from = 0 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#indexOf-4">indexOf</a> ( char ch, int from = 0 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#insert">insert</a> ( int i, const QByteArray & ba )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#insert-2">insert</a> ( int i, const QString & str )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#insert-3">insert</a> ( int i, const char * str )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#insert-4">insert</a> ( int i, const char * str, int len )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#insert-5">insert</a> ( int i, char ch )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#isEmpty">isEmpty</a> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#isNull">isNull</a> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#lastIndexOf">lastIndexOf</a> ( const QByteArray & ba, int from = -1 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#lastIndexOf-2">lastIndexOf</a> ( const QString & str, int from = -1 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#lastIndexOf-3">lastIndexOf</a> ( const char * str, int from = -1 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#lastIndexOf-4">lastIndexOf</a> ( char ch, int from = -1 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#left">left</a> ( int len ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#leftJustified">leftJustified</a> ( int width, char fill = ' ', bool truncate = false ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#length">length</a> () const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#mid">mid</a> ( int pos, int len = -1 ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#prepend">prepend</a> ( const QByteArray & ba )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#prepend-2">prepend</a> ( const char * str )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#prepend-3">prepend</a> ( const char * str, int len )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#prepend-4">prepend</a> ( char ch )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#push_back">push_back</a> ( const QByteArray & other )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#push_back-2">push_back</a> ( const char * str )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#push_front">push_front</a> ( const QByteArray & other )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#push_front-2">push_front</a> ( const char * str )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#push_front-3">push_front</a> ( char ch )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#remove">remove</a> ( int pos, int len )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#repeated">repeated</a> ( int times ) const</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace">replace</a> ( int pos, int len, const QByteArray & after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-2">replace</a> ( int pos, int len, const char * after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-3">replace</a> ( const QByteArray & before, const QByteArray & after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-4">replace</a> ( const char * before, const QByteArray & after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-5">replace</a> ( const char * before, int bsize, const char * after, int asize )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-6">replace</a> ( const QByteArray & before, const char * after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-7">replace</a> ( const QString & before, const QByteArray & after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-8">replace</a> ( const QString & before, const char * after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-9">replace</a> ( const char * before, const char * after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-10">replace</a> ( char before, const QByteArray & after )</td></tr>

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-11">replace</a> ( char before, const QString & after )</td></tr>

100

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-12">replace</a> ( char before, const char * after )</td></tr>

101

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#replace-13">replace</a> ( char before, char after )</td></tr>

102

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#reserve">reserve</a> ( int size )</td></tr>

103

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#resize">resize</a> ( int size )</td></tr>

104

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#right">right</a> ( int len ) const</td></tr>

105

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#rightJustified">rightJustified</a> ( int width, char fill = ' ', bool truncate = false ) const</td></tr>

106

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#setNum">setNum</a> ( int n, int base = 10 )</td></tr>

107

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#setNum-2">setNum</a> ( uint n, int base = 10 )</td></tr>

108

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#setNum-3">setNum</a> ( short n, int base = 10 )</td></tr>

109

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#setNum-4">setNum</a> ( ushort n, int base = 10 )</td></tr>

110

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#setNum-5">setNum</a> ( qlonglong n, int base = 10 )</td></tr>

111

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#setNum-6">setNum</a> ( qulonglong n, int base = 10 )</td></tr>

112

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#setNum-7">setNum</a> ( double n, char f = 'g', int prec = 6 )</td></tr>

113

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#setNum-8">setNum</a> ( float n, char f = 'g', int prec = 6 )</td></tr>

114

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#simplified">simplified</a> () const</td></tr>

115

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#size">size</a> () const</td></tr>

116

<tr><td class="memItemLeft" align="right" valign="top">QList<QByteArray> </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#split">split</a> ( char sep ) const</td></tr>

117

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#squeeze">squeeze</a> ()</td></tr>

118

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#startsWith">startsWith</a> ( const QByteArray & ba ) const</td></tr>

119

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#startsWith-2">startsWith</a> ( const char * str ) const</td></tr>

120

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#startsWith-3">startsWith</a> ( char ch ) const</td></tr>

121

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toBase64">toBase64</a> () const</td></tr>

122

<tr><td class="memItemLeft" align="right" valign="top">double </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toDouble">toDouble</a> ( bool * ok = 0 ) const</td></tr>

123

<tr><td class="memItemLeft" align="right" valign="top">float </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toFloat">toFloat</a> ( bool * ok = 0 ) const</td></tr>

124

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toHex">toHex</a> () const</td></tr>

125

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toInt">toInt</a> ( bool * ok = 0, int base = 10 ) const</td></tr>

126

<tr><td class="memItemLeft" align="right" valign="top">long </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toLong">toLong</a> ( bool * ok = 0, int base = 10 ) const</td></tr>

127

<tr><td class="memItemLeft" align="right" valign="top">qlonglong </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toLongLong">toLongLong</a> ( bool * ok = 0, int base = 10 ) const</td></tr>

128

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toLower">toLower</a> () const</td></tr>

129

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toPercentEncoding">toPercentEncoding</a> ( const QByteArray & exclude = QByteArray(), const QByteArray & include = QByteArray(), char percent = '%' ) const</td></tr>

130

<tr><td class="memItemLeft" align="right" valign="top">short </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toShort">toShort</a> ( bool * ok = 0, int base = 10 ) const</td></tr>

131

<tr><td class="memItemLeft" align="right" valign="top">uint </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toUInt">toUInt</a> ( bool * ok = 0, int base = 10 ) const</td></tr>

132

<tr><td class="memItemLeft" align="right" valign="top">ulong </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toULong">toULong</a> ( bool * ok = 0, int base = 10 ) const</td></tr>

133

<tr><td class="memItemLeft" align="right" valign="top">qulonglong </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toULongLong">toULongLong</a> ( bool * ok = 0, int base = 10 ) const</td></tr>

134

<tr><td class="memItemLeft" align="right" valign="top">ushort </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toUShort">toUShort</a> ( bool * ok = 0, int base = 10 ) const</td></tr>

135

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#toUpper">toUpper</a> () const</td></tr>

136

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#trimmed">trimmed</a> () const</td></tr>

137

<tr><td class="memItemLeft" align="right" valign="top">void </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#truncate">truncate</a> ( int pos )</td></tr>

138

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-const-char--2a">operator const char *</a> () const</td></tr>

139

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-const-void--2a">operator const void *</a> () const</td></tr>

140

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-not-eq">operator!=</a> ( const QString & str ) const</td></tr>

141

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-eq">operator+=</a> ( const QByteArray & ba )</td></tr>

142

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-eq-2">operator+=</a> ( const QString & str )</td></tr>

143

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-eq-3">operator+=</a> ( const char * str )</td></tr>

144

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-eq-4">operator+=</a> ( char ch )</td></tr>

145

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt">operator<</a> ( const QString & str ) const</td></tr>

146

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt-eq">operator<=</a> ( const QString & str ) const</td></tr>

147

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-eq">operator=</a> ( const QByteArray & other )</td></tr>

148

<tr><td class="memItemLeft" align="right" valign="top">QByteArray & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-eq-2">operator=</a> ( const char * str )</td></tr>

149

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-eq-eq">operator==</a> ( const QString & str ) const</td></tr>

150

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt">operator></a> ( const QString & str ) const</td></tr>

151

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt-eq">operator>=</a> ( const QString & str ) const</td></tr>

152

<tr><td class="memItemLeft" align="right" valign="top">QByteRef </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-5b-5d">operator[]</a> ( int i )</td></tr>

153

<tr><td class="memItemLeft" align="right" valign="top">char </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-5b-5d-2">operator[]</a> ( int i ) const</td></tr>

154

<tr><td class="memItemLeft" align="right" valign="top">QByteRef </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-5b-5d-3">operator[]</a> ( uint i )</td></tr>

155

<tr><td class="memItemLeft" align="right" valign="top">char </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-5b-5d-4">operator[]</a> ( uint i ) const</td></tr>

156

</table>

157

<hr />

153

158

154

<h3>Static Public Members</h3>

155

<ul>

156

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#fromBase64">fromBase64</a> ( const QByteArray & base64 )</li>

157

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#fromHex">fromHex</a> ( const QByteArray & hexEncoded )</li>

158

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#fromPercentEncoding">fromPercentEncoding</a> ( const QByteArray & input, char percent = '%' )</li>

159

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#fromRawData">fromRawData</a> ( const char * data, int size )</li>

160

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#number">number</a> ( int n, int base = 10 )</li>

161

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#number-2">number</a> ( uint n, int base = 10 )</li>

162

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#number-3">number</a> ( qlonglong n, int base = 10 )</li>

163

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#number-4">number</a> ( qulonglong n, int base = 10 )</li>

164

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#number-5">number</a> ( double n, char f = 'g', int prec = 6 )</li>

165

</ul>

159

<h2>Static Public Members</h2>

160

161

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#fromBase64">fromBase64</a> ( const QByteArray & base64 )</td></tr>

162

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#fromHex">fromHex</a> ( const QByteArray & hexEncoded )</td></tr>

163

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#fromPercentEncoding">fromPercentEncoding</a> ( const QByteArray & input, char percent = '%' )</td></tr>

164

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#fromRawData">fromRawData</a> ( const char * data, int size )</td></tr>

165

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#number">number</a> ( int n, int base = 10 )</td></tr>

166

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#number-2">number</a> ( uint n, int base = 10 )</td></tr>

167

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#number-3">number</a> ( qlonglong n, int base = 10 )</td></tr>

168

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#number-4">number</a> ( qulonglong n, int base = 10 )</td></tr>

169

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#number-5">number</a> ( double n, char f = 'g', int prec = 6 )</td></tr>

170

</table>

171

<hr />

166

172

167

<h3>Related Non-Members</h3>

168

<ul>

169

<li><div class="fn"></div>quint16 <a href="qbytearray.html#qChecksum">qChecksum</a> ( const char * data, uint len )</li>

170

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#qCompress">qCompress</a> ( const QByteArray & data, int compressionLevel = -1 )</li>

171

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#qCompress-2">qCompress</a> ( const uchar * data, int nbytes, int compressionLevel = -1 )</li>

172

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#qUncompress">qUncompress</a> ( const QByteArray & data )</li>

173

<li><div class="fn"></div>QByteArray <a href="qbytearray.html#qUncompress-2">qUncompress</a> ( const uchar * data, int nbytes )</li>

174

<li><div class="fn"></div>int <a href="qbytearray.html#qsnprintf">qsnprintf</a> ( char * str, size_t n, const char * fmt, ... )</li>

175

<li><div class="fn"></div>int <a href="qbytearray.html#qstrcmp">qstrcmp</a> ( const char * str1, const char * str2 )</li>

176

<li><div class="fn"></div>char * <a href="qbytearray.html#qstrcpy">qstrcpy</a> ( char * dst, const char * src )</li>

177

<li><div class="fn"></div>char * <a href="qbytearray.html#qstrdup">qstrdup</a> ( const char * src )</li>

178

<li><div class="fn"></div>int <a href="qbytearray.html#qstricmp">qstricmp</a> ( const char * str1, const char * str2 )</li>

179

<li><div class="fn"></div>uint <a href="qbytearray.html#qstrlen">qstrlen</a> ( const char * str )</li>

180

<li><div class="fn"></div>int <a href="qbytearray.html#qstrncmp">qstrncmp</a> ( const char * str1, const char * str2, uint len )</li>

181

<li><div class="fn"></div>char * <a href="qbytearray.html#qstrncpy">qstrncpy</a> ( char * dst, const char * src, uint len )</li>

182

<li><div class="fn"></div>int <a href="qbytearray.html#qstrnicmp">qstrnicmp</a> ( const char * str1, const char * str2, uint len )</li>

183

<li><div class="fn"></div>uint <a href="qbytearray.html#qstrnlen">qstrnlen</a> ( const char * str, uint maxlen )</li>

184

<li><div class="fn"></div>int <a href="qbytearray.html#qvsnprintf">qvsnprintf</a> ( char * str, size_t n, const char * fmt, va_list ap )</li>

185

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-not-eq-52">operator!=</a> ( const QByteArray & a1, const QByteArray & a2 )</li>

186

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-not-eq-53">operator!=</a> ( const QByteArray & a1, const char * a2 )</li>

187

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-not-eq-54">operator!=</a> ( const char * a1, const QByteArray & a2 )</li>

188

<li><div class="fn"></div>const QByteArray <a href="qbytearray.html#operator-2b-38">operator+</a> ( const QByteArray & a1, const char * a2 )</li>

189

<li><div class="fn"></div>const QByteArray <a href="qbytearray.html#operator-2b-39">operator+</a> ( const QByteArray & a1, char a2 )</li>

190

<li><div class="fn"></div>const QByteArray <a href="qbytearray.html#operator-2b-40">operator+</a> ( const char * a1, const QByteArray & a2 )</li>

191

<li><div class="fn"></div>const QByteArray <a href="qbytearray.html#operator-2b-41">operator+</a> ( char a1, const QByteArray & a2 )</li>

192

<li><div class="fn"></div>const QByteArray <a href="qbytearray.html#operator-2b-11">operator+</a> ( const QByteArray & a1, const QByteArray & a2 )</li>

193

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-lt-19">operator<</a> ( const QByteArray & a1, const QByteArray & a2 )</li>

194

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-lt-20">operator<</a> ( const QByteArray & a1, const char * a2 )</li>

195

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-lt-21">operator<</a> ( const char * a1, const QByteArray & a2 )</li>

196

<li><div class="fn"></div>QDataStream & <a href="qbytearray.html#operator-lt-lt-92">operator<<</a> ( QDataStream & out, const QByteArray & ba )</li>

197

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-lt-eq-14">operator<=</a> ( const QByteArray & a1, const QByteArray & a2 )</li>

198

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-lt-eq-15">operator<=</a> ( const QByteArray & a1, const char * a2 )</li>

199

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-lt-eq-16">operator<=</a> ( const char * a1, const QByteArray & a2 )</li>

200

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-eq-eq-74">operator==</a> ( const QByteArray & a1, const QByteArray & a2 )</li>

201

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-eq-eq-75">operator==</a> ( const QByteArray & a1, const char * a2 )</li>

202

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-eq-eq-76">operator==</a> ( const char * a1, const QByteArray & a2 )</li>

203

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-gt-14">operator></a> ( const QByteArray & a1, const QByteArray & a2 )</li>

204

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-gt-15">operator></a> ( const QByteArray & a1, const char * a2 )</li>

205

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-gt-16">operator></a> ( const char * a1, const QByteArray & a2 )</li>

206

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-gt-eq-14">operator>=</a> ( const QByteArray & a1, const QByteArray & a2 )</li>

207

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-gt-eq-15">operator>=</a> ( const QByteArray & a1, const char * a2 )</li>

208

<li><div class="fn"></div>bool <a href="qbytearray.html#operator-gt-eq-16">operator>=</a> ( const char * a1, const QByteArray & a2 )</li>

209

<li><div class="fn"></div>QDataStream & <a href="qbytearray.html#operator-gt-gt-54">operator>></a> ( QDataStream & in, QByteArray & ba )</li>

210

</ul>

173

<h2>Related Non-Members</h2>

174

175

<tr><td class="memItemLeft" align="right" valign="top">quint16 </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qChecksum">qChecksum</a> ( const char * data, uint len )</td></tr>

176

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qCompress">qCompress</a> ( const QByteArray & data, int compressionLevel = -1 )</td></tr>

177

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qCompress-2">qCompress</a> ( const uchar * data, int nbytes, int compressionLevel = -1 )</td></tr>

178

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qUncompress">qUncompress</a> ( const QByteArray & data )</td></tr>

179

<tr><td class="memItemLeft" align="right" valign="top">QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qUncompress-2">qUncompress</a> ( const uchar * data, int nbytes )</td></tr>

180

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qsnprintf">qsnprintf</a> ( char * str, size_t n, const char * fmt, ... )</td></tr>

181

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstrcmp">qstrcmp</a> ( const char * str1, const char * str2 )</td></tr>

182

<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstrcpy">qstrcpy</a> ( char * dst, const char * src )</td></tr>

183

<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstrdup">qstrdup</a> ( const char * src )</td></tr>

184

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstricmp">qstricmp</a> ( const char * str1, const char * str2 )</td></tr>

185

<tr><td class="memItemLeft" align="right" valign="top">uint </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstrlen">qstrlen</a> ( const char * str )</td></tr>

186

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstrncmp">qstrncmp</a> ( const char * str1, const char * str2, uint len )</td></tr>

187

<tr><td class="memItemLeft" align="right" valign="top">char * </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstrncpy">qstrncpy</a> ( char * dst, const char * src, uint len )</td></tr>

188

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstrnicmp">qstrnicmp</a> ( const char * str1, const char * str2, uint len )</td></tr>

189

<tr><td class="memItemLeft" align="right" valign="top">uint </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qstrnlen">qstrnlen</a> ( const char * str, uint maxlen )</td></tr>

190

<tr><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#qvsnprintf">qvsnprintf</a> ( char * str, size_t n, const char * fmt, va_list ap )</td></tr>

191

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-not-eq-59">operator!=</a> ( const QByteArray & a1, const QByteArray & a2 )</td></tr>

192

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-not-eq-60">operator!=</a> ( const QByteArray & a1, const char * a2 )</td></tr>

193

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-not-eq-61">operator!=</a> ( const char * a1, const QByteArray & a2 )</td></tr>

194

<tr><td class="memItemLeft" align="right" valign="top">const QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-40">operator+</a> ( const QByteArray & a1, const char * a2 )</td></tr>

195

<tr><td class="memItemLeft" align="right" valign="top">const QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-41">operator+</a> ( const QByteArray & a1, char a2 )</td></tr>

196

<tr><td class="memItemLeft" align="right" valign="top">const QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-42">operator+</a> ( const char * a1, const QByteArray & a2 )</td></tr>

197

<tr><td class="memItemLeft" align="right" valign="top">const QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-43">operator+</a> ( char a1, const QByteArray & a2 )</td></tr>

198

<tr><td class="memItemLeft" align="right" valign="top">const QByteArray </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-2b-17">operator+</a> ( const QByteArray & a1, const QByteArray & a2 )</td></tr>

199

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt-18">operator<</a> ( const QByteArray & a1, const QByteArray & a2 )</td></tr>

200

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt-19">operator<</a> ( const QByteArray & a1, const char * a2 )</td></tr>

201

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt-20">operator<</a> ( const char * a1, const QByteArray & a2 )</td></tr>

202

<tr><td class="memItemLeft" align="right" valign="top">QDataStream & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt-lt-141">operator<<</a> ( QDataStream & out, const QByteArray & ba )</td></tr>

203

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt-eq-13">operator<=</a> ( const QByteArray & a1, const QByteArray & a2 )</td></tr>

204

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt-eq-14">operator<=</a> ( const QByteArray & a1, const char * a2 )</td></tr>

205

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-lt-eq-15">operator<=</a> ( const char * a1, const QByteArray & a2 )</td></tr>

206

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-eq-eq-82">operator==</a> ( const QByteArray & a1, const QByteArray & a2 )</td></tr>

207

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-eq-eq-83">operator==</a> ( const QByteArray & a1, const char * a2 )</td></tr>

208

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-eq-eq-84">operator==</a> ( const char * a1, const QByteArray & a2 )</td></tr>

209

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt-13">operator></a> ( const QByteArray & a1, const QByteArray & a2 )</td></tr>

210

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt-14">operator></a> ( const QByteArray & a1, const char * a2 )</td></tr>

211

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt-15">operator></a> ( const char * a1, const QByteArray & a2 )</td></tr>

212

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt-eq-13">operator>=</a> ( const QByteArray & a1, const QByteArray & a2 )</td></tr>

213

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt-eq-14">operator>=</a> ( const QByteArray & a1, const char * a2 )</td></tr>

214

<tr><td class="memItemLeft" align="right" valign="top">bool </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt-eq-15">operator>=</a> ( const char * a1, const QByteArray & a2 )</td></tr>

215

<tr><td class="memItemLeft" align="right" valign="top">QDataStream & </td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#operator-gt-gt-75">operator>></a> ( QDataStream & in, QByteArray & ba )</td></tr>

216

</table>

217

<hr />

211

218

212

<h3>Macros</h3>

213

<ul>

214

<li><div class="fn"></div><a href="qbytearray.html#QT_NO_CAST_FROM_BYTEARRAY">QT_NO_CAST_FROM_BYTEARRAY</a></li>

215

</ul>

219

<h2>Macros</h2>

220

221

<tr><td class="memItemLeft" align="right" valign="top"></td><td class="memItemRight" valign="bottom"><a href="qbytearray.html#QT_NO_CAST_FROM_BYTEARRAY">QT_NO_CAST_FROM_BYTEARRAY</a></td></tr>

222

</table>

216

223

217

224

<hr />

218

225

<h2>Detailed Description</h2>

219

226

The QByteArray class provides an array of bytes.

220

QByteArray can be used to store both raw bytes (including '\0's) and traditional 8-bit '\0'-terminated strings. Using QByteArray is much more convenient than using <tt>const char *</tt>. Behind the scenes, it always ensures that the data is followed by a '\0' terminator, and uses <a href="shared.html#implicit-sharing">implicit sharing</a> (copy-on-write) to reduce memory usage and avoid needless copying of data.

227

QByteArray can be used to store both raw bytes (including '\0's) and traditional 8-bit '\0'-terminated strings. Using QByteArray is much more convenient than using <tt>const char *</tt>. Behind the scenes, it always ensures that the data is followed by a '\0' terminator, and uses <a href="implicit-sharing.html">implicit sharing</a> (copy-on-write) to reduce memory usage and avoid needless copying of data.

221

228

In addition to QByteArray, Qt also provides the <a href="qstring.html">QString</a> class to store string data. For most purposes, <a href="qstring.html">QString</a> is the class you want to use. It stores 16-bit Unicode characters, making it easy to store non-ASCII/non-Latin-1 characters in your application. Furthermore, <a href="qstring.html">QString</a> is used throughout in the Qt API. The two main cases where QByteArray is appropriate are when you need to store raw binary data, and when memory conservation is critical (e.g., with Qt for Embedded Linux).

222

229

One way to initialize a QByteArray is simply to pass a <tt>const char *</tt> to its constructor. For example, the following code creates a byte array of size 5 containing the data "Hello":

223

230

<pre> QByteArray ba("Hello");</pre>

236

243

if (ba.at(i) >= 'a' && ba.at(i) <= 'f')

237

244

cout << "Found character in range [a-f]" << endl;

238

245

}</pre>

239

<a href="qbytearray.html#at">at</a>() can be faster than operator[](), because it never causes a <a href="shared.html#deep-copy">deep copy</a> to occur.

246

<a href="qbytearray.html#at">at</a>() can be faster than operator[](), because it never causes a <a href="implicit-sharing.html#deep-copy">deep copy</a> to occur.

240

247

To extract many bytes at a time, use <a href="qbytearray.html#left">left</a>(), <a href="qbytearray.html#right">right</a>(), or <a href="qbytearray.html#mid">mid</a>().

241

248

A QByteArray can embed '\0' bytes. The <a href="qbytearray.html#size">size</a>() function always returns the size of the whole array, including embedded '\0' bytes. If you want to obtain the length of the data up to and excluding the first '\0' character, call <a href="qbytearray.html#qstrlen">qstrlen</a>() on the byte array.

242

249

After a call to <a href="qbytearray.html#resize">resize</a>(), newly allocated bytes have undefined values. To set all the bytes to a particular value, call <a href="qbytearray.html#fill">fill</a>().

280

287

See also <a href="qstring.html">QString</a> and <a href="qbitarray.html">QBitArray</a>.

281

288

<hr />

282

289

<h2>Member Function Documentation</h2>

290

283

291

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

284

292

Constructs an empty byte array.

285

293

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

294

302

<h3 class="fn"><a name="QByteArray-4"></a>QByteArray::QByteArray ( int size, char ch )</h3>

295

303

Constructs a byte array of size size with every byte set to character ch.

296

304

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

297

<h3 class="fn"><a name="QByteArray-5"></a>QByteArray::QByteArray ( const QByteArray & other )</h3>

305

<h3 class="fn"><a name="QByteArray-6"></a>QByteArray::QByteArray ( const QByteArray & other )</h3>

298

306

Constructs a copy of other.

299

This operation takes <a href="containers.html#constant-time">constant time</a>, because <a href="qbytearray.html">QByteArray</a> is <a href="shared.html#implicitly-shared">implicitly shared</a>. This makes returning a <a href="qbytearray.html">QByteArray</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>.

307

This operation takes <a href="containers.html#constant-time">constant time</a>, because <a href="qbytearray.html">QByteArray</a> is <a href="implicit-sharing.html#implicitly-shared">implicitly shared</a>. This makes returning a <a href="qbytearray.html">QByteArray</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>.

300

308

See also <a href="qbytearray.html#operator-eq">operator=</a>().

309

301

310

<h3 class="fn"><a name="dtor.QByteArray"></a>QByteArray::~QByteArray ()</h3>

302

311

Destroys the byte array.

312

303

313

<h3 class="fn"><a name="append"></a>QByteArray & QByteArray::append ( const QByteArray & ba )</h3>

304

314

Appends the byte array ba onto the end of this byte array.

305

315

Example:

309

319

// x == "freedom"</pre>

310

320

This is the same as insert(<a href="qbytearray.html#size">size</a>(), ba).

311

321

This operation is typically very fast (<a href="containers.html#constant-time">constant time</a>), because <a href="qbytearray.html">QByteArray</a> preallocates extra space at the end of the character data so it can grow without reallocating the entire data each time.

312

Note: <a href="qbytearray.html">QByteArray</a> is an <a href="shared.html#implicitly-shared">implicitly shared</a> class. Consequently, if this is an empty <a href="qbytearray.html">QByteArray</a>, then this will just share the data held in ba. In this case, no copying of data is done.

322

Note: <a href="qbytearray.html">QByteArray</a> is an <a href="implicit-sharing.html#implicitly-shared">implicitly shared</a> class. Consequently, if this is an empty <a href="qbytearray.html">QByteArray</a>, then this will just share the data held in ba. In this case, no copying of data is done.

313

323

See also <a href="qbytearray.html#operator-2b-eq">operator+=</a>(), <a href="qbytearray.html#prepend">prepend</a>(), and <a href="qbytearray.html#insert">insert</a>().

314

324

<h3 class="fn"><a name="append-2"></a>QByteArray & QByteArray::append ( const <a href="qstring.html">QString</a> & str )</h3>

315

325

This is an overloaded function.

325

335

<h3 class="fn"><a name="append-5"></a>QByteArray & QByteArray::append ( char ch )</h3>

326

336

This is an overloaded function.

327

337

Appends the character ch to this byte array.

338

328

339

<h3 class="fn"><a name="at"></a>char QByteArray::at ( int i ) const</h3>

329

340

Returns the character at index position i in the byte array.

330

341

i must be a valid index position in the byte array (i.e., 0 <= i < <a href="qbytearray.html#size">size</a>()).

331

342

See also <a href="qbytearray.html#operator-5b-5d">operator[]</a>().

343

332

344

<h3 class="fn"><a name="capacity"></a>int QByteArray::capacity () const</h3>

333

345

Returns the maximum number of bytes that can be stored in the byte array without forcing a reallocation.

334

346

The sole purpose of this function is to provide a means of fine tuning <a href="qbytearray.html">QByteArray</a>'s memory usage. In general, you will rarely ever need to call this function. If you want to know how many bytes are in the byte array, call <a href="qbytearray.html#size">size</a>().

335

347

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

348

336

349

<h3 class="fn"><a name="chop"></a>void QByteArray::chop ( int n )</h3>

337

350

Removes n bytes from the end of the byte array.

338

351

If n is greater than <a href="qbytearray.html#size">size</a>(), the result is an empty byte array.

340

353

<pre> QByteArray ba("STARTTLS\r\n");

341

354

ba.chop(2); // ba == "STARTTLS"</pre>

342

355

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

356

343

357

<h3 class="fn"><a name="clear"></a>void QByteArray::clear ()</h3>

344

358

Clears the contents of the byte array and makes it empty.

345

359

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

360

346

361

<h3 class="fn"><a name="constData"></a>const char * QByteArray::constData () const</h3>

347

362

Returns a pointer to the data stored in the byte array. The pointer can be used to access the bytes that compose the array. The data is '\0'-terminated. The pointer remains valid as long as the byte array isn't reallocated or destroyed.

348

363

This function is mostly useful to pass a byte array to a function that accepts a <tt>const char *</tt>.

349

364

Note: A <a href="qbytearray.html">QByteArray</a> can store any byte values including '\0's, but most functions that take <tt>char *</tt> arguments assume that the data ends at the first '\0' they encounter.

350

365

See also <a href="qbytearray.html#data">data</a>() and <a href="qbytearray.html#operator-5b-5d">operator[]</a>().

366

351

367

<h3 class="fn"><a name="contains"></a>bool QByteArray::contains ( const QByteArray & ba ) const</h3>

352

368

Returns true if the byte array contains an occurrence of the byte array ba; otherwise returns false.

353

369

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

357

373

<h3 class="fn"><a name="contains-3"></a>bool QByteArray::contains ( char ch ) const</h3>

358

374

This is an overloaded function.

359

375

Returns true if the byte array contains the character ch; otherwise returns false.

376

360

377

<h3 class="fn"><a name="count"></a>int QByteArray::count ( const QByteArray & ba ) const</h3>

361

378

Returns the number of (potentially overlapping) occurrences of byte array ba in this byte array.

362

379

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

370

387

<h3 class="fn"><a name="count-4"></a>int QByteArray::count () const</h3>

371

388

This is an overloaded function.

372

389

Same as <a href="qbytearray.html#size">size</a>().

390

373

391

<h3 class="fn"><a name="data"></a>char * QByteArray::data ()</h3>

374

392

Returns a pointer to the data stored in the byte array. The pointer can be used to access and modify the bytes that compose the array. The data is '\0'-terminated.

375

393

Example:

379

397

cout << "[" << *data << "]" << endl;

380

398

++data;

381

399

}</pre>

382

The pointer remains valid as long as the byte array isn't reallocated or destroyed. For read-only access, <a href="qbytearray.html#constData">constData</a>() is faster because it never causes a <a href="shared.html#deep-copy">deep copy</a> to occur.

400

383

401

This function is mostly useful to pass a byte array to a function that accepts a <tt>const char *</tt>.

384

402

385

403

See also <a href="qbytearray.html#constData">constData</a>() and <a href="qbytearray.html#operator-5b-5d">operator[]</a>().

386

404

<h3 class="fn"><a name="data-2"></a>const char * QByteArray::data () const</h3>

387

405

This is an overloaded function.

406

388

407

<h3 class="fn"><a name="endsWith"></a>bool QByteArray::endsWith ( const QByteArray & ba ) const</h3>

389

408

Returns true if this byte array ends with byte array ba; otherwise returns false.

390

409

Example:

391

<pre> QByteArray url("http://qtsoftware.com/index.html");

410

<pre> QByteArray url("http://qt.nokia.com/index.html");

392

411

if (url.endsWith(".html"))

393

412

...</pre>

394

413

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

398

417

<h3 class="fn"><a name="endsWith-3"></a>bool QByteArray::endsWith ( char ch ) const</h3>

399

418

This is an overloaded function.

400

419

Returns true if this byte array ends with character ch; otherwise returns false.

420

401

421

<h3 class="fn"><a name="fill"></a>QByteArray & QByteArray::fill ( char ch, int size = -1 )</h3>

402

422

Sets every byte in the byte array to character ch. If size is different from -1 (the default), the byte array is resized to size size beforehand.

403

423

Example:

408

428

ba.fill('X', 2);

409

429

// ba == "XX"</pre>

410

430

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

431

411

432

<h3 class="fn"><a name="fromBase64"></a>QByteArray QByteArray::fromBase64 ( const QByteArray & base64 )  <tt> [static]</tt></h3>

412

433

Returns a decoded copy of the Base64 array base64. Input is not checked for validity; invalid characters in the input are skipped, enabling the decoding process to continue with subsequent characters.

413

434

For example:

415

436

text.data(); // returns "Qt is great!"</pre>

416

437

The algorithm used to decode Base64-encoded data is defined in <a href="http://www.rfc-editor.org/rfc/rfc2045.txt">RFC 2045</a>.

417

438

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

439

418

440

<h3 class="fn"><a name="fromHex"></a>QByteArray QByteArray::fromHex ( const QByteArray & hexEncoded )  <tt> [static]</tt></h3>

419

441

Returns a decoded copy of the hex encoded array hexEncoded. Input is not checked for validity; invalid characters in the input are skipped, enabling the decoding process to continue with subsequent characters.

420

442

For example:

421

443

<pre> QByteArray text = QByteArray::fromHex("517420697320677265617421");

422

444

text.data(); // returns "Qt is great!"</pre>

423

445

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

446

424

447

<h3 class="fn"><a name="fromPercentEncoding"></a>QByteArray QByteArray::fromPercentEncoding ( const QByteArray & input, char percent = '%' )  <tt> [static]</tt></h3>

425

Returns a decoded copy of the URI/URL-style percent-encoded input. The percent parameter allows you to replace the '%' character for another (for instance, '_' or '=').

448

Returns a decoded copy of the URI/URL-style percent-encoded input. The percent parameter allows you to replace the '%' character for another (for instance, '<a href="examples-overview.html">_</a>' or '=').

426

449

For example:

427

450

<pre> QByteArray text = QByteArray::fromPercentEncoding("Qt%20is%20great%33");

428

451

text.data(); // returns "Qt is great!"</pre>

429

452

This function was introduced in Qt 4.4.

430

453

See also <a href="qbytearray.html#toPercentEncoding">toPercentEncoding</a>() and <a href="qurl.html#fromPercentEncoding">QUrl::fromPercentEncoding</a>().

454

431

455

<h3 class="fn"><a name="fromRawData"></a>QByteArray QByteArray::fromRawData ( const char * data, int size )  <tt> [static]</tt></h3>

432

Constructs a <a href="qbytearray.html">QByteArray</a> that uses the first size bytes of the data array. The bytes are not copied. The <a href="qbytearray.html">QByteArray</a> will contain the data pointer. The caller guarantees that data will not be deleted or modified as long as this <a href="qbytearray.html">QByteArray</a> and any copies of it exist that have not been modified. In other words, because <a href="qbytearray.html">QByteArray</a> is an <a href="shared.html#implicitly-shared">implicitly shared</a> class and the instance returned by this function contains the data pointer, the caller must not delete data or modify it directly as long as the returned <a href="qbytearray.html">QByteArray</a> and any copies exist. However, <a href="qbytearray.html">QByteArray</a> does not take ownership of data, so the <a href="qbytearray.html">QByteArray</a> destructor will never delete the raw data, even when the last <a href="qbytearray.html">QByteArray</a> referring to data is destroyed.

456

Constructs a <a href="qbytearray.html">QByteArray</a> that uses the first size bytes of the data array. The bytes are not copied. The <a href="qbytearray.html">QByteArray</a> will contain the data pointer. The caller guarantees that data will not be deleted or modified as long as this <a href="qbytearray.html">QByteArray</a> and any copies of it exist that have not been modified. In other words, because <a href="qbytearray.html">QByteArray</a> is an <a href="implicit-sharing.html#implicitly-shared">implicitly shared</a> class and the instance returned by this function contains the data pointer, the caller must not delete data or modify it directly as long as the returned <a href="qbytearray.html">QByteArray</a> and any copies exist. However, <a href="qbytearray.html">QByteArray</a> does not take ownership of data, so the <a href="qbytearray.html">QByteArray</a> destructor will never delete the raw data, even when the last <a href="qbytearray.html">QByteArray</a> referring to data is destroyed.

433

457

A subsequent attempt to modify the contents of the returned <a href="qbytearray.html">QByteArray</a> or any copy made from it will cause it to create a deep copy of the data array before doing the modification. This ensures that the raw data array itself will never be modified by <a href="qbytearray.html">QByteArray</a>.

434

458

Here is an example of how to read data using a <a href="qdatastream.html">QDataStream</a> on raw data in memory without copying the raw data into a <a href="qbytearray.html">QByteArray</a>:

435

459

<pre> static const char mydata[] = {

444

468

...</pre>

445

469

Warning: A byte array created with fromRawData() is not null-terminated, unless the raw data contains a 0 character at position size. While that does not matter for <a href="qdatastream.html">QDataStream</a> or functions like <a href="qbytearray.html#indexOf">indexOf</a>(), passing the byte array to a function accepting a <tt>const char *</tt> expected to be '\0'-terminated will fail.

446

470

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

471

447

472

<h3 class="fn"><a name="indexOf"></a>int QByteArray::indexOf ( const QByteArray & ba, int from = 0 ) const</h3>

448

473

Returns the index position of the first occurrence of the byte array ba in this byte array, searching forward from index position from. Returns -1 if ba could not be found.

449

474

Example:

472

497

ba.indexOf("B", 2); // returns 3

473

498

ba.indexOf("X"); // returns -1</pre>

474

499

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

500

475

501

<h3 class="fn"><a name="insert"></a>QByteArray & QByteArray::insert ( int i, const QByteArray & ba )</h3>

476

502

Inserts the byte array ba at index position i and returns a reference to this byte array.

477

503

Example:

488

514

This is an overloaded function.

489

515

Inserts the string str at position i in the byte array.

490

516

If i is greater than <a href="qbytearray.html#size">size</a>(), the array is first extended using <a href="qbytearray.html#resize">resize</a>().

491

<h3 class="fn"><a name="insert-4"></a>QByteArray & QByteArray::insert ( int i, char ch )</h3>

517

<h3 class="fn"><a name="insert-4"></a>QByteArray & QByteArray::insert ( int i, const char * str, int len )</h3>

518

This is an overloaded function.

519

Inserts len bytes of the string str at position i in the byte array.

520

If i is greater than <a href="qbytearray.html#size">size</a>(), the array is first extended using <a href="qbytearray.html#resize">resize</a>().

521

This function was introduced in Qt 4.6.

522

<h3 class="fn"><a name="insert-5"></a>QByteArray & QByteArray::insert ( int i, char ch )</h3>

492

523

This is an overloaded function.

493

524

Inserts character ch at index position i in the byte array. If i is greater than <a href="qbytearray.html#size">size</a>(), the array is first extended using <a href="qbytearray.html#resize">resize</a>().

525

494

526

<h3 class="fn"><a name="isEmpty"></a>bool QByteArray::isEmpty () const</h3>

495

527

Returns true if the byte array has size 0; otherwise returns false.

496

528

Example:

498

530

QByteArray("").isEmpty(); // returns true

499

531

QByteArray("abc").isEmpty(); // returns false</pre>

500

532

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

533

501

534

<h3 class="fn"><a name="isNull"></a>bool QByteArray::isNull () const</h3>

502

535

Returns true if this byte array is null; otherwise returns false.

503

536

Example:

506

539

QByteArray("abc").isNull(); // returns false</pre>

507

540

Qt makes a distinction between null byte arrays and empty byte arrays for historical reasons. For most applications, what matters is whether or not a byte array contains any data, and this can be determined using <a href="qbytearray.html#isEmpty">isEmpty</a>().

508

541

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

542

509

543

<h3 class="fn"><a name="lastIndexOf"></a>int QByteArray::lastIndexOf ( const QByteArray & ba, int from = -1 ) const</h3>

510

544

Returns the index position of the last occurrence of the byte array ba in this byte array, searching backward from index position from. If from is -1 (the default), the search starts at the last byte. Returns -1 if ba could not be found.

511

545

Example:

534

568

ba.lastIndexOf("B", 2); // returns 1

535

569

ba.lastIndexOf("X"); // returns -1</pre>

536

570

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

571

537

572

<h3 class="fn"><a name="left"></a>QByteArray QByteArray::left ( int len ) const</h3>

538

573

Returns a byte array that contains the leftmost len bytes of this byte array.

539

574

The entire byte array is returned if len is greater than <a href="qbytearray.html#size">size</a>().

542

577

QByteArray y = x.left(4);

543

578

// y == "Pine"</pre>

544

579

See also <a href="qbytearray.html#right">right</a>(), <a href="qbytearray.html#mid">mid</a>(), <a href="qbytearray.html#startsWith">startsWith</a>(), and <a href="qbytearray.html#truncate">truncate</a>().

580

545

581

<h3 class="fn"><a name="leftJustified"></a>QByteArray QByteArray::leftJustified ( int width, char fill = ' ', bool truncate = false ) const</h3>

546

582

Returns a byte array of size width that contains this byte array padded by the fill character.

547

583

If truncate is false and the <a href="qbytearray.html#size">size</a>() of the byte array is more than width, then the returned byte array is a copy of this byte array.

550

586

<pre> QByteArray x("apple");

551

587

QByteArray y = x.leftJustified(8, '.'); // y == "apple..."</pre>

552

588

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

589

553

590

<h3 class="fn"><a name="length"></a>int QByteArray::length () const</h3>

554

591

Same as <a href="qbytearray.html#size">size</a>().

592

555

593

<h3 class="fn"><a name="mid"></a>QByteArray QByteArray::mid ( int pos, int len = -1 ) const</h3>

556

594

Returns a byte array containing len bytes from this byte array, starting at position pos.

557

595

If len is -1 (the default), or pos + len >= <a href="qbytearray.html#size">size</a>(), returns a byte array containing all bytes starting at position pos until the end of the byte array.

560

598

QByteArray y = x.mid(5, 4); // y == "pine"

561

599

QByteArray z = x.mid(5); // z == "pineapples"</pre>

562

600

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

601

563

602

<h3 class="fn"><a name="number"></a>QByteArray QByteArray::number ( int n, int base = 10 )  <tt> [static]</tt></h3>

564

603

Returns a byte array containing the string equivalent of the number n to base base (10 by default). The base can be any value between 2 and 36.

565

604

Example:

582

621

This is an overloaded function.

583

622

Returns a byte array that contains the printed value of n, formatted in format f with precision prec.

584

623

Argument n is formatted according to the f format specified, which is <tt>g</tt> by default, and can be any of the following:

585

624

586

625

<thead><tr valign="top" class="qt-style"><th>Format</th><th>Meaning</th></tr></thead>

587

626

<tr valign="top" class="odd"><td><tt>e</tt></td><td>format as [-]9.9e[+|-]999</td></tr>

588

627

<tr valign="top" class="even"><td><tt>E</tt></td><td>format as [-]9.9E[+|-]999</td></tr>

595

634

// ba == 1.235E+01</pre>

596

635

Note: The format of the number is not localized; the default C locale is used irrespective of the user's locale.

597

636

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

637

598

638

<h3 class="fn"><a name="prepend"></a>QByteArray & QByteArray::prepend ( const QByteArray & ba )</h3>

599

639

Prepends the byte array ba to this byte array and returns a reference to this byte array.

600

640

Example:

603

643

x.prepend(y);

604

644

// x == "airship"</pre>

605

645

This is the same as insert(0, ba).

606

646

607

647

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

608

648

<h3 class="fn"><a name="prepend-2"></a>QByteArray & QByteArray::prepend ( const char * str )</h3>

609

649

This is an overloaded function.

610

650

Prepends the string str to this byte array.

611

<h3 class="fn"><a name="prepend-3"></a>QByteArray & QByteArray::prepend ( char ch )</h3>

651

<h3 class="fn"><a name="prepend-3"></a>QByteArray & QByteArray::prepend ( const char * str, int len )</h3>

652

This is an overloaded function.

653

Prepends len bytes of the string str to this byte array.

654

This function was introduced in Qt 4.6.

655

<h3 class="fn"><a name="prepend-4"></a>QByteArray & QByteArray::prepend ( char ch )</h3>

612

656

This is an overloaded function.

613

657

Prepends the character ch to this byte array.

658

614

659

<h3 class="fn"><a name="push_back"></a>void QByteArray::push_back ( const QByteArray & other )</h3>

615

660

This function is provided for STL compatibility. It is equivalent to append(other).

616

661

<h3 class="fn"><a name="push_back-2"></a>void QByteArray::push_back ( const char * str )</h3>

619

664

<h3 class="fn"><a name="push_back-3"></a>void QByteArray::push_back ( char ch )</h3>

620

665

This is an overloaded function.

621

666

Same as append(ch).

667

622

668

<h3 class="fn"><a name="push_front"></a>void QByteArray::push_front ( const QByteArray & other )</h3>

623

669

This function is provided for STL compatibility. It is equivalent to prepend(other).

624

670

<h3 class="fn"><a name="push_front-2"></a>void QByteArray::push_front ( const char * str )</h3>

627

673

<h3 class="fn"><a name="push_front-3"></a>void QByteArray::push_front ( char ch )</h3>

628

674

This is an overloaded function.

629

675

Same as prepend(ch).

676

630

677

<h3 class="fn"><a name="remove"></a>QByteArray & QByteArray::remove ( int pos, int len )</h3>

631

678

Removes len bytes from the array, starting at index position pos, and returns a reference to the array.

632

679

If pos is out of range, nothing happens. If pos is valid, but pos + len is larger than the size of the array, the array is truncated at position pos.

635

682

ba.remove(1, 4);

636

683

// ba == "Meal"</pre>

637

684

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

685

638

686

<h3 class="fn"><a name="repeated"></a>QByteArray QByteArray::repeated ( int times ) const</h3>

639

687

Returns a copy of this byte array repeated the specified number of times.

640

688

If times is less than 1, an empty byte array is returned.

642

690

<pre> QByteArray ba("ab");

643

691

ba.repeated(4); // returns "abababab"</pre>

644

692

This function was introduced in Qt 4.5.

693

645

694

<h3 class="fn"><a name="replace"></a>QByteArray & QByteArray::replace ( int pos, int len, const QByteArray & after )</h3>

646

695

Replaces len bytes from index position pos with the byte array after, and returns a reference to this byte array.

647

696

Example:

691

740

<h3 class="fn"><a name="replace-13"></a>QByteArray & QByteArray::replace ( char before, char after )</h3>

692

741

This is an overloaded function.

693

742

Replaces every occurrence of the character before with the character after.

743

694

744

<h3 class="fn"><a name="reserve"></a>void QByteArray::reserve ( int size )</h3>

695

745

Attempts to allocate memory for at least size bytes. If you know in advance how large the byte array will be, you can call this function, and if you call <a href="qbytearray.html#resize">resize</a>() often you are likely to get better performance. If size is an underestimate, the worst that will happen is that the <a href="qbytearray.html">QByteArray</a> will be a bit slower.

696

746

The sole purpose of this function is to provide a means of fine tuning <a href="qbytearray.html">QByteArray</a>'s memory usage. In general, you will rarely ever need to call this function. If you want to change the size of the byte array, call <a href="qbytearray.html#resize">resize</a>().

697

747

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

748

698

749

<h3 class="fn"><a name="resize"></a>void QByteArray::resize ( int size )</h3>

699

750

Sets the size of the byte array to size bytes.

700

751

If size is greater than the current size, the byte array is extended to make it size bytes with the extra bytes added to the end. The new bytes are uninitialized.

701

752

If size is less than the current size, bytes are removed from the end.

702

753

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

754

703

755

<h3 class="fn"><a name="right"></a>QByteArray QByteArray::right ( int len ) const</h3>

704

756

Returns a byte array that contains the rightmost len bytes of this byte array.

705

757

The entire byte array is returned if len is greater than <a href="qbytearray.html#size">size</a>().

708

760

QByteArray y = x.right(5);

709

761

// y == "apple"</pre>

710

762

See also <a href="qbytearray.html#endsWith">endsWith</a>(), <a href="qbytearray.html#left">left</a>(), and <a href="qbytearray.html#mid">mid</a>().

763

711

764

<h3 class="fn"><a name="rightJustified"></a>QByteArray QByteArray::rightJustified ( int width, char fill = ' ', bool truncate = false ) const</h3>

712

765

Returns a byte array of size width that contains the fill character followed by this byte array.

713

766

If truncate is false and the size of the byte array is more than width, then the returned byte array is a copy of this byte array.

716

769

<pre> QByteArray x("apple");

717

770

QByteArray y = x.rightJustified(8, '.'); // y == "...apple"</pre>

718

771

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

772

719

773

<h3 class="fn"><a name="setNum"></a>QByteArray & QByteArray::setNum ( int n, int base = 10 )</h3>

720

774

Sets the byte array to the printed value of n in base base (10 by default) and returns a reference to the byte array. The base can be any value between 2 and 36.

721

775

Example:

744

798

This is an overloaded function.

745

799

Sets the byte array to the printed value of n, formatted in format f with precision prec, and returns a reference to the byte array.

746

800

The format f can be any of the following:

747

801

748

802

<thead><tr valign="top" class="qt-style"><th>Format</th><th>Meaning</th></tr></thead>

749

803

<tr valign="top" class="odd"><td><tt>e</tt></td><td>format as [-]9.9e[+|-]999</td></tr>

750

804

<tr valign="top" class="even"><td><tt>E</tt></td><td>format as [-]9.9E[+|-]999</td></tr>

760

814

Sets the byte array to the printed value of n, formatted in format f with precision prec, and returns a reference to the byte array.

761

815

Note: The format of the number is not localized; the default C locale is used irrespective of the user's locale.

762

816

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

817

763

818

<h3 class="fn"><a name="simplified"></a>QByteArray QByteArray::simplified () const</h3>

764

819

Returns a byte array that has whitespace removed from the start and the end, and which has each sequence of internal whitespace replaced with a single space.

765

820

Whitespace means any character for which the standard C++ isspace() function returns true. This includes the ASCII characters '\t', '\n', '\v', '\f', '\r', and ' '.

768

823

ba = ba.simplified();

769

824

// ba == "lots of whitespace";</pre>

770

825

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

826

771

827

<h3 class="fn"><a name="size"></a>int QByteArray::size () const</h3>

772

828

Returns the number of bytes in this byte array.

773

829

The last byte in the byte array is at position size() - 1. In addition, <a href="qbytearray.html">QByteArray</a> ensures that the byte at position size() is always '\0', so that you can use the return value of <a href="qbytearray.html#data">data</a>() and <a href="qbytearray.html#constData">constData</a>() as arguments to functions that expect '\0'-terminated strings.

778

834

ba.data()[4]; // returns 'o'

779

835

ba.data()[5]; // returns '\0'</pre>

780

836

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

837

781

838

<h3 class="fn"><a name="split"></a><a href="qlist.html">QList</a><QByteArray> QByteArray::split ( char sep ) const</h3>

782

839

Splits the byte array into subarrays wherever sep occurs, and returns the list of those arrays. If sep does not match anywhere in the byte array, split() returns a single-element list containing this byte array.

840

783

841

<h3 class="fn"><a name="squeeze"></a>void QByteArray::squeeze ()</h3>

784

842

Releases any memory not required to store the array's data.

785

843

The sole purpose of this function is to provide a means of fine tuning <a href="qbytearray.html">QByteArray</a>'s memory usage. In general, you will rarely ever need to call this function.

786

844

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

845

787

846

<h3 class="fn"><a name="startsWith"></a>bool QByteArray::startsWith ( const QByteArray & ba ) const</h3>

788

847

Returns true if this byte array starts with byte array ba; otherwise returns false.

789

848

Example:

790

<pre> QByteArray url("ftp://ftp.trolltech.com/");

849

<pre> QByteArray url("ftp://ftp.qt.nokia.com/");

791

850

if (url.startsWith("ftp:"))

792

851

...</pre>

793

852

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

797

856

<h3 class="fn"><a name="startsWith-3"></a>bool QByteArray::startsWith ( char ch ) const</h3>

798

857

This is an overloaded function.

799

858

Returns true if this byte array starts with character ch; otherwise returns false.

859

800

860

<h3 class="fn"><a name="toBase64"></a>QByteArray QByteArray::toBase64 () const</h3>

801

861

Returns a copy of the byte array, encoded as Base64.

802

862

<pre> QByteArray text("Qt is great!");

803

863

text.toBase64(); // returns "UXQgaXMgZ3JlYXQh"</pre>

804

864

The algorithm used to encode Base64-encoded data is defined in <a href="http://www.rfc-editor.org/rfc/rfc2045.txt">RFC 2045</a>.

805

865

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

866

806

867

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

807

868

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

808

869

Returns 0.0 if the conversion fails.

811

872

double a = string.toDouble(); // a == 1234.56</pre>

812

873

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

813

874

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

875

814

876

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

815

877

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

816

878

Returns 0.0 if the conversion fails.

817

879

If ok is not 0: if a conversion error occurs, *ok is set to false; otherwise *ok is set to true.

818

880

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

819

881

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

882

820

883

<h3 class="fn"><a name="toHex"></a>QByteArray QByteArray::toHex () const</h3>

821

884

Returns a hex encoded copy of the byte array. The hex encoding uses the numbers 0-9 and the letters a-f.

822

885

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

886

823

887

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

824

888

Returns the byte array converted to an <tt>int</tt> using base base, which is 10 by default and must be between 2 and 36, or 0.

825

889

If base is 0, the base is determined automatically using the following rules: If the byte array begins with "0x", it is assumed to be hexadecimal; if it begins with "0", it is assumed to be octal; otherwise it is assumed to be decimal.

831

895

int dec = str.toInt(&ok, 10); // dec == 0, ok == false</pre>

832

896

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

833

897

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

898

834

899

<h3 class="fn"><a name="toLong"></a>long QByteArray::toLong ( bool * ok = 0, int base = 10 ) const</h3>

835

900

Returns the byte array converted to a <tt>long</tt> int using base base, which is 10 by default and must be between 2 and 36, or 0.

836

901

843

908

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

844

909

This function was introduced in Qt 4.1.

845

910

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

911

846

912

<h3 class="fn"><a name="toLongLong"></a><a href="qtglobal.html#qlonglong-typedef">qlonglong</a> QByteArray::toLongLong ( bool * ok = 0, int base = 10 ) const</h3>

847

913

Returns the byte array converted to a <tt>long long</tt> using base base, which is 10 by default and must be between 2 and 36, or 0.

848

914

850

916

If ok is not 0: if a conversion error occurs, *ok is set to false; otherwise *ok is set to true.

851

917

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

852

918

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

919

853

920

<h3 class="fn"><a name="toLower"></a>QByteArray QByteArray::toLower () const</h3>

854

921

Returns a lowercase copy of the byte array. The bytearray is interpreted as a Latin-1 encoded string.

855

922

Example:

856

<pre> QByteArray x("TROlltECH");

923

<pre> QByteArray x("Qt by NOKIA");

857

924

QByteArray y = x.toLower();

858

// y == "trolltech"</pre>

925

// y == "qt by nokia"</pre>

859

926

See also <a href="qbytearray.html#toUpper">toUpper</a>() and <a href="qbytearray.html#8-bit-character-comparisons">8-bit Character Comparisons</a>.

927

860

928

<h3 class="fn"><a name="toPercentEncoding"></a>QByteArray QByteArray::toPercentEncoding ( const QByteArray & exclude = QByteArray(), const QByteArray & include = QByteArray(), char percent = '%' ) const</h3>

861

929

Returns a URI/URL-style percent-encoded copy of this byte array. The percent parameter allows you to override the default '%' character for another.

862

930

By default, this function will encode all characters that are not one of the following:

863

ALPHA ("a" to "z" and "A" to "Z") / DIGIT (0 to 9) / "-" / "." / "_" / "~"

931

ALPHA ("a" to "z" and "A" to "Z") / DIGIT (0 to 9) / "-" / "." / "<a href="examples-overview.html">_</a>" / "~"

864

932

To prevent characters from being encoded pass them to exclude. To force characters to be encoded pass them to include. The percent character is always encoded.

865

933

Example:

866

934

<pre> QByteArray text = "{a fishy string?}";

870

938

The hex encoding uses the numbers 0-9 and the uppercase letters A-F.

871

939

This function was introduced in Qt 4.4.

872

940

See also <a href="qbytearray.html#fromPercentEncoding">fromPercentEncoding</a>() and <a href="qurl.html#toPercentEncoding">QUrl::toPercentEncoding</a>().

941

873

942

<h3 class="fn"><a name="toShort"></a>short QByteArray::toShort ( bool * ok = 0, int base = 10 ) const</h3>

874

943

Returns the byte array converted to a <tt>short</tt> using base base, which is 10 by default and must be between 2 and 36, or 0.

875

944

877

946

If ok is not 0: if a conversion error occurs, *ok is set to false; otherwise *ok is set to true.

878

947

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

879

948

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

949

880

950

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

881

951

Returns the byte array converted to an <tt>unsigned int</tt> using base base, which is 10 by default and must be between 2 and 36, or 0.

882

952

884

954

If ok is not 0: if a conversion error occurs, *ok is set to false; otherwise *ok is set to true.

885

955

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

886

956

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

957

887

958

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

888

959

Returns the byte array converted to an <tt>unsigned long int</tt> using base base, which is 10 by default and must be between 2 and 36, or 0.

889

960

892

963

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

893

964

This function was introduced in Qt 4.1.

894

965

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

966

895

967

<h3 class="fn"><a name="toULongLong"></a><a href="qtglobal.html#qulonglong-typedef">qulonglong</a> QByteArray::toULongLong ( bool * ok = 0, int base = 10 ) const</h3>

896

968

Returns the byte array converted to an <tt>unsigned long long</tt> using base base, which is 10 by default and must be between 2 and 36, or 0.

897

969

899

971

If ok is not 0: if a conversion error occurs, *ok is set to false; otherwise *ok is set to true.

900

972

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

901

973

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

974

902

975

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

903

976

Returns the byte array converted to an <tt>unsigned short</tt> using base base, which is 10 by default and must be between 2 and 36, or 0.

904

977

906

979

If ok is not 0: if a conversion error occurs, *ok is set to false; otherwise *ok is set to true.

907

980

Note: The conversion of the number is performed in the default C locale, irrespective of the user's locale.

908

981

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

982

909

983

<h3 class="fn"><a name="toUpper"></a>QByteArray QByteArray::toUpper () const</h3>

910

984

Returns an uppercase copy of the byte array. The bytearray is interpreted as a Latin-1 encoded string.

911

985

Example:

912

<pre> QByteArray x("TROlltECH");

986

<pre> QByteArray x("Qt by NOKIA");

913

987

QByteArray y = x.toUpper();

914

// y == "TROLLTECH"</pre>

988

// y == "QT BY NOKIA"</pre>

915

989

See also <a href="qbytearray.html#toLower">toLower</a>() and <a href="qbytearray.html#8-bit-character-comparisons">8-bit Character Comparisons</a>.

990

916

991

<h3 class="fn"><a name="trimmed"></a>QByteArray QByteArray::trimmed () const</h3>

917

992

Returns a byte array that has whitespace removed from the start and the end.

918

993

Whitespace means any character for which the standard C++ isspace() function returns true. This includes the ASCII characters '\t', '\n', '\v', '\f', '\r', and ' '.

922

997

// ba == "lots\t of\nwhitespace";</pre>

923

998

Unlike <a href="qbytearray.html#simplified">simplified</a>(), trimmed() leaves internal whitespace alone.

924

999

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

1000

925

1001

<h3 class="fn"><a name="truncate"></a>void QByteArray::truncate ( int pos )</h3>

926

1002

Truncates the byte array at index position pos.

927

1003

If pos is beyond the end of the array, nothing happens.

929

1005

<pre> QByteArray ba("Stockholm");

930

1006

ba.truncate(5); // ba == "Stock"</pre>

931

1007

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

1008

932

1009

<h3 class="fn"><a name="operator-const-char--2a"></a>QByteArray::operator const char * () const</h3>

933

1010

934

1011

This operator is mostly useful to pass a byte array to a function that accepts a <tt>const char *</tt>.

935

1012

You can disable this operator by defining <tt>QT_NO_CAST_FROM_BYTEARRAY</tt> when you compile your applications.

936

1013

937

1014

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

1015

938

1016

<h3 class="fn"><a name="operator-const-void--2a"></a>QByteArray::operator const void * () const</h3>

939

1017

940

1018

This operator is mostly useful to pass a byte array to a function that accepts a <tt>const char *</tt>.

941

1019

You can disable this operator by defining <tt>QT_NO_CAST_FROM_BYTEARRAY</tt> when you compile your applications.

942

1020

943

1021

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

1022

944

1023

<h3 class="fn"><a name="operator-not-eq"></a>bool QByteArray::operator!= ( const <a href="qstring.html">QString</a> & str ) const</h3>

945

1024

Returns true if this byte array is not equal to string str; otherwise returns false.

946

1025

The Unicode data is converted into 8-bit characters using <a href="qstring.html#toAscii">QString::toAscii</a>().

947

1026

The comparison is case sensitive.

948

1027

You can disable this operator by defining <tt>QT_NO_CAST_FROM_ASCII</tt> when you compile your applications. You then need to call <a href="qstring.html#fromAscii">QString::fromAscii</a>(), <a href="qstring.html#fromLatin1">QString::fromLatin1</a>(), <a href="qstring.html#fromUtf8">QString::fromUtf8</a>(), or <a href="qstring.html#fromLocal8Bit">QString::fromLocal8Bit</a>() explicitly if you want to convert the byte array to a <a href="qstring.html">QString</a> before doing the comparison.

1028

949

1029

<h3 class="fn"><a name="operator-2b-eq"></a>QByteArray & QByteArray::operator+= ( const QByteArray & ba )</h3>

950

1030

Appends the byte array ba onto the end of this byte array and returns a reference to this byte array.

951

1031

Example:

965

1045

<h3 class="fn"><a name="operator-2b-eq-4"></a>QByteArray & QByteArray::operator+= ( char ch )</h3>

966

1046

This is an overloaded function.

967

1047

Appends the character ch onto the end of this byte array and returns a reference to this byte array.

1048

968

1049

<h3 class="fn"><a name="operator-lt"></a>bool QByteArray::operator< ( const <a href="qstring.html">QString</a> & str ) const</h3>

969

1050

Returns true if this byte array is lexically less than string str; otherwise returns false.

970

1051

The Unicode data is converted into 8-bit characters using <a href="qstring.html#toAscii">QString::toAscii</a>().

971

1052

The comparison is case sensitive.

972

1053

1054

973

1055

<h3 class="fn"><a name="operator-lt-eq"></a>bool QByteArray::operator<= ( const <a href="qstring.html">QString</a> & str ) const</h3>

974

1056

Returns true if this byte array is lexically less than or equal to string str; otherwise returns false.

975

1057

The Unicode data is converted into 8-bit characters using <a href="qstring.html#toAscii">QString::toAscii</a>().

976

1058

The comparison is case sensitive.

977

1059

1060

978

1061

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

979

1062

Assigns other to this byte array and returns a reference to this byte array.

980

1063

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

981

1064

This is an overloaded function.

982

1065

Assigns str to this byte array.

1066

983

1067

<h3 class="fn"><a name="operator-eq-eq"></a>bool QByteArray::operator== ( const <a href="qstring.html">QString</a> & str ) const</h3>

984

1068

Returns true if this byte array is equal to string str; otherwise returns false.

985

1069

The Unicode data is converted into 8-bit characters using <a href="qstring.html#toAscii">QString::toAscii</a>().

986

1070

The comparison is case sensitive.

987

1071

1072

988

1073

<h3 class="fn"><a name="operator-gt"></a>bool QByteArray::operator> ( const <a href="qstring.html">QString</a> & str ) const</h3>

989

1074

Returns true if this byte array is lexically greater than string str; otherwise returns false.

990

1075

The Unicode data is converted into 8-bit characters using <a href="qstring.html#toAscii">QString::toAscii</a>().

991

1076

The comparison is case sensitive.

992

1077

1078

993

1079

<h3 class="fn"><a name="operator-gt-eq"></a>bool QByteArray::operator>= ( const <a href="qstring.html">QString</a> & str ) const</h3>

994

1080

Returns true if this byte array is greater than or equal to string str; otherwise returns false.

995

1081

The Unicode data is converted into 8-bit characters using <a href="qstring.html#toAscii">QString::toAscii</a>().

996

1082

The comparison is case sensitive.

997

1083

1084

998

1085

<h3 class="fn"><a name="operator-5b-5d"></a>QByteRef QByteArray::operator[] ( int i )</h3>

999

1086

Returns the byte at index position i as a modifiable reference.

1000

1087

If an assignment is made beyond the end of the byte array, the array is extended with <a href="qbytearray.html#resize">resize</a>() before the assignment takes place.

1014

1101

This is an overloaded function.

1015

1102

<hr />

1016

1103

<h2>Related Non-Members</h2>

1104

1017

1105

<h3 class="fn"><a name="qChecksum"></a><a href="qtglobal.html#quint16-typedef">quint16</a> qChecksum ( const char * data, <a href="qtglobal.html#uint-typedef">uint</a> len )</h3>

1018

1106

Returns the CRC-16 checksum of the first len bytes of data.

1019

1107

The checksum is independent of the byte order (endianness).

1020

1108

Note: This function is a 16-bit cache conserving (16 entry table) implementation of the CRC-16-CCITT algorithm.

1109

1021

1110

<h3 class="fn"><a name="qCompress"></a>QByteArray qCompress ( const QByteArray & data, int compressionLevel = -1 )</h3>

1022

1111

Compresses the data byte array and returns the compressed data in a new byte array.

1023

1112

The compressionLevel parameter specifies how much compression should be used. Valid values are between 0 and 9, with 9 corresponding to the greatest compression (i.e. smaller compressed data) at the cost of using a slower algorithm. Smaller values (8, 7, ..., 1) provide successively less compression at slightly faster speeds. The value 0 corresponds to no compression at all. The default value is -1, which specifies zlib's default compression.

1025

1114

<h3 class="fn"><a name="qCompress-2"></a>QByteArray qCompress ( const <a href="qtglobal.html#uchar-typedef">uchar</a> * data, int nbytes, int compressionLevel = -1 )</h3>

1026

1115

This is an overloaded function.

1027

1116

Compresses the first nbytes of data and returns the compressed data in a new byte array.

1117

1028

1118

<h3 class="fn"><a name="qUncompress"></a>QByteArray qUncompress ( const QByteArray & data )</h3>

1029

1119

Uncompresses the data byte array and returns a new byte array with the uncompressed data.

1030

1120

Returns an empty <a href="qbytearray.html">QByteArray</a> if the input data was corrupt.

1034

1124

<h3 class="fn"><a name="qUncompress-2"></a>QByteArray qUncompress ( const <a href="qtglobal.html#uchar-typedef">uchar</a> * data, int nbytes )</h3>

1035

1125

This is an overloaded function.

1036

1126

Uncompresses the first nbytes of data and returns a new byte array with the uncompressed data.

1127

1037

1128

<h3 class="fn"><a name="qsnprintf"></a>int qsnprintf ( char * str, size_t n, const char * fmt, ... )</h3>

1038

1129

A portable snprintf() function, calls qvsnprintf.

1039

1130

fmt is the <tt>printf()</tt> format string. The result is put into str, which is a buffer of at least n bytes.

1040

1131

Warning: Call this function only when you know what you are doing since it shows different behavior on certain platforms. Use <a href="qstring.html#sprintf">QString::sprintf</a>() to format a string instead.

1041

1132

See also <a href="qbytearray.html#qvsnprintf">qvsnprintf</a>() and <a href="qstring.html#sprintf">QString::sprintf</a>().

1133

1042

1134

<h3 class="fn"><a name="qstrcmp"></a>int qstrcmp ( const char * str1, const char * str2 )</h3>

1043

1135

A safe <tt>strcmp()</tt> function.

1044

1136

Compares str1 and str2. Returns a negative value if str1 is less than str2, 0 if str1 is equal to str2 or a positive value if str1 is greater than str2.

1045

1137

Special case 1: Returns 0 if str1 and str2 are both 0.

1046

1138

Special case 2: Returns an arbitrary non-zero value if str1 is 0 or str2 is 0 (but not both).

1047

1139

See also <a href="qbytearray.html#qstrncmp">qstrncmp</a>(), <a href="qbytearray.html#qstricmp">qstricmp</a>(), <a href="qbytearray.html#qstrnicmp">qstrnicmp</a>(), and <a href="qbytearray.html#8-bit-character-comparisons">8-bit Character Comparisons</a>.

1140

1048

1141

<h3 class="fn"><a name="qstrcpy"></a>char * qstrcpy ( char * dst, const char * src )</h3>

1049

1142

Copies all the characters up to and including the '\0' from src into dst and returns a pointer to dst. If src is 0, it immediately returns 0.

1050

1143

This function assumes that dst is large enough to hold the contents of src.

1051

1144

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

1145

1052

1146

<h3 class="fn"><a name="qstrdup"></a>char * qstrdup ( const char * src )</h3>

1053

1147

Returns a duplicate string.

1054

1148

Allocates space for a copy of src, copies it, and returns a pointer to the copy. If src is 0, it immediately returns 0.

1055

1149

Ownership is passed to the caller, so the returned string must be deleted using <tt>delete[]</tt>.

1150

1056

1151

<h3 class="fn"><a name="qstricmp"></a>int qstricmp ( const char * str1, const char * str2 )</h3>

1057

1152

A safe <tt>stricmp()</tt> function.

1058

1153

Compares str1 and str2 ignoring the case of the characters. The encoding of the strings is assumed to be Latin-1.

1060

1155

Special case 1: Returns 0 if str1 and str2 are both 0.

1061

1156

Special case 2: Returns a random non-zero value if str1 is 0 or str2 is 0 (but not both).

1062

1157

See also <a href="qbytearray.html#qstrcmp">qstrcmp</a>(), <a href="qbytearray.html#qstrncmp">qstrncmp</a>(), <a href="qbytearray.html#qstrnicmp">qstrnicmp</a>(), and <a href="qbytearray.html#8-bit-character-comparisons">8-bit Character Comparisons</a>.

1158

1063

1159

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

1064

1160

A safe <tt>strlen()</tt> function.

1065

1161

Returns the number of characters that precede the terminating '\0', or 0 if str is 0.

1066

1162

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

1163

1067

1164

<h3 class="fn"><a name="qstrncmp"></a>int qstrncmp ( const char * str1, const char * str2, <a href="qtglobal.html#uint-typedef">uint</a> len )</h3>

1068

1165

A safe <tt>strncmp()</tt> function.

1069

1166

Compares at most len bytes of str1 and str2.

1071

1168

Special case 1: Returns 0 if str1 and str2 are both 0.

1072

1169

Special case 2: Returns a random non-zero value if str1 is 0 or str2 is 0 (but not both).

1073

1170

See also <a href="qbytearray.html#qstrcmp">qstrcmp</a>(), <a href="qbytearray.html#qstricmp">qstricmp</a>(), <a href="qbytearray.html#qstrnicmp">qstrnicmp</a>(), and <a href="qbytearray.html#8-bit-character-comparisons">8-bit Character Comparisons</a>.

1171

1074

1172

<h3 class="fn"><a name="qstrncpy"></a>char * qstrncpy ( char * dst, const char * src, <a href="qtglobal.html#uint-typedef">uint</a> len )</h3>

1075

1173

A safe <tt>strncpy()</tt> function.

1076

1174

Copies at most len bytes from src (stopping at len or the terminating '\0' whichever comes first) into dst and returns a pointer to dst. Guarantees that dst is '\0'-terminated. If src or dst is 0, returns 0 immediately.

1077

1175

This function assumes that dst is at least len characters long.

1078

1176

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

1177

1079

1178

<h3 class="fn"><a name="qstrnicmp"></a>int qstrnicmp ( const char * str1, const char * str2, <a href="qtglobal.html#uint-typedef">uint</a> len )</h3>

1080

1179

A safe <tt>strnicmp()</tt> function.

1081

1180

Compares at most len bytes of str1 and str2 ignoring the case of the characters. The encoding of the strings is assumed to be Latin-1.

1083

1182

Special case 1: Returns 0 if str1 and str2 are both 0.

1084

1183

Special case 2: Returns a random non-zero value if str1 is 0 or str2 is 0 (but not both).

1085

1184

See also <a href="qbytearray.html#qstrcmp">qstrcmp</a>(), <a href="qbytearray.html#qstrncmp">qstrncmp</a>(), <a href="qbytearray.html#qstricmp">qstricmp</a>(), and <a href="qbytearray.html#8-bit-character-comparisons">8-bit Character Comparisons</a>.

1185

1086

1186

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

1087

1187

A safe <tt>strnlen()</tt> function.

1088

1188

Returns the number of characters that precede the terminating '\0', but at most maxlen. If str is 0, returns 0.

1089

1189

This function was introduced in Qt 4.2.

1090

1190

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

1191

1091

1192

<h3 class="fn"><a name="qvsnprintf"></a>int qvsnprintf ( char * str, size_t n, const char * fmt, va_list ap )</h3>

1092

1193

A portable <tt>vsnprintf()</tt> function. Will call <tt>::vsnprintf()</tt>, <tt>::_vsnprintf()</tt>, or <tt>::vsnprintf_s</tt> depending on the system, or fall back to an internal version.

1093

1194

fmt is the <tt>printf()</tt> format string. The result is put into str, which is a buffer of at least n bytes.

1095

1196

Warning: Since vsnprintf() shows different behavior on certain platforms, you should not rely on the return value or on the fact that you will always get a 0 terminated string back.

1096

1197

Ideally, you should never call this function but use <a href="qstring.html#sprintf">QString::sprintf</a>() instead.

1097

1198

See also <a href="qbytearray.html#qsnprintf">qsnprintf</a>() and <a href="qstring.html#sprintf">QString::sprintf</a>().

1098

<h3 class="fn"><a name="operator-not-eq-52"></a>bool operator!= ( const QByteArray & a1, const QByteArray & a2 )</h3>

1199

<h3 class="fn"><a name="operator-not-eq-59"></a>bool operator!= ( const QByteArray & a1, const QByteArray & a2 )</h3>

1099

1200

This is an overloaded function.

1100

1201

Returns true if byte array a1 is not equal to byte array a2; otherwise returns false.

1101

<h3 class="fn"><a name="operator-not-eq-53"></a>bool operator!= ( const QByteArray & a1, const char * a2 )</h3>

1202

<h3 class="fn"><a name="operator-not-eq-60"></a>bool operator!= ( const QByteArray & a1, const char * a2 )</h3>

1102

1203

This is an overloaded function.

1103

1204

Returns true if byte array a1 is not equal to string a2; otherwise returns false.

1104

<h3 class="fn"><a name="operator-not-eq-54"></a>bool operator!= ( const char * a1, const QByteArray & a2 )</h3>

1205

<h3 class="fn"><a name="operator-not-eq-61"></a>bool operator!= ( const char * a1, const QByteArray & a2 )</h3>

1105

1206

This is an overloaded function.

1106

1207

Returns true if string a1 is not equal to byte array a2; otherwise returns false.

1107

<h3 class="fn"><a name="operator-2b-38"></a>const QByteArray operator+ ( const QByteArray & a1, const char * a2 )</h3>

1208

<h3 class="fn"><a name="operator-2b-40"></a>const QByteArray operator+ ( const QByteArray & a1, const char * a2 )</h3>

1108

1209

This is an overloaded function.

1109

1210

Returns a byte array that is the result of concatenating byte array a1 and string a2.

1110

<h3 class="fn"><a name="operator-2b-39"></a>const QByteArray operator+ ( const QByteArray & a1, char a2 )</h3>

1211

<h3 class="fn"><a name="operator-2b-41"></a>const QByteArray operator+ ( const QByteArray & a1, char a2 )</h3>

1111

1212

This is an overloaded function.

1112

1213

Returns a byte array that is the result of concatenating byte array a1 and character a2.

1113

<h3 class="fn"><a name="operator-2b-40"></a>const QByteArray operator+ ( const char * a1, const QByteArray & a2 )</h3>

1214

<h3 class="fn"><a name="operator-2b-42"></a>const QByteArray operator+ ( const char * a1, const QByteArray & a2 )</h3>

1114

1215

This is an overloaded function.

1115

1216

Returns a byte array that is the result of concatenating string a1 and byte array a2.

1116

<h3 class="fn"><a name="operator-2b-41"></a>const QByteArray operator+ ( char a1, const QByteArray & a2 )</h3>

1217

<h3 class="fn"><a name="operator-2b-43"></a>const QByteArray operator+ ( char a1, const QByteArray & a2 )</h3>

1117

1218

This is an overloaded function.

1118

1219

Returns a byte array that is the result of concatenating character a1 and byte array a2.

1119

<h3 class="fn"><a name="operator-2b-11"></a>const QByteArray operator+ ( const QByteArray & a1, const QByteArray & a2 )</h3>

1220

<h3 class="fn"><a name="operator-2b-17"></a>const QByteArray operator+ ( const QByteArray & a1, const QByteArray & a2 )</h3>

1120

1221

Returns a byte array that is the result of concatenating byte array a1 and byte array a2.

1121

1222

See also <a href="qbytearray.html#operator-2b-eq">QByteArray::operator+=</a>().

1122

<h3 class="fn"><a name="operator-lt-19"></a>bool operator< ( const QByteArray & a1, const QByteArray & a2 )</h3>

1223

<h3 class="fn"><a name="operator-lt-18"></a>bool operator< ( const QByteArray & a1, const QByteArray & a2 )</h3>

1123

1224

This is an overloaded function.

1124

1225

Returns true if byte array a1 is lexically less than byte array a2; otherwise returns false.

1125

<h3 class="fn"><a name="operator-lt-20"></a>bool operator< ( const QByteArray & a1, const char * a2 )</h3>

1226

<h3 class="fn"><a name="operator-lt-19"></a>bool operator< ( const QByteArray & a1, const char * a2 )</h3>

1126

1227

This is an overloaded function.

1127

1228

Returns true if byte array a1 is lexically less than string a2; otherwise returns false.

1128

<h3 class="fn"><a name="operator-lt-21"></a>bool operator< ( const char * a1, const QByteArray & a2 )</h3>

1229

<h3 class="fn"><a name="operator-lt-20"></a>bool operator< ( const char * a1, const QByteArray & a2 )</h3>

1129

1230

This is an overloaded function.

1130

1231

Returns true if string a1 is lexically less than byte array a2; otherwise returns false.

1131

<h3 class="fn"><a name="operator-lt-lt-92"></a><a href="qdatastream.html">QDataStream</a> & operator<< ( <a href="qdatastream.html">QDataStream</a> & out, const QByteArray & ba )</h3>

1232

<h3 class="fn"><a name="operator-lt-lt-141"></a><a href="qdatastream.html">QDataStream</a> & operator<< ( <a href="qdatastream.html">QDataStream</a> & out, const QByteArray & ba )</h3>

1132

1233

Writes byte array ba to the stream out and returns a reference to the stream.

1133

1234

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

1134

<h3 class="fn"><a name="operator-lt-eq-14"></a>bool operator<= ( const QByteArray & a1, const QByteArray & a2 )</h3>

1235

<h3 class="fn"><a name="operator-lt-eq-13"></a>bool operator<= ( const QByteArray & a1, const QByteArray & a2 )</h3>

1135

1236

This is an overloaded function.

1136

1237

Returns true if byte array a1 is lexically less than or equal to byte array a2; otherwise returns false.

1137

<h3 class="fn"><a name="operator-lt-eq-15"></a>bool operator<= ( const QByteArray & a1, const char * a2 )</h3>

1238

<h3 class="fn"><a name="operator-lt-eq-14"></a>bool operator<= ( const QByteArray & a1, const char * a2 )</h3>

1138

1239

This is an overloaded function.

1139

1240

Returns true if byte array a1 is lexically less than or equal to string a2; otherwise returns false.

1140

<h3 class="fn"><a name="operator-lt-eq-16"></a>bool operator<= ( const char * a1, const QByteArray & a2 )</h3>

1241

<h3 class="fn"><a name="operator-lt-eq-15"></a>bool operator<= ( const char * a1, const QByteArray & a2 )</h3>

1141

1242

This is an overloaded function.

1142

1243

Returns true if string a1 is lexically less than or equal to byte array a2; otherwise returns false.

1143

<h3 class="fn"><a name="operator-eq-eq-74"></a>bool operator== ( const QByteArray & a1, const QByteArray & a2 )</h3>

1244

<h3 class="fn"><a name="operator-eq-eq-82"></a>bool operator== ( const QByteArray & a1, const QByteArray & a2 )</h3>

1144

1245

This is an overloaded function.

1145

1246

Returns true if byte array a1 is equal to byte array a2; otherwise returns false.

1146

<h3 class="fn"><a name="operator-eq-eq-75"></a>bool operator== ( const QByteArray & a1, const char * a2 )</h3>

1247

<h3 class="fn"><a name="operator-eq-eq-83"></a>bool operator== ( const QByteArray & a1, const char * a2 )</h3>

1147

1248

This is an overloaded function.

1148

1249

Returns true if byte array a1 is equal to string a2; otherwise returns false.

1149

<h3 class="fn"><a name="operator-eq-eq-76"></a>bool operator== ( const char * a1, const QByteArray & a2 )</h3>

1250

<h3 class="fn"><a name="operator-eq-eq-84"></a>bool operator== ( const char * a1, const QByteArray & a2 )</h3>

1150

1251

This is an overloaded function.

1151

1252

Returns true if string a1 is equal to byte array a2; otherwise returns false.

1152

<h3 class="fn"><a name="operator-gt-14"></a>bool operator> ( const QByteArray & a1, const QByteArray & a2 )</h3>

1253

<h3 class="fn"><a name="operator-gt-13"></a>bool operator> ( const QByteArray & a1, const QByteArray & a2 )</h3>

1153

1254

This is an overloaded function.

1154

1255

Returns true if byte array a1 is lexically greater than byte array a2; otherwise returns false.

1155

<h3 class="fn"><a name="operator-gt-15"></a>bool operator> ( const QByteArray & a1, const char * a2 )</h3>

1256

<h3 class="fn"><a name="operator-gt-14"></a>bool operator> ( const QByteArray & a1, const char * a2 )</h3>

1156

1257

This is an overloaded function.

1157

1258

Returns true if byte array a1 is lexically greater than string a2; otherwise returns false.

1158

<h3 class="fn"><a name="operator-gt-16"></a>bool operator> ( const char * a1, const QByteArray & a2 )</h3>

1259

<h3 class="fn"><a name="operator-gt-15"></a>bool operator> ( const char * a1, const QByteArray & a2 )</h3>

1159

1260

This is an overloaded function.

1160

1261

Returns true if string a1 is lexically greater than byte array a2; otherwise returns false.

1161

<h3 class="fn"><a name="operator-gt-eq-14"></a>bool operator>= ( const QByteArray & a1, const QByteArray & a2 )</h3>

1262

<h3 class="fn"><a name="operator-gt-eq-13"></a>bool operator>= ( const QByteArray & a1, const QByteArray & a2 )</h3>

1162

1263

This is an overloaded function.

1163

1264

Returns true if byte array a1 is lexically greater than or equal to byte array a2; otherwise returns false.

1164

<h3 class="fn"><a name="operator-gt-eq-15"></a>bool operator>= ( const QByteArray & a1, const char * a2 )</h3>

1265

<h3 class="fn"><a name="operator-gt-eq-14"></a>bool operator>= ( const QByteArray & a1, const char * a2 )</h3>

1165

1266

This is an overloaded function.

1166

1267

Returns true if byte array a1 is lexically greater than or equal to string a2; otherwise returns false.

1167

<h3 class="fn"><a name="operator-gt-eq-16"></a>bool operator>= ( const char * a1, const QByteArray & a2 )</h3>

1268

<h3 class="fn"><a name="operator-gt-eq-15"></a>bool operator>= ( const char * a1, const QByteArray & a2 )</h3>

1168

1269

This is an overloaded function.

1169

1270

Returns true if string a1 is lexically greater than or equal to byte array a2; otherwise returns false.

1170

<h3 class="fn"><a name="operator-gt-gt-54"></a><a href="qdatastream.html">QDataStream</a> & operator>> ( <a href="qdatastream.html">QDataStream</a> & in, QByteArray & ba )</h3>

1271

<h3 class="fn"><a name="operator-gt-gt-75"></a><a href="qdatastream.html">QDataStream</a> & operator>> ( <a href="qdatastream.html">QDataStream</a> & in, QByteArray & ba )</h3>

1171

1272

Reads a byte array into ba from the stream in and returns a reference to the stream.

1172

1273

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

1173

1274

<hr />

1174

1275

<h2>Macro Documentation</h2>

1276

1175

1277

<h3 class="fn"><a name="QT_NO_CAST_FROM_BYTEARRAY"></a>QT_NO_CAST_FROM_BYTEARRAY</h3>

1176

1278

Disables automatic conversions from <a href="qbytearray.html">QByteArray</a> to const char * or const void *.

1177

1279

See also <a href="qstring.html#QT_NO_CAST_TO_ASCII">QT_NO_CAST_TO_ASCII</a> and <a href="qstring.html#QT_NO_CAST_FROM_ASCII">QT_NO_CAST_FROM_ASCII</a>.

1178

1280

1179

1281

1180

1181

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

1182

1183

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

1282

1283

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

1284

1285

1184

1286

</html>

Older »