Absolute File Name: | /home/qt/qt5_coco/qt5/qtbase/src/corelib/io/qdatastream.cpp |
Source code | Switch to Preprocessed file |
Line | Source | Count | ||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
1 | /**************************************************************************** | - | ||||||||||||||||||||||||
2 | ** | - | ||||||||||||||||||||||||
3 | ** Copyright (C) 2016 The Qt Company Ltd. | - | ||||||||||||||||||||||||
4 | ** Contact: https://www.qt.io/licensing/ | - | ||||||||||||||||||||||||
5 | ** | - | ||||||||||||||||||||||||
6 | ** This file is part of the QtCore module of the Qt Toolkit. | - | ||||||||||||||||||||||||
7 | ** | - | ||||||||||||||||||||||||
8 | ** $QT_BEGIN_LICENSE:LGPL$ | - | ||||||||||||||||||||||||
9 | ** Commercial License Usage | - | ||||||||||||||||||||||||
10 | ** Licensees holding valid commercial Qt licenses may use this file in | - | ||||||||||||||||||||||||
11 | ** accordance with the commercial license agreement provided with the | - | ||||||||||||||||||||||||
12 | ** Software or, alternatively, in accordance with the terms contained in | - | ||||||||||||||||||||||||
13 | ** a written agreement between you and The Qt Company. For licensing terms | - | ||||||||||||||||||||||||
14 | ** and conditions see https://www.qt.io/terms-conditions. For further | - | ||||||||||||||||||||||||
15 | ** information use the contact form at https://www.qt.io/contact-us. | - | ||||||||||||||||||||||||
16 | ** | - | ||||||||||||||||||||||||
17 | ** GNU Lesser General Public License Usage | - | ||||||||||||||||||||||||
18 | ** Alternatively, this file may be used under the terms of the GNU Lesser | - | ||||||||||||||||||||||||
19 | ** General Public License version 3 as published by the Free Software | - | ||||||||||||||||||||||||
20 | ** Foundation and appearing in the file LICENSE.LGPL3 included in the | - | ||||||||||||||||||||||||
21 | ** packaging of this file. Please review the following information to | - | ||||||||||||||||||||||||
22 | ** ensure the GNU Lesser General Public License version 3 requirements | - | ||||||||||||||||||||||||
23 | ** will be met: https://www.gnu.org/licenses/lgpl-3.0.html. | - | ||||||||||||||||||||||||
24 | ** | - | ||||||||||||||||||||||||
25 | ** GNU General Public License Usage | - | ||||||||||||||||||||||||
26 | ** Alternatively, this file may be used under the terms of the GNU | - | ||||||||||||||||||||||||
27 | ** General Public License version 2.0 or (at your option) the GNU General | - | ||||||||||||||||||||||||
28 | ** Public license version 3 or any later version approved by the KDE Free | - | ||||||||||||||||||||||||
29 | ** Qt Foundation. The licenses are as published by the Free Software | - | ||||||||||||||||||||||||
30 | ** Foundation and appearing in the file LICENSE.GPL2 and LICENSE.GPL3 | - | ||||||||||||||||||||||||
31 | ** included in the packaging of this file. Please review the following | - | ||||||||||||||||||||||||
32 | ** information to ensure the GNU General Public License requirements will | - | ||||||||||||||||||||||||
33 | ** be met: https://www.gnu.org/licenses/gpl-2.0.html and | - | ||||||||||||||||||||||||
34 | ** https://www.gnu.org/licenses/gpl-3.0.html. | - | ||||||||||||||||||||||||
35 | ** | - | ||||||||||||||||||||||||
36 | ** $QT_END_LICENSE$ | - | ||||||||||||||||||||||||
37 | ** | - | ||||||||||||||||||||||||
38 | ****************************************************************************/ | - | ||||||||||||||||||||||||
39 | - | |||||||||||||||||||||||||
40 | #include "qdatastream.h" | - | ||||||||||||||||||||||||
41 | #include "qdatastream_p.h" | - | ||||||||||||||||||||||||
42 | - | |||||||||||||||||||||||||
43 | #if !defined(QT_NO_DATASTREAM) || defined(QT_BOOTSTRAPPED) | - | ||||||||||||||||||||||||
44 | #include "qbuffer.h" | - | ||||||||||||||||||||||||
45 | #include "qstring.h" | - | ||||||||||||||||||||||||
46 | #include <stdio.h> | - | ||||||||||||||||||||||||
47 | #include <ctype.h> | - | ||||||||||||||||||||||||
48 | #include <stdlib.h> | - | ||||||||||||||||||||||||
49 | #include "qendian.h" | - | ||||||||||||||||||||||||
50 | - | |||||||||||||||||||||||||
51 | QT_BEGIN_NAMESPACE | - | ||||||||||||||||||||||||
52 | - | |||||||||||||||||||||||||
53 | /*! | - | ||||||||||||||||||||||||
54 | \class QDataStream | - | ||||||||||||||||||||||||
55 | \inmodule QtCore | - | ||||||||||||||||||||||||
56 | \reentrant | - | ||||||||||||||||||||||||
57 | \brief The QDataStream class provides serialization of binary data | - | ||||||||||||||||||||||||
58 | to a QIODevice. | - | ||||||||||||||||||||||||
59 | - | |||||||||||||||||||||||||
60 | \ingroup io | - | ||||||||||||||||||||||||
61 | - | |||||||||||||||||||||||||
62 | - | |||||||||||||||||||||||||
63 | A data stream is a binary stream of encoded information which is | - | ||||||||||||||||||||||||
64 | 100% independent of the host computer's operating system, CPU or | - | ||||||||||||||||||||||||
65 | byte order. For example, a data stream that is written by a PC | - | ||||||||||||||||||||||||
66 | under Windows can be read by a Sun SPARC running Solaris. | - | ||||||||||||||||||||||||
67 | - | |||||||||||||||||||||||||
68 | You can also use a data stream to read/write \l{raw}{raw | - | ||||||||||||||||||||||||
69 | unencoded binary data}. If you want a "parsing" input stream, see | - | ||||||||||||||||||||||||
70 | QTextStream. | - | ||||||||||||||||||||||||
71 | - | |||||||||||||||||||||||||
72 | The QDataStream class implements the serialization of C++'s basic | - | ||||||||||||||||||||||||
73 | data types, like \c char, \c short, \c int, \c{char *}, etc. | - | ||||||||||||||||||||||||
74 | Serialization of more complex data is accomplished by breaking up | - | ||||||||||||||||||||||||
75 | the data into primitive units. | - | ||||||||||||||||||||||||
76 | - | |||||||||||||||||||||||||
77 | A data stream cooperates closely with a QIODevice. A QIODevice | - | ||||||||||||||||||||||||
78 | represents an input/output medium one can read data from and write | - | ||||||||||||||||||||||||
79 | data to. The QFile class is an example of an I/O device. | - | ||||||||||||||||||||||||
80 | - | |||||||||||||||||||||||||
81 | Example (write binary data to a stream): | - | ||||||||||||||||||||||||
82 | - | |||||||||||||||||||||||||
83 | \snippet code/src_corelib_io_qdatastream.cpp 0 | - | ||||||||||||||||||||||||
84 | - | |||||||||||||||||||||||||
85 | Example (read binary data from a stream): | - | ||||||||||||||||||||||||
86 | - | |||||||||||||||||||||||||
87 | \snippet code/src_corelib_io_qdatastream.cpp 1 | - | ||||||||||||||||||||||||
88 | - | |||||||||||||||||||||||||
89 | Each item written to the stream is written in a predefined binary | - | ||||||||||||||||||||||||
90 | format that varies depending on the item's type. Supported Qt | - | ||||||||||||||||||||||||
91 | types include QBrush, QColor, QDateTime, QFont, QPixmap, QString, | - | ||||||||||||||||||||||||
92 | QVariant and many others. For the complete list of all Qt types | - | ||||||||||||||||||||||||
93 | supporting data streaming see \l{Serializing Qt Data Types}. | - | ||||||||||||||||||||||||
94 | - | |||||||||||||||||||||||||
95 | For integers it is best to always cast to a Qt integer type for | - | ||||||||||||||||||||||||
96 | writing, and to read back into the same Qt integer type. This | - | ||||||||||||||||||||||||
97 | ensures that you get integers of the size you want and insulates | - | ||||||||||||||||||||||||
98 | you from compiler and platform differences. | - | ||||||||||||||||||||||||
99 | - | |||||||||||||||||||||||||
100 | To take one example, a \c{char *} string is written as a 32-bit | - | ||||||||||||||||||||||||
101 | integer equal to the length of the string including the '\\0' byte, | - | ||||||||||||||||||||||||
102 | followed by all the characters of the string including the | - | ||||||||||||||||||||||||
103 | '\\0' byte. When reading a \c{char *} string, 4 bytes are read to | - | ||||||||||||||||||||||||
104 | create the 32-bit length value, then that many characters for the | - | ||||||||||||||||||||||||
105 | \c {char *} string including the '\\0' terminator are read. | - | ||||||||||||||||||||||||
106 | - | |||||||||||||||||||||||||
107 | The initial I/O device is usually set in the constructor, but can be | - | ||||||||||||||||||||||||
108 | changed with setDevice(). If you've reached the end of the data | - | ||||||||||||||||||||||||
109 | (or if there is no I/O device set) atEnd() will return true. | - | ||||||||||||||||||||||||
110 | - | |||||||||||||||||||||||||
111 | \section1 Versioning | - | ||||||||||||||||||||||||
112 | - | |||||||||||||||||||||||||
113 | QDataStream's binary format has evolved since Qt 1.0, and is | - | ||||||||||||||||||||||||
114 | likely to continue evolving to reflect changes done in Qt. When | - | ||||||||||||||||||||||||
115 | inputting or outputting complex types, it's very important to | - | ||||||||||||||||||||||||
116 | make sure that the same version of the stream (version()) is used | - | ||||||||||||||||||||||||
117 | for reading and writing. If you need both forward and backward | - | ||||||||||||||||||||||||
118 | compatibility, you can hardcode the version number in the | - | ||||||||||||||||||||||||
119 | application: | - | ||||||||||||||||||||||||
120 | - | |||||||||||||||||||||||||
121 | \snippet code/src_corelib_io_qdatastream.cpp 2 | - | ||||||||||||||||||||||||
122 | - | |||||||||||||||||||||||||
123 | If you are producing a new binary data format, such as a file | - | ||||||||||||||||||||||||
124 | format for documents created by your application, you could use a | - | ||||||||||||||||||||||||
125 | QDataStream to write the data in a portable format. Typically, you | - | ||||||||||||||||||||||||
126 | would write a brief header containing a magic string and a version | - | ||||||||||||||||||||||||
127 | number to give yourself room for future expansion. For example: | - | ||||||||||||||||||||||||
128 | - | |||||||||||||||||||||||||
129 | \snippet code/src_corelib_io_qdatastream.cpp 3 | - | ||||||||||||||||||||||||
130 | - | |||||||||||||||||||||||||
131 | Then read it in with: | - | ||||||||||||||||||||||||
132 | - | |||||||||||||||||||||||||
133 | \snippet code/src_corelib_io_qdatastream.cpp 4 | - | ||||||||||||||||||||||||
134 | - | |||||||||||||||||||||||||
135 | You can select which byte order to use when serializing data. The | - | ||||||||||||||||||||||||
136 | default setting is big endian (MSB first). Changing it to little | - | ||||||||||||||||||||||||
137 | endian breaks the portability (unless the reader also changes to | - | ||||||||||||||||||||||||
138 | little endian). We recommend keeping this setting unless you have | - | ||||||||||||||||||||||||
139 | special requirements. | - | ||||||||||||||||||||||||
140 | - | |||||||||||||||||||||||||
141 | \target raw | - | ||||||||||||||||||||||||
142 | \section1 Reading and Writing Raw Binary Data | - | ||||||||||||||||||||||||
143 | - | |||||||||||||||||||||||||
144 | You may wish to read/write your own raw binary data to/from the | - | ||||||||||||||||||||||||
145 | data stream directly. Data may be read from the stream into a | - | ||||||||||||||||||||||||
146 | preallocated \c{char *} using readRawData(). Similarly data can be | - | ||||||||||||||||||||||||
147 | written to the stream using writeRawData(). Note that any | - | ||||||||||||||||||||||||
148 | encoding/decoding of the data must be done by you. | - | ||||||||||||||||||||||||
149 | - | |||||||||||||||||||||||||
150 | A similar pair of functions is readBytes() and writeBytes(). These | - | ||||||||||||||||||||||||
151 | differ from their \e raw counterparts as follows: readBytes() | - | ||||||||||||||||||||||||
152 | reads a quint32 which is taken to be the length of the data to be | - | ||||||||||||||||||||||||
153 | read, then that number of bytes is read into the preallocated | - | ||||||||||||||||||||||||
154 | \c{char *}; writeBytes() writes a quint32 containing the length of the | - | ||||||||||||||||||||||||
155 | data, followed by the data. Note that any encoding/decoding of | - | ||||||||||||||||||||||||
156 | the data (apart from the length quint32) must be done by you. | - | ||||||||||||||||||||||||
157 | - | |||||||||||||||||||||||||
158 | \section1 Reading and Writing Qt Collection Classes | - | ||||||||||||||||||||||||
159 | - | |||||||||||||||||||||||||
160 | The Qt container classes can also be serialized to a QDataStream. | - | ||||||||||||||||||||||||
161 | These include QList, QLinkedList, QVector, QSet, QHash, and QMap. | - | ||||||||||||||||||||||||
162 | The stream operators are declared as non-members of the classes. | - | ||||||||||||||||||||||||
163 | - | |||||||||||||||||||||||||
164 | \target Serializing Qt Classes | - | ||||||||||||||||||||||||
165 | \section1 Reading and Writing Other Qt Classes | - | ||||||||||||||||||||||||
166 | - | |||||||||||||||||||||||||
167 | In addition to the overloaded stream operators documented here, | - | ||||||||||||||||||||||||
168 | any Qt classes that you might want to serialize to a QDataStream | - | ||||||||||||||||||||||||
169 | will have appropriate stream operators declared as non-member of | - | ||||||||||||||||||||||||
170 | the class: | - | ||||||||||||||||||||||||
171 | - | |||||||||||||||||||||||||
172 | \code | - | ||||||||||||||||||||||||
173 | QDataStream &operator<<(QDataStream &, const QXxx &); | - | ||||||||||||||||||||||||
174 | QDataStream &operator>>(QDataStream &, QXxx &); | - | ||||||||||||||||||||||||
175 | \endcode | - | ||||||||||||||||||||||||
176 | - | |||||||||||||||||||||||||
177 | For example, here are the stream operators declared as non-members | - | ||||||||||||||||||||||||
178 | of the QImage class: | - | ||||||||||||||||||||||||
179 | - | |||||||||||||||||||||||||
180 | \code | - | ||||||||||||||||||||||||
181 | QDataStream & operator<< (QDataStream& stream, const QImage& image); | - | ||||||||||||||||||||||||
182 | QDataStream & operator>> (QDataStream& stream, QImage& image); | - | ||||||||||||||||||||||||
183 | \endcode | - | ||||||||||||||||||||||||
184 | - | |||||||||||||||||||||||||
185 | To see if your favorite Qt class has similar stream operators | - | ||||||||||||||||||||||||
186 | defined, check the \b {Related Non-Members} section of the | - | ||||||||||||||||||||||||
187 | class's documentation page. | - | ||||||||||||||||||||||||
188 | - | |||||||||||||||||||||||||
189 | \section1 Using Read Transactions | - | ||||||||||||||||||||||||
190 | - | |||||||||||||||||||||||||
191 | When a data stream operates on an asynchronous device, the chunks of data | - | ||||||||||||||||||||||||
192 | can arrive at arbitrary points in time. The QDataStream class implements | - | ||||||||||||||||||||||||
193 | a transaction mechanism that provides the ability to read the data | - | ||||||||||||||||||||||||
194 | atomically with a series of stream operators. As an example, you can | - | ||||||||||||||||||||||||
195 | handle incomplete reads from a socket by using a transaction in a slot | - | ||||||||||||||||||||||||
196 | connected to the readyRead() signal: | - | ||||||||||||||||||||||||
197 | - | |||||||||||||||||||||||||
198 | \snippet code/src_corelib_io_qdatastream.cpp 6 | - | ||||||||||||||||||||||||
199 | - | |||||||||||||||||||||||||
200 | If no full packet is received, this code restores the stream to the | - | ||||||||||||||||||||||||
201 | initial position, after which you need to wait for more data to arrive. | - | ||||||||||||||||||||||||
202 | - | |||||||||||||||||||||||||
203 | \sa QTextStream, QVariant | - | ||||||||||||||||||||||||
204 | */ | - | ||||||||||||||||||||||||
205 | - | |||||||||||||||||||||||||
206 | /*! | - | ||||||||||||||||||||||||
207 | \enum QDataStream::ByteOrder | - | ||||||||||||||||||||||||
208 | - | |||||||||||||||||||||||||
209 | The byte order used for reading/writing the data. | - | ||||||||||||||||||||||||
210 | - | |||||||||||||||||||||||||
211 | \value BigEndian Most significant byte first (the default) | - | ||||||||||||||||||||||||
212 | \value LittleEndian Least significant byte first | - | ||||||||||||||||||||||||
213 | */ | - | ||||||||||||||||||||||||
214 | - | |||||||||||||||||||||||||
215 | /*! | - | ||||||||||||||||||||||||
216 | \enum QDataStream::FloatingPointPrecision | - | ||||||||||||||||||||||||
217 | - | |||||||||||||||||||||||||
218 | The precision of floating point numbers used for reading/writing the data. This will only have | - | ||||||||||||||||||||||||
219 | an effect if the version of the data stream is Qt_4_6 or higher. | - | ||||||||||||||||||||||||
220 | - | |||||||||||||||||||||||||
221 | \warning The floating point precision must be set to the same value on the object that writes | - | ||||||||||||||||||||||||
222 | and the object that reads the data stream. | - | ||||||||||||||||||||||||
223 | - | |||||||||||||||||||||||||
224 | \value SinglePrecision All floating point numbers in the data stream have 32-bit precision. | - | ||||||||||||||||||||||||
225 | \value DoublePrecision All floating point numbers in the data stream have 64-bit precision. | - | ||||||||||||||||||||||||
226 | - | |||||||||||||||||||||||||
227 | \sa setFloatingPointPrecision(), floatingPointPrecision() | - | ||||||||||||||||||||||||
228 | */ | - | ||||||||||||||||||||||||
229 | - | |||||||||||||||||||||||||
230 | /*! | - | ||||||||||||||||||||||||
231 | \enum QDataStream::Status | - | ||||||||||||||||||||||||
232 | - | |||||||||||||||||||||||||
233 | This enum describes the current status of the data stream. | - | ||||||||||||||||||||||||
234 | - | |||||||||||||||||||||||||
235 | \value Ok The data stream is operating normally. | - | ||||||||||||||||||||||||
236 | \value ReadPastEnd The data stream has read past the end of the | - | ||||||||||||||||||||||||
237 | data in the underlying device. | - | ||||||||||||||||||||||||
238 | \value ReadCorruptData The data stream has read corrupt data. | - | ||||||||||||||||||||||||
239 | \value WriteFailed The data stream cannot write to the underlying device. | - | ||||||||||||||||||||||||
240 | */ | - | ||||||||||||||||||||||||
241 | - | |||||||||||||||||||||||||
242 | /***************************************************************************** | - | ||||||||||||||||||||||||
243 | QDataStream member functions | - | ||||||||||||||||||||||||
244 | *****************************************************************************/ | - | ||||||||||||||||||||||||
245 | - | |||||||||||||||||||||||||
246 | #define Q_VOID | - | ||||||||||||||||||||||||
247 | - | |||||||||||||||||||||||||
248 | #undef CHECK_STREAM_PRECOND | - | ||||||||||||||||||||||||
249 | #ifndef QT_NO_DEBUG | - | ||||||||||||||||||||||||
250 | #define CHECK_STREAM_PRECOND(retVal) \ | - | ||||||||||||||||||||||||
251 | if (!dev) { \ | - | ||||||||||||||||||||||||
252 | qWarning("QDataStream: No device"); \ | - | ||||||||||||||||||||||||
253 | return retVal; \ | - | ||||||||||||||||||||||||
254 | } | - | ||||||||||||||||||||||||
255 | #else | - | ||||||||||||||||||||||||
256 | #define CHECK_STREAM_PRECOND(retVal) \ | - | ||||||||||||||||||||||||
257 | if (!dev) { \ | - | ||||||||||||||||||||||||
258 | return retVal; \ | - | ||||||||||||||||||||||||
259 | } | - | ||||||||||||||||||||||||
260 | #endif | - | ||||||||||||||||||||||||
261 | - | |||||||||||||||||||||||||
262 | #define CHECK_STREAM_WRITE_PRECOND(retVal) \ | - | ||||||||||||||||||||||||
263 | CHECK_STREAM_PRECOND(retVal) \ | - | ||||||||||||||||||||||||
264 | if (q_status != Ok) \ | - | ||||||||||||||||||||||||
265 | return retVal; | - | ||||||||||||||||||||||||
266 | - | |||||||||||||||||||||||||
267 | #define CHECK_STREAM_TRANSACTION_PRECOND(retVal) \ | - | ||||||||||||||||||||||||
268 | if (!d || d->transactionDepth == 0) { \ | - | ||||||||||||||||||||||||
269 | qWarning("QDataStream: No transaction in progress"); \ | - | ||||||||||||||||||||||||
270 | return retVal; \ | - | ||||||||||||||||||||||||
271 | } | - | ||||||||||||||||||||||||
272 | - | |||||||||||||||||||||||||
273 | /*! | - | ||||||||||||||||||||||||
274 | Constructs a data stream that has no I/O device. | - | ||||||||||||||||||||||||
275 | - | |||||||||||||||||||||||||
276 | \sa setDevice() | - | ||||||||||||||||||||||||
277 | */ | - | ||||||||||||||||||||||||
278 | - | |||||||||||||||||||||||||
279 | QDataStream::QDataStream() | - | ||||||||||||||||||||||||
280 | { | - | ||||||||||||||||||||||||
281 | dev = 0; | - | ||||||||||||||||||||||||
282 | owndev = false; | - | ||||||||||||||||||||||||
283 | byteorder = BigEndian; | - | ||||||||||||||||||||||||
284 | ver = Qt_DefaultCompiledVersion; | - | ||||||||||||||||||||||||
285 | noswap = QSysInfo::ByteOrder == QSysInfo::BigEndian; | - | ||||||||||||||||||||||||
286 | q_status = Ok; | - | ||||||||||||||||||||||||
287 | } | - | ||||||||||||||||||||||||
288 | - | |||||||||||||||||||||||||
289 | /*! | - | ||||||||||||||||||||||||
290 | Constructs a data stream that uses the I/O device \a d. | - | ||||||||||||||||||||||||
291 | - | |||||||||||||||||||||||||
292 | \sa setDevice(), device() | - | ||||||||||||||||||||||||
293 | */ | - | ||||||||||||||||||||||||
294 | - | |||||||||||||||||||||||||
295 | QDataStream::QDataStream(QIODevice *d) | - | ||||||||||||||||||||||||
296 | { | - | ||||||||||||||||||||||||
297 | dev = d; // set device | - | ||||||||||||||||||||||||
298 | owndev = false; | - | ||||||||||||||||||||||||
299 | byteorder = BigEndian; // default byte order | - | ||||||||||||||||||||||||
300 | ver = Qt_DefaultCompiledVersion; | - | ||||||||||||||||||||||||
301 | noswap = QSysInfo::ByteOrder == QSysInfo::BigEndian; | - | ||||||||||||||||||||||||
302 | q_status = Ok; | - | ||||||||||||||||||||||||
303 | } | - | ||||||||||||||||||||||||
304 | - | |||||||||||||||||||||||||
305 | /*! | - | ||||||||||||||||||||||||
306 | \fn QDataStream::QDataStream(QByteArray *a, QIODevice::OpenMode mode) | - | ||||||||||||||||||||||||
307 | - | |||||||||||||||||||||||||
308 | Constructs a data stream that operates on a byte array, \a a. The | - | ||||||||||||||||||||||||
309 | \a mode describes how the device is to be used. | - | ||||||||||||||||||||||||
310 | - | |||||||||||||||||||||||||
311 | Alternatively, you can use QDataStream(const QByteArray &) if you | - | ||||||||||||||||||||||||
312 | just want to read from a byte array. | - | ||||||||||||||||||||||||
313 | - | |||||||||||||||||||||||||
314 | Since QByteArray is not a QIODevice subclass, internally a QBuffer | - | ||||||||||||||||||||||||
315 | is created to wrap the byte array. | - | ||||||||||||||||||||||||
316 | */ | - | ||||||||||||||||||||||||
317 | - | |||||||||||||||||||||||||
318 | QDataStream::QDataStream(QByteArray *a, QIODevice::OpenMode flags) | - | ||||||||||||||||||||||||
319 | { | - | ||||||||||||||||||||||||
320 | QBuffer *buf = new QBuffer(a); | - | ||||||||||||||||||||||||
321 | #ifndef QT_NO_QOBJECT | - | ||||||||||||||||||||||||
322 | buf->blockSignals(true); | - | ||||||||||||||||||||||||
323 | #endif | - | ||||||||||||||||||||||||
324 | buf->open(flags); | - | ||||||||||||||||||||||||
325 | dev = buf; | - | ||||||||||||||||||||||||
326 | owndev = true; | - | ||||||||||||||||||||||||
327 | byteorder = BigEndian; | - | ||||||||||||||||||||||||
328 | ver = Qt_DefaultCompiledVersion; | - | ||||||||||||||||||||||||
329 | noswap = QSysInfo::ByteOrder == QSysInfo::BigEndian; | - | ||||||||||||||||||||||||
330 | q_status = Ok; | - | ||||||||||||||||||||||||
331 | } | - | ||||||||||||||||||||||||
332 | - | |||||||||||||||||||||||||
333 | /*! | - | ||||||||||||||||||||||||
334 | Constructs a read-only data stream that operates on byte array \a a. | - | ||||||||||||||||||||||||
335 | Use QDataStream(QByteArray*, int) if you want to write to a byte | - | ||||||||||||||||||||||||
336 | array. | - | ||||||||||||||||||||||||
337 | - | |||||||||||||||||||||||||
338 | Since QByteArray is not a QIODevice subclass, internally a QBuffer | - | ||||||||||||||||||||||||
339 | is created to wrap the byte array. | - | ||||||||||||||||||||||||
340 | */ | - | ||||||||||||||||||||||||
341 | QDataStream::QDataStream(const QByteArray &a) | - | ||||||||||||||||||||||||
342 | { | - | ||||||||||||||||||||||||
343 | QBuffer *buf = new QBuffer; | - | ||||||||||||||||||||||||
344 | #ifndef QT_NO_QOBJECT | - | ||||||||||||||||||||||||
345 | buf->blockSignals(true); | - | ||||||||||||||||||||||||
346 | #endif | - | ||||||||||||||||||||||||
347 | buf->setData(a); | - | ||||||||||||||||||||||||
348 | buf->open(QIODevice::ReadOnly); | - | ||||||||||||||||||||||||
349 | dev = buf; | - | ||||||||||||||||||||||||
350 | owndev = true; | - | ||||||||||||||||||||||||
351 | byteorder = BigEndian; | - | ||||||||||||||||||||||||
352 | ver = Qt_DefaultCompiledVersion; | - | ||||||||||||||||||||||||
353 | noswap = QSysInfo::ByteOrder == QSysInfo::BigEndian; | - | ||||||||||||||||||||||||
354 | q_status = Ok; | - | ||||||||||||||||||||||||
355 | } | - | ||||||||||||||||||||||||
356 | - | |||||||||||||||||||||||||
357 | /*! | - | ||||||||||||||||||||||||
358 | Destroys the data stream. | - | ||||||||||||||||||||||||
359 | - | |||||||||||||||||||||||||
360 | The destructor will not affect the current I/O device, unless it is | - | ||||||||||||||||||||||||
361 | an internal I/O device (e.g. a QBuffer) processing a QByteArray | - | ||||||||||||||||||||||||
362 | passed in the \e constructor, in which case the internal I/O device | - | ||||||||||||||||||||||||
363 | is destroyed. | - | ||||||||||||||||||||||||
364 | */ | - | ||||||||||||||||||||||||
365 | - | |||||||||||||||||||||||||
366 | QDataStream::~QDataStream() | - | ||||||||||||||||||||||||
367 | { | - | ||||||||||||||||||||||||
368 | if (owndev) | - | ||||||||||||||||||||||||
369 | delete dev; | - | ||||||||||||||||||||||||
370 | } | - | ||||||||||||||||||||||||
371 | - | |||||||||||||||||||||||||
372 | - | |||||||||||||||||||||||||
373 | /*! | - | ||||||||||||||||||||||||
374 | \fn QIODevice *QDataStream::device() const | - | ||||||||||||||||||||||||
375 | - | |||||||||||||||||||||||||
376 | Returns the I/O device currently set, or 0 if no | - | ||||||||||||||||||||||||
377 | device is currently set. | - | ||||||||||||||||||||||||
378 | - | |||||||||||||||||||||||||
379 | \sa setDevice() | - | ||||||||||||||||||||||||
380 | */ | - | ||||||||||||||||||||||||
381 | - | |||||||||||||||||||||||||
382 | /*! | - | ||||||||||||||||||||||||
383 | void QDataStream::setDevice(QIODevice *d) | - | ||||||||||||||||||||||||
384 | - | |||||||||||||||||||||||||
385 | Sets the I/O device to \a d, which can be 0 | - | ||||||||||||||||||||||||
386 | to unset to current I/O device. | - | ||||||||||||||||||||||||
387 | - | |||||||||||||||||||||||||
388 | \sa device() | - | ||||||||||||||||||||||||
389 | */ | - | ||||||||||||||||||||||||
390 | - | |||||||||||||||||||||||||
391 | void QDataStream::setDevice(QIODevice *d) | - | ||||||||||||||||||||||||
392 | { | - | ||||||||||||||||||||||||
393 | if (owndev) { | - | ||||||||||||||||||||||||
394 | delete dev; | - | ||||||||||||||||||||||||
395 | owndev = false; | - | ||||||||||||||||||||||||
396 | } | - | ||||||||||||||||||||||||
397 | dev = d; | - | ||||||||||||||||||||||||
398 | } | - | ||||||||||||||||||||||||
399 | - | |||||||||||||||||||||||||
400 | /*! | - | ||||||||||||||||||||||||
401 | \obsolete | - | ||||||||||||||||||||||||
402 | Unsets the I/O device. | - | ||||||||||||||||||||||||
403 | Use setDevice(0) instead. | - | ||||||||||||||||||||||||
404 | */ | - | ||||||||||||||||||||||||
405 | - | |||||||||||||||||||||||||
406 | void QDataStream::unsetDevice() | - | ||||||||||||||||||||||||
407 | { | - | ||||||||||||||||||||||||
408 | setDevice(0); | - | ||||||||||||||||||||||||
409 | } | - | ||||||||||||||||||||||||
410 | - | |||||||||||||||||||||||||
411 | - | |||||||||||||||||||||||||
412 | /*! | - | ||||||||||||||||||||||||
413 | \fn bool QDataStream::atEnd() const | - | ||||||||||||||||||||||||
414 | - | |||||||||||||||||||||||||
415 | Returns \c true if the I/O device has reached the end position (end of | - | ||||||||||||||||||||||||
416 | the stream or file) or if there is no I/O device set; otherwise | - | ||||||||||||||||||||||||
417 | returns \c false. | - | ||||||||||||||||||||||||
418 | - | |||||||||||||||||||||||||
419 | \sa QIODevice::atEnd() | - | ||||||||||||||||||||||||
420 | */ | - | ||||||||||||||||||||||||
421 | - | |||||||||||||||||||||||||
422 | bool QDataStream::atEnd() const | - | ||||||||||||||||||||||||
423 | { | - | ||||||||||||||||||||||||
424 | return dev ? dev->atEnd() : true; | - | ||||||||||||||||||||||||
425 | } | - | ||||||||||||||||||||||||
426 | - | |||||||||||||||||||||||||
427 | /*! | - | ||||||||||||||||||||||||
428 | Returns the floating point precision of the data stream. | - | ||||||||||||||||||||||||
429 | - | |||||||||||||||||||||||||
430 | \since 4.6 | - | ||||||||||||||||||||||||
431 | - | |||||||||||||||||||||||||
432 | \sa FloatingPointPrecision, setFloatingPointPrecision() | - | ||||||||||||||||||||||||
433 | */ | - | ||||||||||||||||||||||||
434 | QDataStream::FloatingPointPrecision QDataStream::floatingPointPrecision() const | - | ||||||||||||||||||||||||
435 | { | - | ||||||||||||||||||||||||
436 | return d == 0 ? QDataStream::DoublePrecision : d->floatingPointPrecision; | - | ||||||||||||||||||||||||
437 | } | - | ||||||||||||||||||||||||
438 | - | |||||||||||||||||||||||||
439 | /*! | - | ||||||||||||||||||||||||
440 | Sets the floating point precision of the data stream to \a precision. If the floating point precision is | - | ||||||||||||||||||||||||
441 | DoublePrecision and the version of the data stream is Qt_4_6 or higher, all floating point | - | ||||||||||||||||||||||||
442 | numbers will be written and read with 64-bit precision. If the floating point precision is | - | ||||||||||||||||||||||||
443 | SinglePrecision and the version is Qt_4_6 or higher, all floating point numbers will be written | - | ||||||||||||||||||||||||
444 | and read with 32-bit precision. | - | ||||||||||||||||||||||||
445 | - | |||||||||||||||||||||||||
446 | For versions prior to Qt_4_6, the precision of floating point numbers in the data stream depends | - | ||||||||||||||||||||||||
447 | on the stream operator called. | - | ||||||||||||||||||||||||
448 | - | |||||||||||||||||||||||||
449 | The default is DoublePrecision. | - | ||||||||||||||||||||||||
450 | - | |||||||||||||||||||||||||
451 | \warning This property must be set to the same value on the object that writes and the object | - | ||||||||||||||||||||||||
452 | that reads the data stream. | - | ||||||||||||||||||||||||
453 | - | |||||||||||||||||||||||||
454 | \since 4.6 | - | ||||||||||||||||||||||||
455 | */ | - | ||||||||||||||||||||||||
456 | void QDataStream::setFloatingPointPrecision(QDataStream::FloatingPointPrecision precision) | - | ||||||||||||||||||||||||
457 | { | - | ||||||||||||||||||||||||
458 | if (d == 0) | - | ||||||||||||||||||||||||
459 | d.reset(new QDataStreamPrivate()); | - | ||||||||||||||||||||||||
460 | d->floatingPointPrecision = precision; | - | ||||||||||||||||||||||||
461 | } | - | ||||||||||||||||||||||||
462 | - | |||||||||||||||||||||||||
463 | /*! | - | ||||||||||||||||||||||||
464 | Returns the status of the data stream. | - | ||||||||||||||||||||||||
465 | - | |||||||||||||||||||||||||
466 | \sa Status, setStatus(), resetStatus() | - | ||||||||||||||||||||||||
467 | */ | - | ||||||||||||||||||||||||
468 | - | |||||||||||||||||||||||||
469 | QDataStream::Status QDataStream::status() const | - | ||||||||||||||||||||||||
470 | { | - | ||||||||||||||||||||||||
471 | return q_status; | - | ||||||||||||||||||||||||
472 | } | - | ||||||||||||||||||||||||
473 | - | |||||||||||||||||||||||||
474 | /*! | - | ||||||||||||||||||||||||
475 | Resets the status of the data stream. | - | ||||||||||||||||||||||||
476 | - | |||||||||||||||||||||||||
477 | \sa Status, status(), setStatus() | - | ||||||||||||||||||||||||
478 | */ | - | ||||||||||||||||||||||||
479 | void QDataStream::resetStatus() | - | ||||||||||||||||||||||||
480 | { | - | ||||||||||||||||||||||||
481 | q_status = Ok; | - | ||||||||||||||||||||||||
482 | } | - | ||||||||||||||||||||||||
483 | - | |||||||||||||||||||||||||
484 | /*! | - | ||||||||||||||||||||||||
485 | Sets the status of the data stream to the \a status given. | - | ||||||||||||||||||||||||
486 | - | |||||||||||||||||||||||||
487 | Subsequent calls to setStatus() are ignored until resetStatus() | - | ||||||||||||||||||||||||
488 | is called. | - | ||||||||||||||||||||||||
489 | - | |||||||||||||||||||||||||
490 | \sa Status, status(), resetStatus() | - | ||||||||||||||||||||||||
491 | */ | - | ||||||||||||||||||||||||
492 | void QDataStream::setStatus(Status status) | - | ||||||||||||||||||||||||
493 | { | - | ||||||||||||||||||||||||
494 | if (q_status == Ok) | - | ||||||||||||||||||||||||
495 | q_status = status; | - | ||||||||||||||||||||||||
496 | } | - | ||||||||||||||||||||||||
497 | - | |||||||||||||||||||||||||
498 | /*! | - | ||||||||||||||||||||||||
499 | \fn int QDataStream::byteOrder() const | - | ||||||||||||||||||||||||
500 | - | |||||||||||||||||||||||||
501 | Returns the current byte order setting -- either BigEndian or | - | ||||||||||||||||||||||||
502 | LittleEndian. | - | ||||||||||||||||||||||||
503 | - | |||||||||||||||||||||||||
504 | \sa setByteOrder() | - | ||||||||||||||||||||||||
505 | */ | - | ||||||||||||||||||||||||
506 | - | |||||||||||||||||||||||||
507 | /*! | - | ||||||||||||||||||||||||
508 | Sets the serialization byte order to \a bo. | - | ||||||||||||||||||||||||
509 | - | |||||||||||||||||||||||||
510 | The \a bo parameter can be QDataStream::BigEndian or | - | ||||||||||||||||||||||||
511 | QDataStream::LittleEndian. | - | ||||||||||||||||||||||||
512 | - | |||||||||||||||||||||||||
513 | The default setting is big endian. We recommend leaving this | - | ||||||||||||||||||||||||
514 | setting unless you have special requirements. | - | ||||||||||||||||||||||||
515 | - | |||||||||||||||||||||||||
516 | \sa byteOrder() | - | ||||||||||||||||||||||||
517 | */ | - | ||||||||||||||||||||||||
518 | - | |||||||||||||||||||||||||
519 | void QDataStream::setByteOrder(ByteOrder bo) | - | ||||||||||||||||||||||||
520 | { | - | ||||||||||||||||||||||||
521 | byteorder = bo; | - | ||||||||||||||||||||||||
522 | if (QSysInfo::ByteOrder == QSysInfo::BigEndian) | - | ||||||||||||||||||||||||
523 | noswap = (byteorder == BigEndian); | - | ||||||||||||||||||||||||
524 | else | - | ||||||||||||||||||||||||
525 | noswap = (byteorder == LittleEndian); | - | ||||||||||||||||||||||||
526 | } | - | ||||||||||||||||||||||||
527 | - | |||||||||||||||||||||||||
528 | - | |||||||||||||||||||||||||
529 | /*! | - | ||||||||||||||||||||||||
530 | \enum QDataStream::Version | - | ||||||||||||||||||||||||
531 | - | |||||||||||||||||||||||||
532 | This enum provides symbolic synonyms for the data serialization | - | ||||||||||||||||||||||||
533 | format version numbers. | - | ||||||||||||||||||||||||
534 | - | |||||||||||||||||||||||||
535 | \value Qt_1_0 Version 1 (Qt 1.x) | - | ||||||||||||||||||||||||
536 | \value Qt_2_0 Version 2 (Qt 2.0) | - | ||||||||||||||||||||||||
537 | \value Qt_2_1 Version 3 (Qt 2.1, 2.2, 2.3) | - | ||||||||||||||||||||||||
538 | \value Qt_3_0 Version 4 (Qt 3.0) | - | ||||||||||||||||||||||||
539 | \value Qt_3_1 Version 5 (Qt 3.1, 3.2) | - | ||||||||||||||||||||||||
540 | \value Qt_3_3 Version 6 (Qt 3.3) | - | ||||||||||||||||||||||||
541 | \value Qt_4_0 Version 7 (Qt 4.0, Qt 4.1) | - | ||||||||||||||||||||||||
542 | \value Qt_4_1 Version 7 (Qt 4.0, Qt 4.1) | - | ||||||||||||||||||||||||
543 | \value Qt_4_2 Version 8 (Qt 4.2) | - | ||||||||||||||||||||||||
544 | \value Qt_4_3 Version 9 (Qt 4.3) | - | ||||||||||||||||||||||||
545 | \value Qt_4_4 Version 10 (Qt 4.4) | - | ||||||||||||||||||||||||
546 | \value Qt_4_5 Version 11 (Qt 4.5) | - | ||||||||||||||||||||||||
547 | \value Qt_4_6 Version 12 (Qt 4.6, Qt 4.7, Qt 4.8) | - | ||||||||||||||||||||||||
548 | \value Qt_4_7 Same as Qt_4_6. | - | ||||||||||||||||||||||||
549 | \value Qt_4_8 Same as Qt_4_6. | - | ||||||||||||||||||||||||
550 | \value Qt_4_9 Same as Qt_4_6. | - | ||||||||||||||||||||||||
551 | \value Qt_5_0 Version 13 (Qt 5.0) | - | ||||||||||||||||||||||||
552 | \value Qt_5_1 Version 14 (Qt 5.1) | - | ||||||||||||||||||||||||
553 | \value Qt_5_2 Version 15 (Qt 5.2) | - | ||||||||||||||||||||||||
554 | \value Qt_5_3 Same as Qt_5_2 | - | ||||||||||||||||||||||||
555 | \value Qt_5_4 Version 16 (Qt 5.4) | - | ||||||||||||||||||||||||
556 | \value Qt_5_5 Same as Qt_5_4 | - | ||||||||||||||||||||||||
557 | \value Qt_5_6 Version 17 (Qt 5.6) | - | ||||||||||||||||||||||||
558 | \value Qt_5_7 Same as Qt_5_6 | - | ||||||||||||||||||||||||
559 | \omitvalue Qt_DefaultCompiledVersion | - | ||||||||||||||||||||||||
560 | - | |||||||||||||||||||||||||
561 | \sa setVersion(), version() | - | ||||||||||||||||||||||||
562 | */ | - | ||||||||||||||||||||||||
563 | - | |||||||||||||||||||||||||
564 | /*! | - | ||||||||||||||||||||||||
565 | \fn int QDataStream::version() const | - | ||||||||||||||||||||||||
566 | - | |||||||||||||||||||||||||
567 | Returns the version number of the data serialization format. | - | ||||||||||||||||||||||||
568 | - | |||||||||||||||||||||||||
569 | \sa setVersion(), Version | - | ||||||||||||||||||||||||
570 | */ | - | ||||||||||||||||||||||||
571 | - | |||||||||||||||||||||||||
572 | /*! | - | ||||||||||||||||||||||||
573 | \fn void QDataStream::setVersion(int v) | - | ||||||||||||||||||||||||
574 | - | |||||||||||||||||||||||||
575 | Sets the version number of the data serialization format to \a v, | - | ||||||||||||||||||||||||
576 | a value of the \l Version enum. | - | ||||||||||||||||||||||||
577 | - | |||||||||||||||||||||||||
578 | You don't \e have to set a version if you are using the current | - | ||||||||||||||||||||||||
579 | version of Qt, but for your own custom binary formats we | - | ||||||||||||||||||||||||
580 | recommend that you do; see \l{Versioning} in the Detailed | - | ||||||||||||||||||||||||
581 | Description. | - | ||||||||||||||||||||||||
582 | - | |||||||||||||||||||||||||
583 | To accommodate new functionality, the datastream serialization | - | ||||||||||||||||||||||||
584 | format of some Qt classes has changed in some versions of Qt. If | - | ||||||||||||||||||||||||
585 | you want to read data that was created by an earlier version of | - | ||||||||||||||||||||||||
586 | Qt, or write data that can be read by a program that was compiled | - | ||||||||||||||||||||||||
587 | with an earlier version of Qt, use this function to modify the | - | ||||||||||||||||||||||||
588 | serialization format used by QDataStream. | - | ||||||||||||||||||||||||
589 | - | |||||||||||||||||||||||||
590 | The \l Version enum provides symbolic constants for the different | - | ||||||||||||||||||||||||
591 | versions of Qt. For example: | - | ||||||||||||||||||||||||
592 | - | |||||||||||||||||||||||||
593 | \snippet code/src_corelib_io_qdatastream.cpp 5 | - | ||||||||||||||||||||||||
594 | - | |||||||||||||||||||||||||
595 | \sa version(), Version | - | ||||||||||||||||||||||||
596 | */ | - | ||||||||||||||||||||||||
597 | - | |||||||||||||||||||||||||
598 | /*! | - | ||||||||||||||||||||||||
599 | \since 5.7 | - | ||||||||||||||||||||||||
600 | - | |||||||||||||||||||||||||
601 | Starts a new read transaction on the stream. | - | ||||||||||||||||||||||||
602 | - | |||||||||||||||||||||||||
603 | Defines a restorable point within the sequence of read operations. For | - | ||||||||||||||||||||||||
604 | sequential devices, read data will be duplicated internally to allow | - | ||||||||||||||||||||||||
605 | recovery in case of incomplete reads. For random-access devices, | - | ||||||||||||||||||||||||
606 | this function saves the current position of the stream. Call | - | ||||||||||||||||||||||||
607 | commitTransaction(), rollbackTransaction(), or abortTransaction() to | - | ||||||||||||||||||||||||
608 | finish the current transaction. | - | ||||||||||||||||||||||||
609 | - | |||||||||||||||||||||||||
610 | Once a transaction is started, subsequent calls to this function will make | - | ||||||||||||||||||||||||
611 | the transaction recursive. Inner transactions act as agents of the | - | ||||||||||||||||||||||||
612 | outermost transaction (i.e., report the status of read operations to the | - | ||||||||||||||||||||||||
613 | outermost transaction, which can restore the position of the stream). | - | ||||||||||||||||||||||||
614 | - | |||||||||||||||||||||||||
615 | \note Restoring to the point of the nested startTransaction() call is not | - | ||||||||||||||||||||||||
616 | supported. | - | ||||||||||||||||||||||||
617 | - | |||||||||||||||||||||||||
618 | When an error occurs during a transaction (including an inner transaction | - | ||||||||||||||||||||||||
619 | failing), reading from the data stream is suspended (all subsequent read | - | ||||||||||||||||||||||||
620 | operations return empty/zero values) and subsequent inner transactions are | - | ||||||||||||||||||||||||
621 | forced to fail. Starting a new outermost transaction recovers from this | - | ||||||||||||||||||||||||
622 | state. This behavior makes it unnecessary to error-check every read | - | ||||||||||||||||||||||||
623 | operation separately. | - | ||||||||||||||||||||||||
624 | - | |||||||||||||||||||||||||
625 | \sa commitTransaction(), rollbackTransaction(), abortTransaction() | - | ||||||||||||||||||||||||
626 | */ | - | ||||||||||||||||||||||||
627 | - | |||||||||||||||||||||||||
628 | void QDataStream::startTransaction() | - | ||||||||||||||||||||||||
629 | { | - | ||||||||||||||||||||||||
630 | CHECK_STREAM_PRECOND(Q_VOID) never executed: return ;
| 0-719 | ||||||||||||||||||||||||
631 | - | |||||||||||||||||||||||||
632 | if (d == 0)
| 310-409 | ||||||||||||||||||||||||
633 | d.reset(new QDataStreamPrivate()); executed 409 times by 1 test: d.reset(new QDataStreamPrivate()); Executed by:
| 409 | ||||||||||||||||||||||||
634 | - | |||||||||||||||||||||||||
635 | if (++d->transactionDepth == 1) {
| 18-701 | ||||||||||||||||||||||||
636 | dev->startTransaction(); | - | ||||||||||||||||||||||||
637 | resetStatus(); | - | ||||||||||||||||||||||||
638 | } executed 701 times by 1 test: end of block Executed by:
| 701 | ||||||||||||||||||||||||
639 | } executed 719 times by 1 test: end of block Executed by:
| 719 | ||||||||||||||||||||||||
640 | - | |||||||||||||||||||||||||
641 | /*! | - | ||||||||||||||||||||||||
642 | \since 5.7 | - | ||||||||||||||||||||||||
643 | - | |||||||||||||||||||||||||
644 | Completes a read transaction. Returns \c true if no read errors have | - | ||||||||||||||||||||||||
645 | occurred during the transaction; otherwise returns \c false. | - | ||||||||||||||||||||||||
646 | - | |||||||||||||||||||||||||
647 | If called on an inner transaction, committing will be postponed until | - | ||||||||||||||||||||||||
648 | the outermost commitTransaction(), rollbackTransaction(), or | - | ||||||||||||||||||||||||
649 | abortTransaction() call occurs. | - | ||||||||||||||||||||||||
650 | - | |||||||||||||||||||||||||
651 | Otherwise, if the stream status indicates reading past the end of the | - | ||||||||||||||||||||||||
652 | data, this function restores the stream data to the point of the | - | ||||||||||||||||||||||||
653 | startTransaction() call. When this situation occurs, you need to wait for | - | ||||||||||||||||||||||||
654 | more data to arrive, after which you start a new transaction. If the data | - | ||||||||||||||||||||||||
655 | stream has read corrupt data or any of the inner transactions was aborted, | - | ||||||||||||||||||||||||
656 | this function aborts the transaction. | - | ||||||||||||||||||||||||
657 | - | |||||||||||||||||||||||||
658 | \sa startTransaction(), rollbackTransaction(), abortTransaction() | - | ||||||||||||||||||||||||
659 | */ | - | ||||||||||||||||||||||||
660 | - | |||||||||||||||||||||||||
661 | bool QDataStream::commitTransaction() | - | ||||||||||||||||||||||||
662 | { | - | ||||||||||||||||||||||||
663 | CHECK_STREAM_TRANSACTION_PRECOND(false) never executed: return false;
| 0-707 | ||||||||||||||||||||||||
664 | if (--d->transactionDepth == 0) {
| 6-701 | ||||||||||||||||||||||||
665 | CHECK_STREAM_PRECOND(false) never executed: return false;
| 0-701 | ||||||||||||||||||||||||
666 | - | |||||||||||||||||||||||||
667 | if (q_status == ReadPastEnd) {
| 331-370 | ||||||||||||||||||||||||
668 | dev->rollbackTransaction(); | - | ||||||||||||||||||||||||
669 | return false; executed 370 times by 1 test: return false; Executed by:
| 370 | ||||||||||||||||||||||||
670 | } | - | ||||||||||||||||||||||||
671 | dev->commitTransaction(); | - | ||||||||||||||||||||||||
672 | } executed 331 times by 1 test: end of block Executed by:
| 331 | ||||||||||||||||||||||||
673 | return q_status == Ok; executed 337 times by 1 test: return q_status == Ok; Executed by:
| 337 | ||||||||||||||||||||||||
674 | } | - | ||||||||||||||||||||||||
675 | - | |||||||||||||||||||||||||
676 | /*! | - | ||||||||||||||||||||||||
677 | \since 5.7 | - | ||||||||||||||||||||||||
678 | - | |||||||||||||||||||||||||
679 | Reverts a read transaction. | - | ||||||||||||||||||||||||
680 | - | |||||||||||||||||||||||||
681 | This function is commonly used to rollback the transaction when an | - | ||||||||||||||||||||||||
682 | incomplete read was detected prior to committing the transaction. | - | ||||||||||||||||||||||||
683 | - | |||||||||||||||||||||||||
684 | If called on an inner transaction, reverting is delegated to the outermost | - | ||||||||||||||||||||||||
685 | transaction, and subsequently started inner transactions are forced to | - | ||||||||||||||||||||||||
686 | fail. | - | ||||||||||||||||||||||||
687 | - | |||||||||||||||||||||||||
688 | For the outermost transaction, restores the stream data to the point of | - | ||||||||||||||||||||||||
689 | the startTransaction() call. If the data stream has read corrupt data or | - | ||||||||||||||||||||||||
690 | any of the inner transactions was aborted, this function aborts the | - | ||||||||||||||||||||||||
691 | transaction. | - | ||||||||||||||||||||||||
692 | - | |||||||||||||||||||||||||
693 | If the preceding stream operations were successful, sets the status of the | - | ||||||||||||||||||||||||
694 | data stream to \value ReadPastEnd. | - | ||||||||||||||||||||||||
695 | - | |||||||||||||||||||||||||
696 | \sa startTransaction(), commitTransaction(), abortTransaction() | - | ||||||||||||||||||||||||
697 | */ | - | ||||||||||||||||||||||||
698 | - | |||||||||||||||||||||||||
699 | void QDataStream::rollbackTransaction() | - | ||||||||||||||||||||||||
700 | { | - | ||||||||||||||||||||||||
701 | setStatus(ReadPastEnd); | - | ||||||||||||||||||||||||
702 | - | |||||||||||||||||||||||||
703 | CHECK_STREAM_TRANSACTION_PRECOND(Q_VOID) never executed: return ;
| 0-6 | ||||||||||||||||||||||||
704 | if (--d->transactionDepth != 0)
| 0-6 | ||||||||||||||||||||||||
705 | return; executed 6 times by 1 test: return; Executed by:
| 6 | ||||||||||||||||||||||||
706 | - | |||||||||||||||||||||||||
707 | CHECK_STREAM_PRECOND(Q_VOID) never executed: return ;
| 0 | ||||||||||||||||||||||||
708 | if (q_status == ReadPastEnd)
| 0 | ||||||||||||||||||||||||
709 | dev->rollbackTransaction(); never executed: dev->rollbackTransaction(); | 0 | ||||||||||||||||||||||||
710 | else | - | ||||||||||||||||||||||||
711 | dev->commitTransaction(); never executed: dev->commitTransaction(); | 0 | ||||||||||||||||||||||||
712 | } | - | ||||||||||||||||||||||||
713 | - | |||||||||||||||||||||||||
714 | /*! | - | ||||||||||||||||||||||||
715 | \since 5.7 | - | ||||||||||||||||||||||||
716 | - | |||||||||||||||||||||||||
717 | Aborts a read transaction. | - | ||||||||||||||||||||||||
718 | - | |||||||||||||||||||||||||
719 | This function is commonly used to discard the transaction after | - | ||||||||||||||||||||||||
720 | higher-level protocol errors or loss of stream synchronization. | - | ||||||||||||||||||||||||
721 | - | |||||||||||||||||||||||||
722 | If called on an inner transaction, aborting is delegated to the outermost | - | ||||||||||||||||||||||||
723 | transaction, and subsequently started inner transactions are forced to | - | ||||||||||||||||||||||||
724 | fail. | - | ||||||||||||||||||||||||
725 | - | |||||||||||||||||||||||||
726 | For the outermost transaction, discards the restoration point and any | - | ||||||||||||||||||||||||
727 | internally duplicated data of the stream. Will not affect the current | - | ||||||||||||||||||||||||
728 | read position of the stream. | - | ||||||||||||||||||||||||
729 | - | |||||||||||||||||||||||||
730 | Sets the status of the data stream to \value ReadCorruptData. | - | ||||||||||||||||||||||||
731 | - | |||||||||||||||||||||||||
732 | \sa startTransaction(), commitTransaction(), rollbackTransaction() | - | ||||||||||||||||||||||||
733 | */ | - | ||||||||||||||||||||||||
734 | - | |||||||||||||||||||||||||
735 | void QDataStream::abortTransaction() | - | ||||||||||||||||||||||||
736 | { | - | ||||||||||||||||||||||||
737 | q_status = ReadCorruptData; | - | ||||||||||||||||||||||||
738 | - | |||||||||||||||||||||||||
739 | CHECK_STREAM_TRANSACTION_PRECOND(Q_VOID) never executed: return ;
| 0-6 | ||||||||||||||||||||||||
740 | if (--d->transactionDepth != 0)
| 0-6 | ||||||||||||||||||||||||
741 | return; executed 6 times by 1 test: return; Executed by:
| 6 | ||||||||||||||||||||||||
742 | - | |||||||||||||||||||||||||
743 | CHECK_STREAM_PRECOND(Q_VOID) never executed: return ;
| 0 | ||||||||||||||||||||||||
744 | dev->commitTransaction(); | - | ||||||||||||||||||||||||
745 | } never executed: end of block | 0 | ||||||||||||||||||||||||
746 | - | |||||||||||||||||||||||||
747 | /***************************************************************************** | - | ||||||||||||||||||||||||
748 | QDataStream read functions | - | ||||||||||||||||||||||||
749 | *****************************************************************************/ | - | ||||||||||||||||||||||||
750 | - | |||||||||||||||||||||||||
751 | /*! | - | ||||||||||||||||||||||||
752 | \internal | - | ||||||||||||||||||||||||
753 | */ | - | ||||||||||||||||||||||||
754 | - | |||||||||||||||||||||||||
755 | int QDataStream::readBlock(char *data, int len) | - | ||||||||||||||||||||||||
756 | { | - | ||||||||||||||||||||||||
757 | // Disable reads on failure in transacted stream | - | ||||||||||||||||||||||||
758 |
| 171-338953 | ||||||||||||||||||||||||
759 | return -1; executed 1075 times by 2 tests: return -1; Executed by:
| 1075 | ||||||||||||||||||||||||
760 | - | |||||||||||||||||||||||||
761 | const int readResult = dev->read(data, len); | - | ||||||||||||||||||||||||
762 | if (readResult != len)
| 1217-337907 | ||||||||||||||||||||||||
763 | setStatus(ReadPastEnd); executed 1217 times by 12 tests: setStatus(ReadPastEnd); Executed by:
| 1217 | ||||||||||||||||||||||||
764 | return readResult; executed 339124 times by 62 tests: return readResult; Executed by:
| 339124 | ||||||||||||||||||||||||
765 | } | - | ||||||||||||||||||||||||
766 | - | |||||||||||||||||||||||||
767 | /*! | - | ||||||||||||||||||||||||
768 | \fn QDataStream &QDataStream::operator>>(quint8 &i) | - | ||||||||||||||||||||||||
769 | \overload | - | ||||||||||||||||||||||||
770 | - | |||||||||||||||||||||||||
771 | Reads an unsigned byte from the stream into \a i, and returns a | - | ||||||||||||||||||||||||
772 | reference to the stream. | - | ||||||||||||||||||||||||
773 | */ | - | ||||||||||||||||||||||||
774 | - | |||||||||||||||||||||||||
775 | /*! | - | ||||||||||||||||||||||||
776 | Reads a signed byte from the stream into \a i, and returns a | - | ||||||||||||||||||||||||
777 | reference to the stream. | - | ||||||||||||||||||||||||
778 | */ | - | ||||||||||||||||||||||||
779 | - | |||||||||||||||||||||||||
780 | QDataStream &QDataStream::operator>>(qint8 &i) | - | ||||||||||||||||||||||||
781 | { | - | ||||||||||||||||||||||||
782 | i = 0; | - | ||||||||||||||||||||||||
783 | CHECK_STREAM_PRECOND(*this) never executed: return *this;
| 0-133653 | ||||||||||||||||||||||||
784 | char c; | - | ||||||||||||||||||||||||
785 | if (!dev->getChar(&c))
| 183-133470 | ||||||||||||||||||||||||
setStatus
| ||||||||||||||||||||||||||
else
| ||||||||||||||||||||||||||
786 | i = qint8(c); executed 133470 times by 39 tests: i = qint8(c); Executed by:
| 133470 | ||||||||||||||||||||||||
787 | return *this; executed 133653 times by 39 tests: return *this; Executed by:
| 133653 | ||||||||||||||||||||||||
788 | } | - | ||||||||||||||||||||||||
789 | - | |||||||||||||||||||||||||
790 | - | |||||||||||||||||||||||||
791 | /*! | - | ||||||||||||||||||||||||
792 | \fn QDataStream &QDataStream::operator>>(quint16 &i) | - | ||||||||||||||||||||||||
793 | \overload | - | ||||||||||||||||||||||||
794 | - | |||||||||||||||||||||||||
795 | Reads an unsigned 16-bit integer from the stream into \a i, and | - | ||||||||||||||||||||||||
796 | returns a reference to the stream. | - | ||||||||||||||||||||||||
797 | */ | - | ||||||||||||||||||||||||
798 | - | |||||||||||||||||||||||||
799 | /*! | - | ||||||||||||||||||||||||
800 | \overload | - | ||||||||||||||||||||||||
801 | - | |||||||||||||||||||||||||
802 | Reads a signed 16-bit integer from the stream into \a i, and | - | ||||||||||||||||||||||||
803 | returns a reference to the stream. | - | ||||||||||||||||||||||||
804 | */ | - | ||||||||||||||||||||||||
805 | - | |||||||||||||||||||||||||
806 | QDataStream &QDataStream::operator>>(qint16 &i) | - | ||||||||||||||||||||||||
807 | { | - | ||||||||||||||||||||||||
808 | i = 0; | - | ||||||||||||||||||||||||
809 | CHECK_STREAM_PRECOND(*this) never executed: return *this;
| 0-11603 | ||||||||||||||||||||||||
810 | if (dev->read((readBlock(reinterpret_cast<char *)*>(&i,), 2) != 2) {
| 87-11516 | ||||||||||||||||||||||||
811 | i = 0; | - | ||||||||||||||||||||||||
812 | setStatus(ReadPastEnd);} else { executed 87 times by 5 tests: end of block Executed by:
| 87 | ||||||||||||||||||||||||
813 | if (!noswap) {
| 1518-9998 | ||||||||||||||||||||||||
814 | i = qbswap(i); | - | ||||||||||||||||||||||||
815 | } executed 9998 times by 15 tests: end of block Executed by:
| 9998 | ||||||||||||||||||||||||
816 | } executed 11516 times by 19 tests: end of block Executed by:
| 11516 | ||||||||||||||||||||||||
817 | return *this; executed 11603 times by 19 tests: return *this; Executed by:
| 11603 | ||||||||||||||||||||||||
818 | } | - | ||||||||||||||||||||||||
819 | - | |||||||||||||||||||||||||
820 | - | |||||||||||||||||||||||||
821 | /*! | - | ||||||||||||||||||||||||
822 | \fn QDataStream &QDataStream::operator>>(quint32 &i) | - | ||||||||||||||||||||||||
823 | \overload | - | ||||||||||||||||||||||||
824 | - | |||||||||||||||||||||||||
825 | Reads an unsigned 32-bit integer from the stream into \a i, and | - | ||||||||||||||||||||||||
826 | returns a reference to the stream. | - | ||||||||||||||||||||||||
827 | */ | - | ||||||||||||||||||||||||
828 | - | |||||||||||||||||||||||||
829 | /*! | - | ||||||||||||||||||||||||
830 | \overload | - | ||||||||||||||||||||||||
831 | - | |||||||||||||||||||||||||
832 | Reads a signed 32-bit integer from the stream into \a i, and | - | ||||||||||||||||||||||||
833 | returns a reference to the stream. | - | ||||||||||||||||||||||||
834 | */ | - | ||||||||||||||||||||||||
835 | - | |||||||||||||||||||||||||
836 | QDataStream &QDataStream::operator>>(qint32 &i) | - | ||||||||||||||||||||||||
837 | { | - | ||||||||||||||||||||||||
838 | i = 0; | - | ||||||||||||||||||||||||
839 | CHECK_STREAM_PRECOND(*this) never executed: return *this;
| 0-123863 | ||||||||||||||||||||||||
840 | if (dev->read((readBlock(reinterpret_cast<char *)*>(&i,), 4) != 4) {
| 728-123135 | ||||||||||||||||||||||||
841 | i = 0; | - | ||||||||||||||||||||||||
842 | setStatus(ReadPastEnd);} else { executed 728 times by 10 tests: end of block Executed by:
| 728 | ||||||||||||||||||||||||
843 | if (!noswap) {
| 3736-119399 | ||||||||||||||||||||||||
844 | i = qbswap(i); | - | ||||||||||||||||||||||||
845 | } executed 119399 times by 54 tests: end of block Executed by:
| 119399 | ||||||||||||||||||||||||
846 | } executed 123135 times by 57 tests: end of block Executed by:
| 123135 | ||||||||||||||||||||||||
847 | return *this; executed 123863 times by 57 tests: return *this; Executed by:
| 123863 | ||||||||||||||||||||||||
848 | } | - | ||||||||||||||||||||||||
849 | - | |||||||||||||||||||||||||
850 | /*! | - | ||||||||||||||||||||||||
851 | \fn QDataStream &QDataStream::operator>>(quint64 &i) | - | ||||||||||||||||||||||||
852 | \overload | - | ||||||||||||||||||||||||
853 | - | |||||||||||||||||||||||||
854 | Reads an unsigned 64-bit integer from the stream, into \a i, and | - | ||||||||||||||||||||||||
855 | returns a reference to the stream. | - | ||||||||||||||||||||||||
856 | */ | - | ||||||||||||||||||||||||
857 | - | |||||||||||||||||||||||||
858 | /*! | - | ||||||||||||||||||||||||
859 | \overload | - | ||||||||||||||||||||||||
860 | - | |||||||||||||||||||||||||
861 | Reads a signed 64-bit integer from the stream into \a i, and | - | ||||||||||||||||||||||||
862 | returns a reference to the stream. | - | ||||||||||||||||||||||||
863 | */ | - | ||||||||||||||||||||||||
864 | - | |||||||||||||||||||||||||
865 | QDataStream &QDataStream::operator>>(qint64 &i) | - | ||||||||||||||||||||||||
866 | { | - | ||||||||||||||||||||||||
867 | i = qint64(0); | - | ||||||||||||||||||||||||
868 | CHECK_STREAM_PRECOND(*this) never executed: return *this;
| 0-35987 | ||||||||||||||||||||||||
869 | if (version() < 6) {
| 0-35987 | ||||||||||||||||||||||||
870 | quint32 i1, i2; | - | ||||||||||||||||||||||||
871 | *this >> i2 >> i1; | - | ||||||||||||||||||||||||
872 | i = ((quint64)i1 << 32) + i2; | - | ||||||||||||||||||||||||
873 | } else { never executed: end of block | 0 | ||||||||||||||||||||||||
874 | if (dev->read((readBlock(reinterpret_cast<char *)*>(&i,), 8) != 8) {
| 185-35802 | ||||||||||||||||||||||||
875 | i = qint64(0); | - | ||||||||||||||||||||||||
setStatus(ReadPastEnd); | ||||||||||||||||||||||||||
876 | } else { executed 185 times by 3 tests: end of block Executed by:
| 185 | ||||||||||||||||||||||||
877 | if (!noswap) {
| 12-35790 | ||||||||||||||||||||||||
878 | i = qbswap(i); | - | ||||||||||||||||||||||||
879 | } executed 35790 times by 13 tests: end of block Executed by:
| 35790 | ||||||||||||||||||||||||
880 | } executed 35802 times by 13 tests: end of block Executed by:
| 35802 | ||||||||||||||||||||||||
881 | } | - | ||||||||||||||||||||||||
882 | return *this; executed 35987 times by 13 tests: return *this; Executed by:
| 35987 | ||||||||||||||||||||||||
883 | } | - | ||||||||||||||||||||||||
884 | - | |||||||||||||||||||||||||
885 | /*! | - | ||||||||||||||||||||||||
886 | Reads a boolean value from the stream into \a i. Returns a | - | ||||||||||||||||||||||||
887 | reference to the stream. | - | ||||||||||||||||||||||||
888 | */ | - | ||||||||||||||||||||||||
889 | QDataStream &QDataStream::operator>>(bool &i) | - | ||||||||||||||||||||||||
890 | { | - | ||||||||||||||||||||||||
891 | qint8 v; | - | ||||||||||||||||||||||||
892 | *this >> v; | - | ||||||||||||||||||||||||
893 | i = !!v; | - | ||||||||||||||||||||||||
894 | return *this; | - | ||||||||||||||||||||||||
895 | } | - | ||||||||||||||||||||||||
896 | - | |||||||||||||||||||||||||
897 | /*! | - | ||||||||||||||||||||||||
898 | \overload | - | ||||||||||||||||||||||||
899 | - | |||||||||||||||||||||||||
900 | Reads a floating point number from the stream into \a f, | - | ||||||||||||||||||||||||
901 | using the standard IEEE 754 format. Returns a reference to the | - | ||||||||||||||||||||||||
902 | stream. | - | ||||||||||||||||||||||||
903 | - | |||||||||||||||||||||||||
904 | \sa setFloatingPointPrecision() | - | ||||||||||||||||||||||||
905 | */ | - | ||||||||||||||||||||||||
906 | - | |||||||||||||||||||||||||
907 | QDataStream &QDataStream::operator>>(float &f) | - | ||||||||||||||||||||||||
908 | { | - | ||||||||||||||||||||||||
909 | if (version() >= QDataStream::Qt_4_6
| 0-1263 | ||||||||||||||||||||||||
910 | && floatingPointPrecision() == QDataStream::DoublePrecision) {
| 26-1237 | ||||||||||||||||||||||||
911 | double d; | - | ||||||||||||||||||||||||
912 | *this >> d; | - | ||||||||||||||||||||||||
913 | f = d; | - | ||||||||||||||||||||||||
914 | return *this; executed 1237 times by 4 tests: return *this; Executed by:
| 1237 | ||||||||||||||||||||||||
915 | } | - | ||||||||||||||||||||||||
916 | - | |||||||||||||||||||||||||
917 | f = 0.0f; | - | ||||||||||||||||||||||||
918 | CHECK_STREAM_PRECOND(*this) never executed: return *this;
| 0-26 | ||||||||||||||||||||||||
919 | if (dev->read((readBlock(reinterpret_cast<char *)*>(&f,), 4) != 4) {
| 10-16 | ||||||||||||||||||||||||
920 | f = 0.0f; | - | ||||||||||||||||||||||||
921 | setStatus(ReadPastEnd);} else { executed 10 times by 1 test: end of block Executed by:
| 10 | ||||||||||||||||||||||||
922 | if (!noswap) {
| 6-10 | ||||||||||||||||||||||||
923 | union { | - | ||||||||||||||||||||||||
924 | float val1; | - | ||||||||||||||||||||||||
925 | quint32 val2; | - | ||||||||||||||||||||||||
926 | } x; | - | ||||||||||||||||||||||||
927 | x.val2 = qbswap(*reinterpret_cast<quint32 *>(&f)); | - | ||||||||||||||||||||||||
928 | f = x.val1; | - | ||||||||||||||||||||||||
929 | } executed 10 times by 1 test: end of block Executed by:
| 10 | ||||||||||||||||||||||||
930 | } executed 16 times by 1 test: end of block Executed by:
| 16 | ||||||||||||||||||||||||
931 | return *this; executed 26 times by 1 test: return *this; Executed by:
| 26 | ||||||||||||||||||||||||
932 | } | - | ||||||||||||||||||||||||
933 | - | |||||||||||||||||||||||||
934 | /*! | - | ||||||||||||||||||||||||
935 | \overload | - | ||||||||||||||||||||||||
936 | - | |||||||||||||||||||||||||
937 | Reads a floating point number from the stream into \a f, | - | ||||||||||||||||||||||||
938 | using the standard IEEE 754 format. Returns a reference to the | - | ||||||||||||||||||||||||
939 | stream. | - | ||||||||||||||||||||||||
940 | - | |||||||||||||||||||||||||
941 | \sa setFloatingPointPrecision() | - | ||||||||||||||||||||||||
942 | */ | - | ||||||||||||||||||||||||
943 | - | |||||||||||||||||||||||||
944 | QDataStream &QDataStream::operator>>(double &f) | - | ||||||||||||||||||||||||
945 | { | - | ||||||||||||||||||||||||
946 | if (version() >= QDataStream::Qt_4_6
| 3248-11776 | ||||||||||||||||||||||||
947 | && floatingPointPrecision() == QDataStream::SinglePrecision) {
| 1-11775 | ||||||||||||||||||||||||
948 | float d; | - | ||||||||||||||||||||||||
949 | *this >> d; | - | ||||||||||||||||||||||||
950 | f = d; | - | ||||||||||||||||||||||||
951 | return *this; executed 1 time by 1 test: return *this; Executed by:
| 1 | ||||||||||||||||||||||||
952 | } | - | ||||||||||||||||||||||||
953 | - | |||||||||||||||||||||||||
954 | f = 0.0; | - | ||||||||||||||||||||||||
955 | CHECK_STREAM_PRECOND(*this) never executed: return *this;
| 0-15023 | ||||||||||||||||||||||||
956 | if (dev->read((readBlock(reinterpret_cast<char *)*>(&f,), 8) != 8) {
| 550-14473 | ||||||||||||||||||||||||
957 | f = 0.0; | - | ||||||||||||||||||||||||
958 | setStatus(ReadPastEnd);} else { executed 550 times by 3 tests: end of block Executed by:
| 550 | ||||||||||||||||||||||||
959 | if (!noswap) {
| 7-14466 | ||||||||||||||||||||||||
960 | union { | - | ||||||||||||||||||||||||
961 | double val1; | - | ||||||||||||||||||||||||
962 | quint64 val2; | - | ||||||||||||||||||||||||
963 | } x; | - | ||||||||||||||||||||||||
964 | x.val2 = qbswap(*reinterpret_cast<quint64 *>(&f)); | - | ||||||||||||||||||||||||
965 | f = x.val1; | - | ||||||||||||||||||||||||
966 | } executed 14466 times by 14 tests: end of block Executed by:
| 14466 | ||||||||||||||||||||||||
967 | } executed 14473 times by 14 tests: end of block Executed by:
| 14473 | ||||||||||||||||||||||||
968 | return *this; executed 15023 times by 14 tests: return *this; Executed by:
| 15023 | ||||||||||||||||||||||||
969 | } | - | ||||||||||||||||||||||||
970 | - | |||||||||||||||||||||||||
971 | - | |||||||||||||||||||||||||
972 | /*! | - | ||||||||||||||||||||||||
973 | \overload | - | ||||||||||||||||||||||||
974 | - | |||||||||||||||||||||||||
975 | Reads the '\\0'-terminated string \a s from the stream and returns | - | ||||||||||||||||||||||||
976 | a reference to the stream. | - | ||||||||||||||||||||||||
977 | - | |||||||||||||||||||||||||
978 | The string is deserialized using \c{readBytes()}. | - | ||||||||||||||||||||||||
979 | - | |||||||||||||||||||||||||
980 | Space for the string is allocated using \c{new []} -- the caller must | - | ||||||||||||||||||||||||
981 | destroy it with \c{delete []}. | - | ||||||||||||||||||||||||
982 | - | |||||||||||||||||||||||||
983 | \sa readBytes(), readRawData() | - | ||||||||||||||||||||||||
984 | */ | - | ||||||||||||||||||||||||
985 | - | |||||||||||||||||||||||||
986 | QDataStream &QDataStream::operator>>(char *&s) | - | ||||||||||||||||||||||||
987 | { | - | ||||||||||||||||||||||||
988 | uint len = 0; | - | ||||||||||||||||||||||||
989 | return readBytes(s, len); | - | ||||||||||||||||||||||||
990 | } | - | ||||||||||||||||||||||||
991 | - | |||||||||||||||||||||||||
992 | - | |||||||||||||||||||||||||
993 | /*! | - | ||||||||||||||||||||||||
994 | Reads the buffer \a s from the stream and returns a reference to | - | ||||||||||||||||||||||||
995 | the stream. | - | ||||||||||||||||||||||||
996 | - | |||||||||||||||||||||||||
997 | The buffer \a s is allocated using \c{new []}. Destroy it with the | - | ||||||||||||||||||||||||
998 | \c{delete []} operator. | - | ||||||||||||||||||||||||
999 | - | |||||||||||||||||||||||||
1000 | The \a l parameter is set to the length of the buffer. If the | - | ||||||||||||||||||||||||
1001 | string read is empty, \a l is set to 0 and \a s is set to | - | ||||||||||||||||||||||||
1002 | a null pointer. | - | ||||||||||||||||||||||||
1003 | - | |||||||||||||||||||||||||
1004 | The serialization format is a quint32 length specifier first, | - | ||||||||||||||||||||||||
1005 | then \a l bytes of data. | - | ||||||||||||||||||||||||
1006 | - | |||||||||||||||||||||||||
1007 | \sa readRawData(), writeBytes() | - | ||||||||||||||||||||||||
1008 | */ | - | ||||||||||||||||||||||||
1009 | - | |||||||||||||||||||||||||
1010 | QDataStream &QDataStream::readBytes(char *&s, uint &l) | - | ||||||||||||||||||||||||
1011 | { | - | ||||||||||||||||||||||||
1012 | s = 0; | - | ||||||||||||||||||||||||
1013 | l = 0; | - | ||||||||||||||||||||||||
1014 | CHECK_STREAM_PRECOND(*this) never executed: return *this;
| 0-1281 | ||||||||||||||||||||||||
1015 | - | |||||||||||||||||||||||||
1016 | quint32 len; | - | ||||||||||||||||||||||||
1017 | *this >> len; | - | ||||||||||||||||||||||||
1018 | if (len == 0)
| 334-947 | ||||||||||||||||||||||||
1019 | return *this; executed 334 times by 2 tests: return *this; Executed by:
| 334 | ||||||||||||||||||||||||
1020 | - | |||||||||||||||||||||||||
1021 | const quint32 Step = 1024 * 1024; | - | ||||||||||||||||||||||||
1022 | quint32 allocated = 0; | - | ||||||||||||||||||||||||
1023 | char *prevBuf = 0; | - | ||||||||||||||||||||||||
1024 | char *curBuf = 0; | - | ||||||||||||||||||||||||
1025 | - | |||||||||||||||||||||||||
1026 | do { | - | ||||||||||||||||||||||||
1027 | int blockSize = qMin(Step, len - allocated); | - | ||||||||||||||||||||||||
1028 | prevBuf = curBuf; | - | ||||||||||||||||||||||||
1029 | curBuf = new char[allocated + blockSize + 1]; | - | ||||||||||||||||||||||||
1030 | if (prevBuf) {
| 28-947 | ||||||||||||||||||||||||
1031 | memcpy(curBuf, prevBuf, allocated); | - | ||||||||||||||||||||||||
1032 | delete [] prevBuf; | - | ||||||||||||||||||||||||
1033 | } executed 28 times by 1 test: end of block Executed by:
| 28 | ||||||||||||||||||||||||
1034 | if (dev->readreadBlock(curBuf + allocated, blockSize) != blockSize) {
| 180-795 | ||||||||||||||||||||||||
1035 | delete [] curBuf; | - | ||||||||||||||||||||||||
1036 | setStatus(ReadPastEnd);return *this; executed 180 times by 2 tests: return *this; Executed by:
| 180 | ||||||||||||||||||||||||
1037 | } | - | ||||||||||||||||||||||||
1038 | allocated += blockSize; | - | ||||||||||||||||||||||||
1039 | } while (allocated < len); executed 795 times by 2 tests: end of block Executed by:
| 28-795 | ||||||||||||||||||||||||
1040 | - | |||||||||||||||||||||||||
1041 | s = curBuf; | - | ||||||||||||||||||||||||
1042 | s[len] = '\0'; | - | ||||||||||||||||||||||||
1043 | l = (uint)len; | - | ||||||||||||||||||||||||
1044 | return *this; executed 767 times by 2 tests: return *this; Executed by:
| 767 | ||||||||||||||||||||||||
1045 | } | - | ||||||||||||||||||||||||
1046 | - | |||||||||||||||||||||||||
1047 | /*! | - | ||||||||||||||||||||||||
1048 | Reads at most \a len bytes from the stream into \a s and returns the number of | - | ||||||||||||||||||||||||
1049 | bytes read. If an error occurs, this function returns -1. | - | ||||||||||||||||||||||||
1050 | - | |||||||||||||||||||||||||
1051 | The buffer \a s must be preallocated. The data is \e not encoded. | - | ||||||||||||||||||||||||
1052 | - | |||||||||||||||||||||||||
1053 | \sa readBytes(), QIODevice::read(), writeRawData() | - | ||||||||||||||||||||||||
1054 | */ | - | ||||||||||||||||||||||||
1055 | - | |||||||||||||||||||||||||
1056 | int QDataStream::readRawData(char *s, int len) | - | ||||||||||||||||||||||||
1057 | { | - | ||||||||||||||||||||||||
1058 | CHECK_STREAM_PRECOND(-1) never executed: return -1;
| 0-19060 | ||||||||||||||||||||||||
1059 | return dev->readreadBlock(s, len); executed 19060 times by 41 tests: return readBlock(s, len); Executed by:
| 19060 | ||||||||||||||||||||||||
1060 | } | - | ||||||||||||||||||||||||
1061 | - | |||||||||||||||||||||||||
1062 | - | |||||||||||||||||||||||||
1063 | /***************************************************************************** | - | ||||||||||||||||||||||||
1064 | QDataStream write functions | - | ||||||||||||||||||||||||
1065 | *****************************************************************************/ | - | ||||||||||||||||||||||||
1066 | - | |||||||||||||||||||||||||
1067 | - | |||||||||||||||||||||||||
1068 | /*! | - | ||||||||||||||||||||||||
1069 | \fn QDataStream &QDataStream::operator<<(quint8 i) | - | ||||||||||||||||||||||||
1070 | \overload | - | ||||||||||||||||||||||||
1071 | - | |||||||||||||||||||||||||
1072 | Writes an unsigned byte, \a i, to the stream and returns a | - | ||||||||||||||||||||||||
1073 | reference to the stream. | - | ||||||||||||||||||||||||
1074 | */ | - | ||||||||||||||||||||||||
1075 | - | |||||||||||||||||||||||||
1076 | /*! | - | ||||||||||||||||||||||||
1077 | Writes a signed byte, \a i, to the stream and returns a reference | - | ||||||||||||||||||||||||
1078 | to the stream. | - | ||||||||||||||||||||||||
1079 | */ | - | ||||||||||||||||||||||||
1080 | - | |||||||||||||||||||||||||
1081 | QDataStream &QDataStream::operator<<(qint8 i) | - | ||||||||||||||||||||||||
1082 | { | - | ||||||||||||||||||||||||
1083 | CHECK_STREAM_WRITE_PRECOND(*this) | - | ||||||||||||||||||||||||
1084 | if (!dev->putChar(i)) | - | ||||||||||||||||||||||||
1085 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1086 | return *this; | - | ||||||||||||||||||||||||
1087 | } | - | ||||||||||||||||||||||||
1088 | - | |||||||||||||||||||||||||
1089 | - | |||||||||||||||||||||||||
1090 | /*! | - | ||||||||||||||||||||||||
1091 | \fn QDataStream &QDataStream::operator<<(quint16 i) | - | ||||||||||||||||||||||||
1092 | \overload | - | ||||||||||||||||||||||||
1093 | - | |||||||||||||||||||||||||
1094 | Writes an unsigned 16-bit integer, \a i, to the stream and returns | - | ||||||||||||||||||||||||
1095 | a reference to the stream. | - | ||||||||||||||||||||||||
1096 | */ | - | ||||||||||||||||||||||||
1097 | - | |||||||||||||||||||||||||
1098 | /*! | - | ||||||||||||||||||||||||
1099 | \overload | - | ||||||||||||||||||||||||
1100 | - | |||||||||||||||||||||||||
1101 | Writes a signed 16-bit integer, \a i, to the stream and returns a | - | ||||||||||||||||||||||||
1102 | reference to the stream. | - | ||||||||||||||||||||||||
1103 | */ | - | ||||||||||||||||||||||||
1104 | - | |||||||||||||||||||||||||
1105 | QDataStream &QDataStream::operator<<(qint16 i) | - | ||||||||||||||||||||||||
1106 | { | - | ||||||||||||||||||||||||
1107 | CHECK_STREAM_WRITE_PRECOND(*this) | - | ||||||||||||||||||||||||
1108 | if (!noswap) { | - | ||||||||||||||||||||||||
1109 | i = qbswap(i); | - | ||||||||||||||||||||||||
1110 | } | - | ||||||||||||||||||||||||
1111 | if (dev->write((char *)&i, sizeof(qint16)) != sizeof(qint16)) | - | ||||||||||||||||||||||||
1112 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1113 | return *this; | - | ||||||||||||||||||||||||
1114 | } | - | ||||||||||||||||||||||||
1115 | - | |||||||||||||||||||||||||
1116 | /*! | - | ||||||||||||||||||||||||
1117 | \overload | - | ||||||||||||||||||||||||
1118 | - | |||||||||||||||||||||||||
1119 | Writes a signed 32-bit integer, \a i, to the stream and returns a | - | ||||||||||||||||||||||||
1120 | reference to the stream. | - | ||||||||||||||||||||||||
1121 | */ | - | ||||||||||||||||||||||||
1122 | - | |||||||||||||||||||||||||
1123 | QDataStream &QDataStream::operator<<(qint32 i) | - | ||||||||||||||||||||||||
1124 | { | - | ||||||||||||||||||||||||
1125 | CHECK_STREAM_WRITE_PRECOND(*this) | - | ||||||||||||||||||||||||
1126 | if (!noswap) { | - | ||||||||||||||||||||||||
1127 | i = qbswap(i); | - | ||||||||||||||||||||||||
1128 | } | - | ||||||||||||||||||||||||
1129 | if (dev->write((char *)&i, sizeof(qint32)) != sizeof(qint32)) | - | ||||||||||||||||||||||||
1130 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1131 | return *this; | - | ||||||||||||||||||||||||
1132 | } | - | ||||||||||||||||||||||||
1133 | - | |||||||||||||||||||||||||
1134 | /*! | - | ||||||||||||||||||||||||
1135 | \fn QDataStream &QDataStream::operator<<(quint64 i) | - | ||||||||||||||||||||||||
1136 | \overload | - | ||||||||||||||||||||||||
1137 | - | |||||||||||||||||||||||||
1138 | Writes an unsigned 64-bit integer, \a i, to the stream and returns a | - | ||||||||||||||||||||||||
1139 | reference to the stream. | - | ||||||||||||||||||||||||
1140 | */ | - | ||||||||||||||||||||||||
1141 | - | |||||||||||||||||||||||||
1142 | /*! | - | ||||||||||||||||||||||||
1143 | \overload | - | ||||||||||||||||||||||||
1144 | - | |||||||||||||||||||||||||
1145 | Writes a signed 64-bit integer, \a i, to the stream and returns a | - | ||||||||||||||||||||||||
1146 | reference to the stream. | - | ||||||||||||||||||||||||
1147 | */ | - | ||||||||||||||||||||||||
1148 | - | |||||||||||||||||||||||||
1149 | QDataStream &QDataStream::operator<<(qint64 i) | - | ||||||||||||||||||||||||
1150 | { | - | ||||||||||||||||||||||||
1151 | CHECK_STREAM_WRITE_PRECOND(*this) | - | ||||||||||||||||||||||||
1152 | if (version() < 6) { | - | ||||||||||||||||||||||||
1153 | quint32 i1 = i & 0xffffffff; | - | ||||||||||||||||||||||||
1154 | quint32 i2 = i >> 32; | - | ||||||||||||||||||||||||
1155 | *this << i2 << i1; | - | ||||||||||||||||||||||||
1156 | } else { | - | ||||||||||||||||||||||||
1157 | if (!noswap) { | - | ||||||||||||||||||||||||
1158 | i = qbswap(i); | - | ||||||||||||||||||||||||
1159 | } | - | ||||||||||||||||||||||||
1160 | if (dev->write((char *)&i, sizeof(qint64)) != sizeof(qint64)) | - | ||||||||||||||||||||||||
1161 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1162 | } | - | ||||||||||||||||||||||||
1163 | return *this; | - | ||||||||||||||||||||||||
1164 | } | - | ||||||||||||||||||||||||
1165 | - | |||||||||||||||||||||||||
1166 | /*! | - | ||||||||||||||||||||||||
1167 | \fn QDataStream &QDataStream::operator<<(quint32 i) | - | ||||||||||||||||||||||||
1168 | \overload | - | ||||||||||||||||||||||||
1169 | - | |||||||||||||||||||||||||
1170 | Writes an unsigned integer, \a i, to the stream as a 32-bit | - | ||||||||||||||||||||||||
1171 | unsigned integer (quint32). Returns a reference to the stream. | - | ||||||||||||||||||||||||
1172 | */ | - | ||||||||||||||||||||||||
1173 | - | |||||||||||||||||||||||||
1174 | /*! | - | ||||||||||||||||||||||||
1175 | Writes a boolean value, \a i, to the stream. Returns a reference | - | ||||||||||||||||||||||||
1176 | to the stream. | - | ||||||||||||||||||||||||
1177 | */ | - | ||||||||||||||||||||||||
1178 | - | |||||||||||||||||||||||||
1179 | QDataStream &QDataStream::operator<<(bool i) | - | ||||||||||||||||||||||||
1180 | { | - | ||||||||||||||||||||||||
1181 | CHECK_STREAM_WRITE_PRECOND(*this) | - | ||||||||||||||||||||||||
1182 | if (!dev->putChar(qint8(i))) | - | ||||||||||||||||||||||||
1183 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1184 | return *this; | - | ||||||||||||||||||||||||
1185 | } | - | ||||||||||||||||||||||||
1186 | - | |||||||||||||||||||||||||
1187 | /*! | - | ||||||||||||||||||||||||
1188 | \overload | - | ||||||||||||||||||||||||
1189 | - | |||||||||||||||||||||||||
1190 | Writes a floating point number, \a f, to the stream using | - | ||||||||||||||||||||||||
1191 | the standard IEEE 754 format. Returns a reference to the stream. | - | ||||||||||||||||||||||||
1192 | - | |||||||||||||||||||||||||
1193 | \sa setFloatingPointPrecision() | - | ||||||||||||||||||||||||
1194 | */ | - | ||||||||||||||||||||||||
1195 | - | |||||||||||||||||||||||||
1196 | QDataStream &QDataStream::operator<<(float f) | - | ||||||||||||||||||||||||
1197 | { | - | ||||||||||||||||||||||||
1198 | if (version() >= QDataStream::Qt_4_6 | - | ||||||||||||||||||||||||
1199 | && floatingPointPrecision() == QDataStream::DoublePrecision) { | - | ||||||||||||||||||||||||
1200 | *this << double(f); | - | ||||||||||||||||||||||||
1201 | return *this; | - | ||||||||||||||||||||||||
1202 | } | - | ||||||||||||||||||||||||
1203 | - | |||||||||||||||||||||||||
1204 | CHECK_STREAM_WRITE_PRECOND(*this) | - | ||||||||||||||||||||||||
1205 | float g = f; // fixes float-on-stack problem | - | ||||||||||||||||||||||||
1206 | if (!noswap) { | - | ||||||||||||||||||||||||
1207 | union { | - | ||||||||||||||||||||||||
1208 | float val1; | - | ||||||||||||||||||||||||
1209 | quint32 val2; | - | ||||||||||||||||||||||||
1210 | } x; | - | ||||||||||||||||||||||||
1211 | x.val1 = g; | - | ||||||||||||||||||||||||
1212 | x.val2 = qbswap(x.val2); | - | ||||||||||||||||||||||||
1213 | - | |||||||||||||||||||||||||
1214 | if (dev->write((char *)&x.val2, sizeof(float)) != sizeof(float)) | - | ||||||||||||||||||||||||
1215 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1216 | return *this; | - | ||||||||||||||||||||||||
1217 | } | - | ||||||||||||||||||||||||
1218 | - | |||||||||||||||||||||||||
1219 | if (dev->write((char *)&g, sizeof(float)) != sizeof(float)) | - | ||||||||||||||||||||||||
1220 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1221 | return *this; | - | ||||||||||||||||||||||||
1222 | } | - | ||||||||||||||||||||||||
1223 | - | |||||||||||||||||||||||||
1224 | - | |||||||||||||||||||||||||
1225 | /*! | - | ||||||||||||||||||||||||
1226 | \overload | - | ||||||||||||||||||||||||
1227 | - | |||||||||||||||||||||||||
1228 | Writes a floating point number, \a f, to the stream using | - | ||||||||||||||||||||||||
1229 | the standard IEEE 754 format. Returns a reference to the stream. | - | ||||||||||||||||||||||||
1230 | - | |||||||||||||||||||||||||
1231 | \sa setFloatingPointPrecision() | - | ||||||||||||||||||||||||
1232 | */ | - | ||||||||||||||||||||||||
1233 | - | |||||||||||||||||||||||||
1234 | QDataStream &QDataStream::operator<<(double f) | - | ||||||||||||||||||||||||
1235 | { | - | ||||||||||||||||||||||||
1236 | if (version() >= QDataStream::Qt_4_6 | - | ||||||||||||||||||||||||
1237 | && floatingPointPrecision() == QDataStream::SinglePrecision) { | - | ||||||||||||||||||||||||
1238 | *this << float(f); | - | ||||||||||||||||||||||||
1239 | return *this; | - | ||||||||||||||||||||||||
1240 | } | - | ||||||||||||||||||||||||
1241 | - | |||||||||||||||||||||||||
1242 | CHECK_STREAM_WRITE_PRECOND(*this) | - | ||||||||||||||||||||||||
1243 | if (noswap) { | - | ||||||||||||||||||||||||
1244 | if (dev->write((char *)&f, sizeof(double)) != sizeof(double)) | - | ||||||||||||||||||||||||
1245 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1246 | } else { | - | ||||||||||||||||||||||||
1247 | union { | - | ||||||||||||||||||||||||
1248 | double val1; | - | ||||||||||||||||||||||||
1249 | quint64 val2; | - | ||||||||||||||||||||||||
1250 | } x; | - | ||||||||||||||||||||||||
1251 | x.val1 = f; | - | ||||||||||||||||||||||||
1252 | x.val2 = qbswap(x.val2); | - | ||||||||||||||||||||||||
1253 | if (dev->write((char *)&x.val2, sizeof(double)) != sizeof(double)) | - | ||||||||||||||||||||||||
1254 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1255 | } | - | ||||||||||||||||||||||||
1256 | return *this; | - | ||||||||||||||||||||||||
1257 | } | - | ||||||||||||||||||||||||
1258 | - | |||||||||||||||||||||||||
1259 | - | |||||||||||||||||||||||||
1260 | /*! | - | ||||||||||||||||||||||||
1261 | \overload | - | ||||||||||||||||||||||||
1262 | - | |||||||||||||||||||||||||
1263 | Writes the '\\0'-terminated string \a s to the stream and returns a | - | ||||||||||||||||||||||||
1264 | reference to the stream. | - | ||||||||||||||||||||||||
1265 | - | |||||||||||||||||||||||||
1266 | The string is serialized using \c{writeBytes()}. | - | ||||||||||||||||||||||||
1267 | - | |||||||||||||||||||||||||
1268 | \sa writeBytes(), writeRawData() | - | ||||||||||||||||||||||||
1269 | */ | - | ||||||||||||||||||||||||
1270 | - | |||||||||||||||||||||||||
1271 | QDataStream &QDataStream::operator<<(const char *s) | - | ||||||||||||||||||||||||
1272 | { | - | ||||||||||||||||||||||||
1273 | if (!s) { | - | ||||||||||||||||||||||||
1274 | *this << (quint32)0; | - | ||||||||||||||||||||||||
1275 | return *this; | - | ||||||||||||||||||||||||
1276 | } | - | ||||||||||||||||||||||||
1277 | uint len = qstrlen(s) + 1; // also write null terminator | - | ||||||||||||||||||||||||
1278 | *this << (quint32)len; // write length specifier | - | ||||||||||||||||||||||||
1279 | writeRawData(s, len); | - | ||||||||||||||||||||||||
1280 | return *this; | - | ||||||||||||||||||||||||
1281 | } | - | ||||||||||||||||||||||||
1282 | - | |||||||||||||||||||||||||
1283 | - | |||||||||||||||||||||||||
1284 | /*! | - | ||||||||||||||||||||||||
1285 | Writes the length specifier \a len and the buffer \a s to the | - | ||||||||||||||||||||||||
1286 | stream and returns a reference to the stream. | - | ||||||||||||||||||||||||
1287 | - | |||||||||||||||||||||||||
1288 | The \a len is serialized as a quint32, followed by \a len bytes | - | ||||||||||||||||||||||||
1289 | from \a s. Note that the data is \e not encoded. | - | ||||||||||||||||||||||||
1290 | - | |||||||||||||||||||||||||
1291 | \sa writeRawData(), readBytes() | - | ||||||||||||||||||||||||
1292 | */ | - | ||||||||||||||||||||||||
1293 | - | |||||||||||||||||||||||||
1294 | QDataStream &QDataStream::writeBytes(const char *s, uint len) | - | ||||||||||||||||||||||||
1295 | { | - | ||||||||||||||||||||||||
1296 | CHECK_STREAM_WRITE_PRECOND(*this) | - | ||||||||||||||||||||||||
1297 | *this << (quint32)len; // write length specifier | - | ||||||||||||||||||||||||
1298 | if (len) | - | ||||||||||||||||||||||||
1299 | writeRawData(s, len); | - | ||||||||||||||||||||||||
1300 | return *this; | - | ||||||||||||||||||||||||
1301 | } | - | ||||||||||||||||||||||||
1302 | - | |||||||||||||||||||||||||
1303 | - | |||||||||||||||||||||||||
1304 | /*! | - | ||||||||||||||||||||||||
1305 | Writes \a len bytes from \a s to the stream. Returns the | - | ||||||||||||||||||||||||
1306 | number of bytes actually written, or -1 on error. | - | ||||||||||||||||||||||||
1307 | The data is \e not encoded. | - | ||||||||||||||||||||||||
1308 | - | |||||||||||||||||||||||||
1309 | \sa writeBytes(), QIODevice::write(), readRawData() | - | ||||||||||||||||||||||||
1310 | */ | - | ||||||||||||||||||||||||
1311 | - | |||||||||||||||||||||||||
1312 | int QDataStream::writeRawData(const char *s, int len) | - | ||||||||||||||||||||||||
1313 | { | - | ||||||||||||||||||||||||
1314 | CHECK_STREAM_WRITE_PRECOND(-1) | - | ||||||||||||||||||||||||
1315 | int ret = dev->write(s, len); | - | ||||||||||||||||||||||||
1316 | if (ret != len) | - | ||||||||||||||||||||||||
1317 | q_status = WriteFailed; | - | ||||||||||||||||||||||||
1318 | return ret; | - | ||||||||||||||||||||||||
1319 | } | - | ||||||||||||||||||||||||
1320 | - | |||||||||||||||||||||||||
1321 | /*! | - | ||||||||||||||||||||||||
1322 | \since 4.1 | - | ||||||||||||||||||||||||
1323 | - | |||||||||||||||||||||||||
1324 | Skips \a len bytes from the device. Returns the number of bytes | - | ||||||||||||||||||||||||
1325 | actually skipped, or -1 on error. | - | ||||||||||||||||||||||||
1326 | - | |||||||||||||||||||||||||
1327 | This is equivalent to calling readRawData() on a buffer of length | - | ||||||||||||||||||||||||
1328 | \a len and ignoring the buffer. | - | ||||||||||||||||||||||||
1329 | - | |||||||||||||||||||||||||
1330 | \sa QIODevice::seek() | - | ||||||||||||||||||||||||
1331 | */ | - | ||||||||||||||||||||||||
1332 | int QDataStream::skipRawData(int len) | - | ||||||||||||||||||||||||
1333 | { | - | ||||||||||||||||||||||||
1334 | CHECK_STREAM_PRECOND(-1) never executed: return -1;
| 0-24 | ||||||||||||||||||||||||
1335 | - | |||||||||||||||||||||||||
1336 | if (dev->isSequential()) {
| 3-21 | ||||||||||||||||||||||||
1337 | char buf[4096]; | - | ||||||||||||||||||||||||
1338 | int sumRead = 0; | - | ||||||||||||||||||||||||
1339 | - | |||||||||||||||||||||||||
1340 | while (len > 0) {
| 3-9 | ||||||||||||||||||||||||
1341 | int blockSize = qMin(len, (int)sizeof(buf)); | - | ||||||||||||||||||||||||
1342 | int n = dev->readreadBlock(buf, blockSize); | - | ||||||||||||||||||||||||
1343 | if (n == -1)
| 0-9 | ||||||||||||||||||||||||
1344 | return -1; never executed: return -1; | 0 | ||||||||||||||||||||||||
1345 | if (n == 0)
| 0-9 | ||||||||||||||||||||||||
1346 | return sumRead; never executed: return sumRead; | 0 | ||||||||||||||||||||||||
1347 | - | |||||||||||||||||||||||||
1348 | sumRead += n; | - | ||||||||||||||||||||||||
1349 | len -= blockSize; | - | ||||||||||||||||||||||||
1350 | } executed 9 times by 1 test: end of block Executed by:
| 9 | ||||||||||||||||||||||||
1351 | return sumRead; executed 3 times by 1 test: return sumRead; Executed by:
| 3 | ||||||||||||||||||||||||
1352 | } else { | - | ||||||||||||||||||||||||
1353 | qint64 pos = dev->pos(); | - | ||||||||||||||||||||||||
1354 | qint64 size = dev->size(); | - | ||||||||||||||||||||||||
1355 | if (pos + len > size)
| 1-20 | ||||||||||||||||||||||||
1356 | len = size - pos; executed 1 time by 1 test: len = size - pos; Executed by:
| 1 | ||||||||||||||||||||||||
1357 | if (!dev->seek(pos + len))
| 0-21 | ||||||||||||||||||||||||
1358 | return -1; never executed: return -1; | 0 | ||||||||||||||||||||||||
1359 | return len; executed 21 times by 2 tests: return len; Executed by:
| 21 | ||||||||||||||||||||||||
1360 | } | - | ||||||||||||||||||||||||
1361 | } | - | ||||||||||||||||||||||||
1362 | - | |||||||||||||||||||||||||
1363 | QT_END_NAMESPACE | - | ||||||||||||||||||||||||
1364 | - | |||||||||||||||||||||||||
1365 | #endif // QT_NO_DATASTREAM | - | ||||||||||||||||||||||||
Source code | Switch to Preprocessed file |