| Absolute File Name: | /home/qt/qt5_coco/qt5/qtbase/src/corelib/json/qjsonarray.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 <qjsonobject.h> | - | ||||||||||||||||||
| 41 | #include <qjsonvalue.h> | - | ||||||||||||||||||
| 42 | #include <qjsonarray.h> | - | ||||||||||||||||||
| 43 | #include <qstringlist.h> | - | ||||||||||||||||||
| 44 | #include <qvariant.h> | - | ||||||||||||||||||
| 45 | #include <qdebug.h> | - | ||||||||||||||||||
| 46 | - | |||||||||||||||||||
| 47 | #include "qjsonwriter_p.h" | - | ||||||||||||||||||
| 48 | #include "qjson_p.h" | - | ||||||||||||||||||
| 49 | - | |||||||||||||||||||
| 50 | QT_BEGIN_NAMESPACE | - | ||||||||||||||||||
| 51 | - | |||||||||||||||||||
| 52 | /*! | - | ||||||||||||||||||
| 53 | \class QJsonArray | - | ||||||||||||||||||
| 54 | \inmodule QtCore | - | ||||||||||||||||||
| 55 | \ingroup json | - | ||||||||||||||||||
| 56 | \ingroup shared | - | ||||||||||||||||||
| 57 | \reentrant | - | ||||||||||||||||||
| 58 | \since 5.0 | - | ||||||||||||||||||
| 59 | - | |||||||||||||||||||
| 60 | \brief The QJsonArray class encapsulates a JSON array. | - | ||||||||||||||||||
| 61 | - | |||||||||||||||||||
| 62 | A JSON array is a list of values. The list can be manipulated by inserting and | - | ||||||||||||||||||
| 63 | removing QJsonValue's from the array. | - | ||||||||||||||||||
| 64 | - | |||||||||||||||||||
| 65 | A QJsonArray can be converted to and from a QVariantList. You can query the | - | ||||||||||||||||||
| 66 | number of entries with size(), insert(), and removeAt() entries from it | - | ||||||||||||||||||
| 67 | and iterate over its content using the standard C++ iterator pattern. | - | ||||||||||||||||||
| 68 | - | |||||||||||||||||||
| 69 | QJsonArray is an implicitly shared class and shares the data with the document | - | ||||||||||||||||||
| 70 | it has been created from as long as it is not being modified. | - | ||||||||||||||||||
| 71 | - | |||||||||||||||||||
| 72 | You can convert the array to and from text based JSON through QJsonDocument. | - | ||||||||||||||||||
| 73 | - | |||||||||||||||||||
| 74 | \sa {JSON Support in Qt}, {JSON Save Game Example} | - | ||||||||||||||||||
| 75 | */ | - | ||||||||||||||||||
| 76 | - | |||||||||||||||||||
| 77 | /*! | - | ||||||||||||||||||
| 78 | \typedef QJsonArray::Iterator | - | ||||||||||||||||||
| 79 | - | |||||||||||||||||||
| 80 | Qt-style synonym for QJsonArray::iterator. | - | ||||||||||||||||||
| 81 | */ | - | ||||||||||||||||||
| 82 | - | |||||||||||||||||||
| 83 | /*! | - | ||||||||||||||||||
| 84 | \typedef QJsonArray::ConstIterator | - | ||||||||||||||||||
| 85 | - | |||||||||||||||||||
| 86 | Qt-style synonym for QJsonArray::const_iterator. | - | ||||||||||||||||||
| 87 | */ | - | ||||||||||||||||||
| 88 | - | |||||||||||||||||||
| 89 | /*! | - | ||||||||||||||||||
| 90 | \typedef QJsonArray::size_type | - | ||||||||||||||||||
| 91 | - | |||||||||||||||||||
| 92 | Typedef for int. Provided for STL compatibility. | - | ||||||||||||||||||
| 93 | */ | - | ||||||||||||||||||
| 94 | - | |||||||||||||||||||
| 95 | /*! | - | ||||||||||||||||||
| 96 | \typedef QJsonArray::value_type | - | ||||||||||||||||||
| 97 | - | |||||||||||||||||||
| 98 | Typedef for QJsonValue. Provided for STL compatibility. | - | ||||||||||||||||||
| 99 | */ | - | ||||||||||||||||||
| 100 | - | |||||||||||||||||||
| 101 | /*! | - | ||||||||||||||||||
| 102 | \typedef QJsonArray::difference_type | - | ||||||||||||||||||
| 103 | - | |||||||||||||||||||
| 104 | Typedef for int. Provided for STL compatibility. | - | ||||||||||||||||||
| 105 | */ | - | ||||||||||||||||||
| 106 | - | |||||||||||||||||||
| 107 | /*! | - | ||||||||||||||||||
| 108 | \typedef QJsonArray::pointer | - | ||||||||||||||||||
| 109 | - | |||||||||||||||||||
| 110 | Typedef for QJsonValue *. Provided for STL compatibility. | - | ||||||||||||||||||
| 111 | */ | - | ||||||||||||||||||
| 112 | - | |||||||||||||||||||
| 113 | /*! | - | ||||||||||||||||||
| 114 | \typedef QJsonArray::const_pointer | - | ||||||||||||||||||
| 115 | - | |||||||||||||||||||
| 116 | Typedef for const QJsonValue *. Provided for STL compatibility. | - | ||||||||||||||||||
| 117 | */ | - | ||||||||||||||||||
| 118 | - | |||||||||||||||||||
| 119 | /*! | - | ||||||||||||||||||
| 120 | \typedef QJsonArray::reference | - | ||||||||||||||||||
| 121 | - | |||||||||||||||||||
| 122 | Typedef for QJsonValue &. Provided for STL compatibility. | - | ||||||||||||||||||
| 123 | */ | - | ||||||||||||||||||
| 124 | - | |||||||||||||||||||
| 125 | /*! | - | ||||||||||||||||||
| 126 | \typedef QJsonArray::const_reference | - | ||||||||||||||||||
| 127 | - | |||||||||||||||||||
| 128 | Typedef for const QJsonValue &. Provided for STL compatibility. | - | ||||||||||||||||||
| 129 | */ | - | ||||||||||||||||||
| 130 | - | |||||||||||||||||||
| 131 | /*! | - | ||||||||||||||||||
| 132 | Creates an empty array. | - | ||||||||||||||||||
| 133 | */ | - | ||||||||||||||||||
| 134 | QJsonArray::QJsonArray() | - | ||||||||||||||||||
| 135 | : d(0), a(0) | - | ||||||||||||||||||
| 136 | { | - | ||||||||||||||||||
| 137 | } executed 42110 times by 117 tests: end of blockExecuted by:
| 42110 | ||||||||||||||||||
| 138 | - | |||||||||||||||||||
| 139 | /*! | - | ||||||||||||||||||
| 140 | \fn QJsonArray::QJsonArray(std::initializer_list<QJsonValue> args) | - | ||||||||||||||||||
| 141 | \since 5.4 | - | ||||||||||||||||||
| 142 | Creates an array initialized from \a args initialization list. | - | ||||||||||||||||||
| 143 | - | |||||||||||||||||||
| 144 | QJsonArray can be constructed in a way similar to JSON notation, | - | ||||||||||||||||||
| 145 | for example: | - | ||||||||||||||||||
| 146 | \code | - | ||||||||||||||||||
| 147 | QJsonArray array = { 1, 2.2, QString() }; | - | ||||||||||||||||||
| 148 | \endcode | - | ||||||||||||||||||
| 149 | */ | - | ||||||||||||||||||
| 150 | - | |||||||||||||||||||
| 151 | /*! | - | ||||||||||||||||||
| 152 | \internal | - | ||||||||||||||||||
| 153 | */ | - | ||||||||||||||||||
| 154 | QJsonArray::QJsonArray(QJsonPrivate::Data *data, QJsonPrivate::Array *array) | - | ||||||||||||||||||
| 155 | : d(data), a(array) | - | ||||||||||||||||||
| 156 | { | - | ||||||||||||||||||
| 157 | Q_ASSERT(data); | - | ||||||||||||||||||
| 158 | Q_ASSERT(array); | - | ||||||||||||||||||
| 159 | d->ref.ref(); | - | ||||||||||||||||||
| 160 | } executed 42001 times by 114 tests: end of blockExecuted by:
| 42001 | ||||||||||||||||||
| 161 | - | |||||||||||||||||||
| 162 | /*! | - | ||||||||||||||||||
| 163 | This method replaces part of QJsonArray(std::initializer_list<QJsonValue> args) . | - | ||||||||||||||||||
| 164 | The constructor needs to be inline, but we do not want to leak implementation details | - | ||||||||||||||||||
| 165 | of this class. | - | ||||||||||||||||||
| 166 | \note this method is called for an uninitialized object | - | ||||||||||||||||||
| 167 | \internal | - | ||||||||||||||||||
| 168 | */ | - | ||||||||||||||||||
| 169 | void QJsonArray::initialize() | - | ||||||||||||||||||
| 170 | { | - | ||||||||||||||||||
| 171 | d = 0; | - | ||||||||||||||||||
| 172 | a = 0; | - | ||||||||||||||||||
| 173 | } never executed: end of block | 0 | ||||||||||||||||||
| 174 | - | |||||||||||||||||||
| 175 | /*! | - | ||||||||||||||||||
| 176 | Deletes the array. | - | ||||||||||||||||||
| 177 | */ | - | ||||||||||||||||||
| 178 | QJsonArray::~QJsonArray() | - | ||||||||||||||||||
| 179 | { | - | ||||||||||||||||||
| 180 | if (d && !d->ref.deref())
| 2-42449 | ||||||||||||||||||
| 181 | delete d; executed 2 times by 1 test: delete d;Executed by:
| 2 | ||||||||||||||||||
| 182 | } executed 84597 times by 117 tests: end of blockExecuted by:
| 84597 | ||||||||||||||||||
| 183 | - | |||||||||||||||||||
| 184 | /*! | - | ||||||||||||||||||
| 185 | Creates a copy of \a other. | - | ||||||||||||||||||
| 186 | - | |||||||||||||||||||
| 187 | Since QJsonArray is implicitly shared, the copy is shallow | - | ||||||||||||||||||
| 188 | as long as the object doesn't get modified. | - | ||||||||||||||||||
| 189 | */ | - | ||||||||||||||||||
| 190 | QJsonArray::QJsonArray(const QJsonArray &other) | - | ||||||||||||||||||
| 191 | { | - | ||||||||||||||||||
| 192 | d = other.d; | - | ||||||||||||||||||
| 193 | a = other.a; | - | ||||||||||||||||||
| 194 | if (d)
| 45-441 | ||||||||||||||||||
| 195 | d->ref.ref(); executed 441 times by 2 tests: d->ref.ref();Executed by:
| 441 | ||||||||||||||||||
| 196 | } executed 486 times by 5 tests: end of blockExecuted by:
| 486 | ||||||||||||||||||
| 197 | - | |||||||||||||||||||
| 198 | /*! | - | ||||||||||||||||||
| 199 | Assigns \a other to this array. | - | ||||||||||||||||||
| 200 | */ | - | ||||||||||||||||||
| 201 | QJsonArray &QJsonArray::operator =(const QJsonArray &other) | - | ||||||||||||||||||
| 202 | { | - | ||||||||||||||||||
| 203 | if (d != other.d) {
| 5-41 | ||||||||||||||||||
| 204 | if (d && !d->ref.deref())
| 0-5 | ||||||||||||||||||
| 205 | delete d; never executed: delete d; | 0 | ||||||||||||||||||
| 206 | d = other.d; | - | ||||||||||||||||||
| 207 | if (d)
| 0-5 | ||||||||||||||||||
| 208 | d->ref.ref(); executed 5 times by 1 test: d->ref.ref();Executed by:
| 5 | ||||||||||||||||||
| 209 | } executed 5 times by 1 test: end of blockExecuted by:
| 5 | ||||||||||||||||||
| 210 | a = other.a; | - | ||||||||||||||||||
| 211 | - | |||||||||||||||||||
| 212 | return *this; executed 46 times by 2 tests: return *this;Executed by:
| 46 | ||||||||||||||||||
| 213 | } | - | ||||||||||||||||||
| 214 | - | |||||||||||||||||||
| 215 | /*! \fn QJsonArray &QJsonArray::operator+=(const QJsonValue &value) | - | ||||||||||||||||||
| 216 | - | |||||||||||||||||||
| 217 | Appends \a value to the array, and returns a reference to the array itself. | - | ||||||||||||||||||
| 218 | - | |||||||||||||||||||
| 219 | \since 5.3 | - | ||||||||||||||||||
| 220 | \sa append(), operator<<() | - | ||||||||||||||||||
| 221 | */ | - | ||||||||||||||||||
| 222 | - | |||||||||||||||||||
| 223 | /*! \fn QJsonArray QJsonArray::operator+(const QJsonValue &value) const | - | ||||||||||||||||||
| 224 | - | |||||||||||||||||||
| 225 | Returns an array that contains all the items in this array followed | - | ||||||||||||||||||
| 226 | by the provided \a value. | - | ||||||||||||||||||
| 227 | - | |||||||||||||||||||
| 228 | \since 5.3 | - | ||||||||||||||||||
| 229 | \sa operator+=() | - | ||||||||||||||||||
| 230 | */ | - | ||||||||||||||||||
| 231 | - | |||||||||||||||||||
| 232 | /*! \fn QJsonArray &QJsonArray::operator<<(const QJsonValue &value) | - | ||||||||||||||||||
| 233 | - | |||||||||||||||||||
| 234 | Appends \a value to the array, and returns a reference to the array itself. | - | ||||||||||||||||||
| 235 | - | |||||||||||||||||||
| 236 | \since 5.3 | - | ||||||||||||||||||
| 237 | \sa operator+=(), append() | - | ||||||||||||||||||
| 238 | */ | - | ||||||||||||||||||
| 239 | - | |||||||||||||||||||
| 240 | /*! | - | ||||||||||||||||||
| 241 | Converts the string list \a list to a QJsonArray. | - | ||||||||||||||||||
| 242 | - | |||||||||||||||||||
| 243 | The values in \a list will be converted to JSON values. | - | ||||||||||||||||||
| 244 | - | |||||||||||||||||||
| 245 | \sa toVariantList(), QJsonValue::fromVariant() | - | ||||||||||||||||||
| 246 | */ | - | ||||||||||||||||||
| 247 | QJsonArray QJsonArray::fromStringList(const QStringList &list) | - | ||||||||||||||||||
| 248 | { | - | ||||||||||||||||||
| 249 | QJsonArray array; | - | ||||||||||||||||||
| 250 | for (QStringList::const_iterator it = list.constBegin(); it != list.constEnd(); ++it)
| 0 | ||||||||||||||||||
| 251 | array.append(QJsonValue(*it)); never executed: array.append(QJsonValue(*it)); | 0 | ||||||||||||||||||
| 252 | return array; never executed: return array; | 0 | ||||||||||||||||||
| 253 | } | - | ||||||||||||||||||
| 254 | - | |||||||||||||||||||
| 255 | /*! | - | ||||||||||||||||||
| 256 | Converts the variant list \a list to a QJsonArray. | - | ||||||||||||||||||
| 257 | - | |||||||||||||||||||
| 258 | The QVariant values in \a list will be converted to JSON values. | - | ||||||||||||||||||
| 259 | - | |||||||||||||||||||
| 260 | \sa toVariantList(), QJsonValue::fromVariant() | - | ||||||||||||||||||
| 261 | */ | - | ||||||||||||||||||
| 262 | QJsonArray QJsonArray::fromVariantList(const QVariantList &list) | - | ||||||||||||||||||
| 263 | { | - | ||||||||||||||||||
| 264 | QJsonArray array; | - | ||||||||||||||||||
| 265 | if (list.isEmpty())
| 0 | ||||||||||||||||||
| 266 | return array; never executed: return array; | 0 | ||||||||||||||||||
| 267 | - | |||||||||||||||||||
| 268 | array.detach2(1024); | - | ||||||||||||||||||
| 269 | - | |||||||||||||||||||
| 270 | QVector<QJsonPrivate::Value> values; | - | ||||||||||||||||||
| 271 | values.resize(list.size()); | - | ||||||||||||||||||
| 272 | QJsonPrivate::Value *valueData = values.data(); | - | ||||||||||||||||||
| 273 | uint currentOffset = sizeof(QJsonPrivate::Base); | - | ||||||||||||||||||
| 274 | - | |||||||||||||||||||
| 275 | for (int i = 0; i < list.size(); ++i) {
| 0 | ||||||||||||||||||
| 276 | QJsonValue val = QJsonValue::fromVariant(list.at(i)); | - | ||||||||||||||||||
| 277 | - | |||||||||||||||||||
| 278 | bool latinOrIntValue; | - | ||||||||||||||||||
| 279 | int valueSize = QJsonPrivate::Value::requiredStorage(val, &latinOrIntValue); | - | ||||||||||||||||||
| 280 | - | |||||||||||||||||||
| 281 | if (!array.detach2(valueSize))
| 0 | ||||||||||||||||||
| 282 | return QJsonArray(); never executed: return QJsonArray(); | 0 | ||||||||||||||||||
| 283 | - | |||||||||||||||||||
| 284 | QJsonPrivate::Value *v = valueData + i; | - | ||||||||||||||||||
| 285 | v->type = (val.t == QJsonValue::Undefined ? QJsonValue::Null : val.t);
| 0 | ||||||||||||||||||
| 286 | v->latinOrIntValue = latinOrIntValue; | - | ||||||||||||||||||
| 287 | v->latinKey = false; | - | ||||||||||||||||||
| 288 | v->value = QJsonPrivate::Value::valueToStore(val, currentOffset); | - | ||||||||||||||||||
| 289 | if (valueSize)
| 0 | ||||||||||||||||||
| 290 | QJsonPrivate::Value::copyData(val, (char *)array.a + currentOffset, latinOrIntValue); never executed: QJsonPrivate::Value::copyData(val, (char *)array.a + currentOffset, latinOrIntValue); | 0 | ||||||||||||||||||
| 291 | - | |||||||||||||||||||
| 292 | currentOffset += valueSize; | - | ||||||||||||||||||
| 293 | array.a->size = currentOffset; | - | ||||||||||||||||||
| 294 | } never executed: end of block | 0 | ||||||||||||||||||
| 295 | - | |||||||||||||||||||
| 296 | // write table | - | ||||||||||||||||||
| 297 | array.a->tableOffset = currentOffset; | - | ||||||||||||||||||
| 298 | if (!array.detach2(sizeof(QJsonPrivate::offset)*values.size()))
| 0 | ||||||||||||||||||
| 299 | return QJsonArray(); never executed: return QJsonArray(); | 0 | ||||||||||||||||||
| 300 | memcpy(array.a->table(), values.constData(), values.size()*sizeof(uint)); | - | ||||||||||||||||||
| 301 | array.a->length = values.size(); | - | ||||||||||||||||||
| 302 | array.a->size = currentOffset + sizeof(QJsonPrivate::offset)*values.size(); | - | ||||||||||||||||||
| 303 | - | |||||||||||||||||||
| 304 | return array; never executed: return array; | 0 | ||||||||||||||||||
| 305 | } | - | ||||||||||||||||||
| 306 | - | |||||||||||||||||||
| 307 | /*! | - | ||||||||||||||||||
| 308 | Converts this object to a QVariantList. | - | ||||||||||||||||||
| 309 | - | |||||||||||||||||||
| 310 | Returns the created map. | - | ||||||||||||||||||
| 311 | */ | - | ||||||||||||||||||
| 312 | QVariantList QJsonArray::toVariantList() const | - | ||||||||||||||||||
| 313 | { | - | ||||||||||||||||||
| 314 | QVariantList list; | - | ||||||||||||||||||
| 315 | - | |||||||||||||||||||
| 316 | if (a) {
| 0 | ||||||||||||||||||
| 317 | list.reserve(a->length); | - | ||||||||||||||||||
| 318 | for (int i = 0; i < (int)a->length; ++i)
| 0 | ||||||||||||||||||
| 319 | list.append(QJsonValue(d, a, a->at(i)).toVariant()); never executed: list.append(QJsonValue(d, a, a->at(i)).toVariant()); | 0 | ||||||||||||||||||
| 320 | } never executed: end of block | 0 | ||||||||||||||||||
| 321 | return list; never executed: return list; | 0 | ||||||||||||||||||
| 322 | } | - | ||||||||||||||||||
| 323 | - | |||||||||||||||||||
| 324 | - | |||||||||||||||||||
| 325 | /*! | - | ||||||||||||||||||
| 326 | Returns the number of values stored in the array. | - | ||||||||||||||||||
| 327 | */ | - | ||||||||||||||||||
| 328 | int QJsonArray::size() const | - | ||||||||||||||||||
| 329 | { | - | ||||||||||||||||||
| 330 | if (!d)
| 2-42948 | ||||||||||||||||||
| 331 | return 0; executed 2 times by 1 test: return 0;Executed by:
| 2 | ||||||||||||||||||
| 332 | - | |||||||||||||||||||
| 333 | return (int)a->length; executed 42948 times by 114 tests: return (int)a->length;Executed by:
| 42948 | ||||||||||||||||||
| 334 | } | - | ||||||||||||||||||
| 335 | - | |||||||||||||||||||
| 336 | /*! | - | ||||||||||||||||||
| 337 | \fn QJsonArray::count() const | - | ||||||||||||||||||
| 338 | - | |||||||||||||||||||
| 339 | Same as size(). | - | ||||||||||||||||||
| 340 | - | |||||||||||||||||||
| 341 | \sa size() | - | ||||||||||||||||||
| 342 | */ | - | ||||||||||||||||||
| 343 | - | |||||||||||||||||||
| 344 | /*! | - | ||||||||||||||||||
| 345 | Returns \c true if the object is empty. This is the same as size() == 0. | - | ||||||||||||||||||
| 346 | - | |||||||||||||||||||
| 347 | \sa size() | - | ||||||||||||||||||
| 348 | */ | - | ||||||||||||||||||
| 349 | bool QJsonArray::isEmpty() const | - | ||||||||||||||||||
| 350 | { | - | ||||||||||||||||||
| 351 | if (!d)
| 3-18 | ||||||||||||||||||
| 352 | return true; executed 18 times by 1 test: return true;Executed by:
| 18 | ||||||||||||||||||
| 353 | - | |||||||||||||||||||
| 354 | return !a->length; executed 3 times by 1 test: return !a->length;Executed by:
| 3 | ||||||||||||||||||
| 355 | } | - | ||||||||||||||||||
| 356 | - | |||||||||||||||||||
| 357 | /*! | - | ||||||||||||||||||
| 358 | Returns a QJsonValue representing the value for index \a i. | - | ||||||||||||||||||
| 359 | - | |||||||||||||||||||
| 360 | The returned QJsonValue is \c Undefined, if \a i is out of bounds. | - | ||||||||||||||||||
| 361 | - | |||||||||||||||||||
| 362 | */ | - | ||||||||||||||||||
| 363 | QJsonValue QJsonArray::at(int i) const | - | ||||||||||||||||||
| 364 | { | - | ||||||||||||||||||
| 365 | if (!a || i < 0 || i >= (int)a->length)
| 0-68845 | ||||||||||||||||||
| 366 | return QJsonValue(QJsonValue::Undefined); executed 2 times by 2 tests: return QJsonValue(QJsonValue::Undefined);Executed by:
| 2 | ||||||||||||||||||
| 367 | - | |||||||||||||||||||
| 368 | return QJsonValue(d, a, a->at(i)); executed 68843 times by 114 tests: return QJsonValue(d, a, a->at(i));Executed by:
| 68843 | ||||||||||||||||||
| 369 | } | - | ||||||||||||||||||
| 370 | - | |||||||||||||||||||
| 371 | /*! | - | ||||||||||||||||||
| 372 | Returns the first value stored in the array. | - | ||||||||||||||||||
| 373 | - | |||||||||||||||||||
| 374 | Same as \c at(0). | - | ||||||||||||||||||
| 375 | - | |||||||||||||||||||
| 376 | \sa at() | - | ||||||||||||||||||
| 377 | */ | - | ||||||||||||||||||
| 378 | QJsonValue QJsonArray::first() const | - | ||||||||||||||||||
| 379 | { | - | ||||||||||||||||||
| 380 | return at(0); never executed: return at(0); | 0 | ||||||||||||||||||
| 381 | } | - | ||||||||||||||||||
| 382 | - | |||||||||||||||||||
| 383 | /*! | - | ||||||||||||||||||
| 384 | Returns the last value stored in the array. | - | ||||||||||||||||||
| 385 | - | |||||||||||||||||||
| 386 | Same as \c{at(size() - 1)}. | - | ||||||||||||||||||
| 387 | - | |||||||||||||||||||
| 388 | \sa at() | - | ||||||||||||||||||
| 389 | */ | - | ||||||||||||||||||
| 390 | QJsonValue QJsonArray::last() const | - | ||||||||||||||||||
| 391 | { | - | ||||||||||||||||||
| 392 | return at(a ? (a->length - 1) : 0); never executed: return at(a ? (a->length - 1) : 0); | 0 | ||||||||||||||||||
| 393 | } | - | ||||||||||||||||||
| 394 | - | |||||||||||||||||||
| 395 | /*! | - | ||||||||||||||||||
| 396 | Inserts \a value at the beginning of the array. | - | ||||||||||||||||||
| 397 | - | |||||||||||||||||||
| 398 | This is the same as \c{insert(0, value)} and will prepend \a value to the array. | - | ||||||||||||||||||
| 399 | - | |||||||||||||||||||
| 400 | \sa append(), insert() | - | ||||||||||||||||||
| 401 | */ | - | ||||||||||||||||||
| 402 | void QJsonArray::prepend(const QJsonValue &value) | - | ||||||||||||||||||
| 403 | { | - | ||||||||||||||||||
| 404 | insert(0, value); | - | ||||||||||||||||||
| 405 | } never executed: end of block | 0 | ||||||||||||||||||
| 406 | - | |||||||||||||||||||
| 407 | /*! | - | ||||||||||||||||||
| 408 | Inserts \a value at the end of the array. | - | ||||||||||||||||||
| 409 | - | |||||||||||||||||||
| 410 | \sa prepend(), insert() | - | ||||||||||||||||||
| 411 | */ | - | ||||||||||||||||||
| 412 | void QJsonArray::append(const QJsonValue &value) | - | ||||||||||||||||||
| 413 | { | - | ||||||||||||||||||
| 414 | insert(a ? (int)a->length : 0, value); | - | ||||||||||||||||||
| 415 | } executed 8 times by 1 test: end of blockExecuted by:
| 8 | ||||||||||||||||||
| 416 | - | |||||||||||||||||||
| 417 | /*! | - | ||||||||||||||||||
| 418 | Removes the value at index position \a i. \a i must be a valid | - | ||||||||||||||||||
| 419 | index position in the array (i.e., \c{0 <= i < size()}). | - | ||||||||||||||||||
| 420 | - | |||||||||||||||||||
| 421 | \sa insert(), replace() | - | ||||||||||||||||||
| 422 | */ | - | ||||||||||||||||||
| 423 | void QJsonArray::removeAt(int i) | - | ||||||||||||||||||
| 424 | { | - | ||||||||||||||||||
| 425 | if (!a || i < 0 || i >= (int)a->length)
| 0 | ||||||||||||||||||
| 426 | return; never executed: return; | 0 | ||||||||||||||||||
| 427 | - | |||||||||||||||||||
| 428 | detach2(); | - | ||||||||||||||||||
| 429 | a->removeItems(i, 1); | - | ||||||||||||||||||
| 430 | ++d->compactionCounter; | - | ||||||||||||||||||
| 431 | if (d->compactionCounter > 32u && d->compactionCounter >= unsigned(a->length) / 2u)
| 0 | ||||||||||||||||||
| 432 | compact(); never executed: compact(); | 0 | ||||||||||||||||||
| 433 | } never executed: end of block | 0 | ||||||||||||||||||
| 434 | - | |||||||||||||||||||
| 435 | /*! \fn void QJsonArray::removeFirst() | - | ||||||||||||||||||
| 436 | - | |||||||||||||||||||
| 437 | Removes the first item in the array. Calling this function is | - | ||||||||||||||||||
| 438 | equivalent to calling \c{removeAt(0)}. The array must not be empty. If | - | ||||||||||||||||||
| 439 | the array can be empty, call isEmpty() before calling this | - | ||||||||||||||||||
| 440 | function. | - | ||||||||||||||||||
| 441 | - | |||||||||||||||||||
| 442 | \sa removeAt(), removeLast() | - | ||||||||||||||||||
| 443 | */ | - | ||||||||||||||||||
| 444 | - | |||||||||||||||||||
| 445 | /*! \fn void QJsonArray::removeLast() | - | ||||||||||||||||||
| 446 | - | |||||||||||||||||||
| 447 | Removes the last item in the array. Calling this function is | - | ||||||||||||||||||
| 448 | equivalent to calling \c{removeAt(size() - 1)}. The array must not be | - | ||||||||||||||||||
| 449 | empty. If the array can be empty, call isEmpty() before calling | - | ||||||||||||||||||
| 450 | this function. | - | ||||||||||||||||||
| 451 | - | |||||||||||||||||||
| 452 | \sa removeAt(), removeFirst() | - | ||||||||||||||||||
| 453 | */ | - | ||||||||||||||||||
| 454 | - | |||||||||||||||||||
| 455 | /*! | - | ||||||||||||||||||
| 456 | Removes the item at index position \a i and returns it. \a i must | - | ||||||||||||||||||
| 457 | be a valid index position in the array (i.e., \c{0 <= i < size()}). | - | ||||||||||||||||||
| 458 | - | |||||||||||||||||||
| 459 | If you don't use the return value, removeAt() is more efficient. | - | ||||||||||||||||||
| 460 | - | |||||||||||||||||||
| 461 | \sa removeAt() | - | ||||||||||||||||||
| 462 | */ | - | ||||||||||||||||||
| 463 | QJsonValue QJsonArray::takeAt(int i) | - | ||||||||||||||||||
| 464 | { | - | ||||||||||||||||||
| 465 | if (!a || i < 0 || i >= (int)a->length)
| 0 | ||||||||||||||||||
| 466 | return QJsonValue(QJsonValue::Undefined); never executed: return QJsonValue(QJsonValue::Undefined); | 0 | ||||||||||||||||||
| 467 | - | |||||||||||||||||||
| 468 | QJsonValue v(d, a, a->at(i)); | - | ||||||||||||||||||
| 469 | removeAt(i); // detaches | - | ||||||||||||||||||
| 470 | return v; never executed: return v; | 0 | ||||||||||||||||||
| 471 | } | - | ||||||||||||||||||
| 472 | - | |||||||||||||||||||
| 473 | /*! | - | ||||||||||||||||||
| 474 | Inserts \a value at index position \a i in the array. If \a i | - | ||||||||||||||||||
| 475 | is \c 0, the value is prepended to the array. If \a i is size(), the | - | ||||||||||||||||||
| 476 | value is appended to the array. | - | ||||||||||||||||||
| 477 | - | |||||||||||||||||||
| 478 | \sa append(), prepend(), replace(), removeAt() | - | ||||||||||||||||||
| 479 | */ | - | ||||||||||||||||||
| 480 | void QJsonArray::insert(int i, const QJsonValue &value) | - | ||||||||||||||||||
| 481 | { | - | ||||||||||||||||||
| 482 | Q_ASSERT (i >= 0 && i <= (a ? (int)a->length : 0)); | - | ||||||||||||||||||
| 483 | QJsonValue val = value; | - | ||||||||||||||||||
| 484 | - | |||||||||||||||||||
| 485 | bool compressed; | - | ||||||||||||||||||
| 486 | int valueSize = QJsonPrivate::Value::requiredStorage(val, &compressed); | - | ||||||||||||||||||
| 487 | - | |||||||||||||||||||
| 488 | if (!detach2(valueSize + sizeof(QJsonPrivate::Value)))
| 0-8 | ||||||||||||||||||
| 489 | return; never executed: return; | 0 | ||||||||||||||||||
| 490 | - | |||||||||||||||||||
| 491 | if (!a->length)
| 2-6 | ||||||||||||||||||
| 492 | a->tableOffset = sizeof(QJsonPrivate::Array); executed 2 times by 1 test: a->tableOffset = sizeof(QJsonPrivate::Array);Executed by:
| 2 | ||||||||||||||||||
| 493 | - | |||||||||||||||||||
| 494 | int valueOffset = a->reserveSpace(valueSize, i, 1, false); | - | ||||||||||||||||||
| 495 | if (!valueOffset)
| 0-8 | ||||||||||||||||||
| 496 | return; never executed: return; | 0 | ||||||||||||||||||
| 497 | - | |||||||||||||||||||
| 498 | QJsonPrivate::Value &v = (*a)[i]; | - | ||||||||||||||||||
| 499 | v.type = (val.t == QJsonValue::Undefined ? QJsonValue::Null : val.t);
| 0-8 | ||||||||||||||||||
| 500 | v.latinOrIntValue = compressed; | - | ||||||||||||||||||
| 501 | v.latinKey = false; | - | ||||||||||||||||||
| 502 | v.value = QJsonPrivate::Value::valueToStore(val, valueOffset); | - | ||||||||||||||||||
| 503 | if (valueSize)
| 2-6 | ||||||||||||||||||
| 504 | QJsonPrivate::Value::copyData(val, (char *)a + valueOffset, compressed); executed 2 times by 1 test: QJsonPrivate::Value::copyData(val, (char *)a + valueOffset, compressed);Executed by:
| 2 | ||||||||||||||||||
| 505 | } executed 8 times by 1 test: end of blockExecuted by:
| 8 | ||||||||||||||||||
| 506 | - | |||||||||||||||||||
| 507 | /*! | - | ||||||||||||||||||
| 508 | \fn QJsonArray::iterator QJsonArray::insert(iterator before, const QJsonValue &value) | - | ||||||||||||||||||
| 509 | - | |||||||||||||||||||
| 510 | Inserts \a value before the position pointed to by \a before, and returns an iterator | - | ||||||||||||||||||
| 511 | pointing to the newly inserted item. | - | ||||||||||||||||||
| 512 | - | |||||||||||||||||||
| 513 | \sa erase(), insert() | - | ||||||||||||||||||
| 514 | */ | - | ||||||||||||||||||
| 515 | - | |||||||||||||||||||
| 516 | /*! | - | ||||||||||||||||||
| 517 | \fn QJsonArray::iterator QJsonArray::erase(iterator it) | - | ||||||||||||||||||
| 518 | - | |||||||||||||||||||
| 519 | Removes the item pointed to by \a it, and returns an iterator pointing to the | - | ||||||||||||||||||
| 520 | next item. | - | ||||||||||||||||||
| 521 | - | |||||||||||||||||||
| 522 | \sa removeAt() | - | ||||||||||||||||||
| 523 | */ | - | ||||||||||||||||||
| 524 | - | |||||||||||||||||||
| 525 | /*! | - | ||||||||||||||||||
| 526 | Replaces the item at index position \a i with \a value. \a i must | - | ||||||||||||||||||
| 527 | be a valid index position in the array (i.e., \c{0 <= i < size()}). | - | ||||||||||||||||||
| 528 | - | |||||||||||||||||||
| 529 | \sa operator[](), removeAt() | - | ||||||||||||||||||
| 530 | */ | - | ||||||||||||||||||
| 531 | void QJsonArray::replace(int i, const QJsonValue &value) | - | ||||||||||||||||||
| 532 | { | - | ||||||||||||||||||
| 533 | Q_ASSERT (a && i >= 0 && i < (int)(a->length)); | - | ||||||||||||||||||
| 534 | QJsonValue val = value; | - | ||||||||||||||||||
| 535 | - | |||||||||||||||||||
| 536 | bool compressed; | - | ||||||||||||||||||
| 537 | int valueSize = QJsonPrivate::Value::requiredStorage(val, &compressed); | - | ||||||||||||||||||
| 538 | - | |||||||||||||||||||
| 539 | if (!detach2(valueSize))
| 0 | ||||||||||||||||||
| 540 | return; never executed: return; | 0 | ||||||||||||||||||
| 541 | - | |||||||||||||||||||
| 542 | if (!a->length)
| 0 | ||||||||||||||||||
| 543 | a->tableOffset = sizeof(QJsonPrivate::Array); never executed: a->tableOffset = sizeof(QJsonPrivate::Array); | 0 | ||||||||||||||||||
| 544 | - | |||||||||||||||||||
| 545 | int valueOffset = a->reserveSpace(valueSize, i, 1, true); | - | ||||||||||||||||||
| 546 | if (!valueOffset)
| 0 | ||||||||||||||||||
| 547 | return; never executed: return; | 0 | ||||||||||||||||||
| 548 | - | |||||||||||||||||||
| 549 | QJsonPrivate::Value &v = (*a)[i]; | - | ||||||||||||||||||
| 550 | v.type = (val.t == QJsonValue::Undefined ? QJsonValue::Null : val.t);
| 0 | ||||||||||||||||||
| 551 | v.latinOrIntValue = compressed; | - | ||||||||||||||||||
| 552 | v.latinKey = false; | - | ||||||||||||||||||
| 553 | v.value = QJsonPrivate::Value::valueToStore(val, valueOffset); | - | ||||||||||||||||||
| 554 | if (valueSize)
| 0 | ||||||||||||||||||
| 555 | QJsonPrivate::Value::copyData(val, (char *)a + valueOffset, compressed); never executed: QJsonPrivate::Value::copyData(val, (char *)a + valueOffset, compressed); | 0 | ||||||||||||||||||
| 556 | - | |||||||||||||||||||
| 557 | ++d->compactionCounter; | - | ||||||||||||||||||
| 558 | if (d->compactionCounter > 32u && d->compactionCounter >= unsigned(a->length) / 2u)
| 0 | ||||||||||||||||||
| 559 | compact(); never executed: compact(); | 0 | ||||||||||||||||||
| 560 | } never executed: end of block | 0 | ||||||||||||||||||
| 561 | - | |||||||||||||||||||
| 562 | /*! | - | ||||||||||||||||||
| 563 | Returns \c true if the array contains an occurrence of \a value, otherwise \c false. | - | ||||||||||||||||||
| 564 | - | |||||||||||||||||||
| 565 | \sa count() | - | ||||||||||||||||||
| 566 | */ | - | ||||||||||||||||||
| 567 | bool QJsonArray::contains(const QJsonValue &value) const | - | ||||||||||||||||||
| 568 | { | - | ||||||||||||||||||
| 569 | for (int i = 0; i < size(); i++) {
| 0 | ||||||||||||||||||
| 570 | if (at(i) == value)
| 0 | ||||||||||||||||||
| 571 | return true; never executed: return true; | 0 | ||||||||||||||||||
| 572 | } never executed: end of block | 0 | ||||||||||||||||||
| 573 | return false; never executed: return false; | 0 | ||||||||||||||||||
| 574 | } | - | ||||||||||||||||||
| 575 | - | |||||||||||||||||||
| 576 | /*! | - | ||||||||||||||||||
| 577 | Returns the value at index position \a i as a modifiable reference. | - | ||||||||||||||||||
| 578 | \a i must be a valid index position in the array (i.e., \c{0 <= i < | - | ||||||||||||||||||
| 579 | size()}). | - | ||||||||||||||||||
| 580 | - | |||||||||||||||||||
| 581 | The return value is of type QJsonValueRef, a helper class for QJsonArray | - | ||||||||||||||||||
| 582 | and QJsonObject. When you get an object of type QJsonValueRef, you can | - | ||||||||||||||||||
| 583 | use it as if it were a reference to a QJsonValue. If you assign to it, | - | ||||||||||||||||||
| 584 | the assignment will apply to the character in the QJsonArray of QJsonObject | - | ||||||||||||||||||
| 585 | from which you got the reference. | - | ||||||||||||||||||
| 586 | - | |||||||||||||||||||
| 587 | \sa at() | - | ||||||||||||||||||
| 588 | */ | - | ||||||||||||||||||
| 589 | QJsonValueRef QJsonArray::operator [](int i) | - | ||||||||||||||||||
| 590 | { | - | ||||||||||||||||||
| 591 | Q_ASSERT(a && i >= 0 && i < (int)a->length); | - | ||||||||||||||||||
| 592 | return QJsonValueRef(this, i); never executed: return QJsonValueRef(this, i); | 0 | ||||||||||||||||||
| 593 | } | - | ||||||||||||||||||
| 594 | - | |||||||||||||||||||
| 595 | /*! | - | ||||||||||||||||||
| 596 | \overload | - | ||||||||||||||||||
| 597 | - | |||||||||||||||||||
| 598 | Same as at(). | - | ||||||||||||||||||
| 599 | */ | - | ||||||||||||||||||
| 600 | QJsonValue QJsonArray::operator[](int i) const | - | ||||||||||||||||||
| 601 | { | - | ||||||||||||||||||
| 602 | return at(i); never executed: return at(i); | 0 | ||||||||||||||||||
| 603 | } | - | ||||||||||||||||||
| 604 | - | |||||||||||||||||||
| 605 | /*! | - | ||||||||||||||||||
| 606 | Returns \c true if this array is equal to \a other. | - | ||||||||||||||||||
| 607 | */ | - | ||||||||||||||||||
| 608 | bool QJsonArray::operator==(const QJsonArray &other) const | - | ||||||||||||||||||
| 609 | { | - | ||||||||||||||||||
| 610 | if (a == other.a)
| 0-8 | ||||||||||||||||||
| 611 | return true; executed 8 times by 1 test: return true;Executed by:
| 8 | ||||||||||||||||||
| 612 | - | |||||||||||||||||||
| 613 | if (!a)
| 0 | ||||||||||||||||||
| 614 | return !other.a->length; never executed: return !other.a->length; | 0 | ||||||||||||||||||
| 615 | if (!other.a)
| 0 | ||||||||||||||||||
| 616 | return !a->length; never executed: return !a->length; | 0 | ||||||||||||||||||
| 617 | if (a->length != other.a->length)
| 0 | ||||||||||||||||||
| 618 | return false; never executed: return false; | 0 | ||||||||||||||||||
| 619 | - | |||||||||||||||||||
| 620 | for (int i = 0; i < (int)a->length; ++i) {
| 0 | ||||||||||||||||||
| 621 | if (QJsonValue(d, a, a->at(i)) != QJsonValue(other.d, other.a, other.a->at(i)))
| 0 | ||||||||||||||||||
| 622 | return false; never executed: return false; | 0 | ||||||||||||||||||
| 623 | } never executed: end of block | 0 | ||||||||||||||||||
| 624 | return true; never executed: return true; | 0 | ||||||||||||||||||
| 625 | } | - | ||||||||||||||||||
| 626 | - | |||||||||||||||||||
| 627 | /*! | - | ||||||||||||||||||
| 628 | Returns \c true if this array is not equal to \a other. | - | ||||||||||||||||||
| 629 | */ | - | ||||||||||||||||||
| 630 | bool QJsonArray::operator!=(const QJsonArray &other) const | - | ||||||||||||||||||
| 631 | { | - | ||||||||||||||||||
| 632 | return !(*this == other); never executed: return !(*this == other); | 0 | ||||||||||||||||||
| 633 | } | - | ||||||||||||||||||
| 634 | - | |||||||||||||||||||
| 635 | /*! \fn QJsonArray::iterator QJsonArray::begin() | - | ||||||||||||||||||
| 636 | - | |||||||||||||||||||
| 637 | Returns an \l{STL-style iterators}{STL-style iterator} pointing to the first item in | - | ||||||||||||||||||
| 638 | the array. | - | ||||||||||||||||||
| 639 | - | |||||||||||||||||||
| 640 | \sa constBegin(), end() | - | ||||||||||||||||||
| 641 | */ | - | ||||||||||||||||||
| 642 | - | |||||||||||||||||||
| 643 | /*! \fn QJsonArray::const_iterator QJsonArray::begin() const | - | ||||||||||||||||||
| 644 | - | |||||||||||||||||||
| 645 | \overload | - | ||||||||||||||||||
| 646 | */ | - | ||||||||||||||||||
| 647 | - | |||||||||||||||||||
| 648 | /*! \fn QJsonArray::const_iterator QJsonArray::constBegin() const | - | ||||||||||||||||||
| 649 | - | |||||||||||||||||||
| 650 | Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the first item | - | ||||||||||||||||||
| 651 | in the array. | - | ||||||||||||||||||
| 652 | - | |||||||||||||||||||
| 653 | \sa begin(), constEnd() | - | ||||||||||||||||||
| 654 | */ | - | ||||||||||||||||||
| 655 | - | |||||||||||||||||||
| 656 | /*! \fn QJsonArray::iterator QJsonArray::end() | - | ||||||||||||||||||
| 657 | - | |||||||||||||||||||
| 658 | Returns an \l{STL-style iterators}{STL-style iterator} pointing to the imaginary item | - | ||||||||||||||||||
| 659 | after the last item in the array. | - | ||||||||||||||||||
| 660 | - | |||||||||||||||||||
| 661 | \sa begin(), constEnd() | - | ||||||||||||||||||
| 662 | */ | - | ||||||||||||||||||
| 663 | - | |||||||||||||||||||
| 664 | /*! \fn const_iterator QJsonArray::end() const | - | ||||||||||||||||||
| 665 | - | |||||||||||||||||||
| 666 | \overload | - | ||||||||||||||||||
| 667 | */ | - | ||||||||||||||||||
| 668 | - | |||||||||||||||||||
| 669 | /*! \fn QJsonArray::const_iterator QJsonArray::constEnd() const | - | ||||||||||||||||||
| 670 | - | |||||||||||||||||||
| 671 | Returns a const \l{STL-style iterators}{STL-style iterator} pointing to the imaginary | - | ||||||||||||||||||
| 672 | item after the last item in the array. | - | ||||||||||||||||||
| 673 | - | |||||||||||||||||||
| 674 | \sa constBegin(), end() | - | ||||||||||||||||||
| 675 | */ | - | ||||||||||||||||||
| 676 | - | |||||||||||||||||||
| 677 | /*! \fn void QJsonArray::push_back(const QJsonValue &value) | - | ||||||||||||||||||
| 678 | - | |||||||||||||||||||
| 679 | This function is provided for STL compatibility. It is equivalent | - | ||||||||||||||||||
| 680 | to \l{QJsonArray::append()}{append(value)} and will append \a value to the array. | - | ||||||||||||||||||
| 681 | */ | - | ||||||||||||||||||
| 682 | - | |||||||||||||||||||
| 683 | /*! \fn void QJsonArray::push_front(const QJsonValue &value) | - | ||||||||||||||||||
| 684 | - | |||||||||||||||||||
| 685 | This function is provided for STL compatibility. It is equivalent | - | ||||||||||||||||||
| 686 | to \l{QJsonArray::prepend()}{prepend(value)} and will prepend \a value to the array. | - | ||||||||||||||||||
| 687 | */ | - | ||||||||||||||||||
| 688 | - | |||||||||||||||||||
| 689 | /*! \fn void QJsonArray::pop_front() | - | ||||||||||||||||||
| 690 | - | |||||||||||||||||||
| 691 | This function is provided for STL compatibility. It is equivalent | - | ||||||||||||||||||
| 692 | to removeFirst(). The array must not be empty. If the array can be | - | ||||||||||||||||||
| 693 | empty, call isEmpty() before calling this function. | - | ||||||||||||||||||
| 694 | */ | - | ||||||||||||||||||
| 695 | - | |||||||||||||||||||
| 696 | /*! \fn void QJsonArray::pop_back() | - | ||||||||||||||||||
| 697 | - | |||||||||||||||||||
| 698 | This function is provided for STL compatibility. It is equivalent | - | ||||||||||||||||||
| 699 | to removeLast(). The array must not be empty. If the array can be | - | ||||||||||||||||||
| 700 | empty, call isEmpty() before calling this function. | - | ||||||||||||||||||
| 701 | */ | - | ||||||||||||||||||
| 702 | - | |||||||||||||||||||
| 703 | /*! \fn bool QJsonArray::empty() const | - | ||||||||||||||||||
| 704 | - | |||||||||||||||||||
| 705 | This function is provided for STL compatibility. It is equivalent | - | ||||||||||||||||||
| 706 | to isEmpty() and returns \c true if the array is empty. | - | ||||||||||||||||||
| 707 | */ | - | ||||||||||||||||||
| 708 | - | |||||||||||||||||||
| 709 | /*! \class QJsonArray::iterator | - | ||||||||||||||||||
| 710 | \inmodule QtCore | - | ||||||||||||||||||
| 711 | \brief The QJsonArray::iterator class provides an STL-style non-const iterator for QJsonArray. | - | ||||||||||||||||||
| 712 | - | |||||||||||||||||||
| 713 | QJsonArray::iterator allows you to iterate over a QJsonArray | - | ||||||||||||||||||
| 714 | and to modify the array item associated with the | - | ||||||||||||||||||
| 715 | iterator. If you want to iterate over a const QJsonArray, use | - | ||||||||||||||||||
| 716 | QJsonArray::const_iterator instead. It is generally a good practice to | - | ||||||||||||||||||
| 717 | use QJsonArray::const_iterator on a non-const QJsonArray as well, unless | - | ||||||||||||||||||
| 718 | you need to change the QJsonArray through the iterator. Const | - | ||||||||||||||||||
| 719 | iterators are slightly faster and improves code readability. | - | ||||||||||||||||||
| 720 | - | |||||||||||||||||||
| 721 | The default QJsonArray::iterator constructor creates an uninitialized | - | ||||||||||||||||||
| 722 | iterator. You must initialize it using a QJsonArray function like | - | ||||||||||||||||||
| 723 | QJsonArray::begin(), QJsonArray::end(), or QJsonArray::insert() before you can | - | ||||||||||||||||||
| 724 | start iterating. | - | ||||||||||||||||||
| 725 | - | |||||||||||||||||||
| 726 | Most QJsonArray functions accept an integer index rather than an | - | ||||||||||||||||||
| 727 | iterator. For that reason, iterators are rarely useful in | - | ||||||||||||||||||
| 728 | connection with QJsonArray. One place where STL-style iterators do | - | ||||||||||||||||||
| 729 | make sense is as arguments to \l{generic algorithms}. | - | ||||||||||||||||||
| 730 | - | |||||||||||||||||||
| 731 | Multiple iterators can be used on the same array. However, be | - | ||||||||||||||||||
| 732 | aware that any non-const function call performed on the QJsonArray | - | ||||||||||||||||||
| 733 | will render all existing iterators undefined. | - | ||||||||||||||||||
| 734 | - | |||||||||||||||||||
| 735 | \sa QJsonArray::const_iterator | - | ||||||||||||||||||
| 736 | */ | - | ||||||||||||||||||
| 737 | - | |||||||||||||||||||
| 738 | /*! \typedef QJsonArray::iterator::iterator_category | - | ||||||||||||||||||
| 739 | - | |||||||||||||||||||
| 740 | A synonym for \e {std::random_access_iterator_tag} indicating | - | ||||||||||||||||||
| 741 | this iterator is a random access iterator. | - | ||||||||||||||||||
| 742 | */ | - | ||||||||||||||||||
| 743 | - | |||||||||||||||||||
| 744 | /*! \typedef QJsonArray::iterator::difference_type | - | ||||||||||||||||||
| 745 | - | |||||||||||||||||||
| 746 | \internal | - | ||||||||||||||||||
| 747 | */ | - | ||||||||||||||||||
| 748 | - | |||||||||||||||||||
| 749 | /*! \typedef QJsonArray::iterator::value_type | - | ||||||||||||||||||
| 750 | - | |||||||||||||||||||
| 751 | \internal | - | ||||||||||||||||||
| 752 | */ | - | ||||||||||||||||||
| 753 | - | |||||||||||||||||||
| 754 | /*! \typedef QJsonArray::iterator::reference | - | ||||||||||||||||||
| 755 | - | |||||||||||||||||||
| 756 | \internal | - | ||||||||||||||||||
| 757 | */ | - | ||||||||||||||||||
| 758 | - | |||||||||||||||||||
| 759 | /*! \typedef QJsonArray::iterator::pointer | - | ||||||||||||||||||
| 760 | - | |||||||||||||||||||
| 761 | \internal | - | ||||||||||||||||||
| 762 | */ | - | ||||||||||||||||||
| 763 | - | |||||||||||||||||||
| 764 | /*! \fn QJsonArray::iterator::iterator() | - | ||||||||||||||||||
| 765 | - | |||||||||||||||||||
| 766 | Constructs an uninitialized iterator. | - | ||||||||||||||||||
| 767 | - | |||||||||||||||||||
| 768 | Functions like operator*() and operator++() should not be called | - | ||||||||||||||||||
| 769 | on an uninitialized iterator. Use operator=() to assign a value | - | ||||||||||||||||||
| 770 | to it before using it. | - | ||||||||||||||||||
| 771 | - | |||||||||||||||||||
| 772 | \sa QJsonArray::begin(), QJsonArray::end() | - | ||||||||||||||||||
| 773 | */ | - | ||||||||||||||||||
| 774 | - | |||||||||||||||||||
| 775 | /*! \fn QJsonArray::iterator::iterator(QJsonArray *array, int index) | - | ||||||||||||||||||
| 776 | \internal | - | ||||||||||||||||||
| 777 | */ | - | ||||||||||||||||||
| 778 | - | |||||||||||||||||||
| 779 | /*! \fn QJsonValueRef QJsonArray::iterator::operator*() const | - | ||||||||||||||||||
| 780 | - | |||||||||||||||||||
| 781 | - | |||||||||||||||||||
| 782 | Returns a modifiable reference to the current item. | - | ||||||||||||||||||
| 783 | - | |||||||||||||||||||
| 784 | You can change the value of an item by using operator*() on the | - | ||||||||||||||||||
| 785 | left side of an assignment. | - | ||||||||||||||||||
| 786 | - | |||||||||||||||||||
| 787 | The return value is of type QJsonValueRef, a helper class for QJsonArray | - | ||||||||||||||||||
| 788 | and QJsonObject. When you get an object of type QJsonValueRef, you can | - | ||||||||||||||||||
| 789 | use it as if it were a reference to a QJsonValue. If you assign to it, | - | ||||||||||||||||||
| 790 | the assignment will apply to the character in the QJsonArray of QJsonObject | - | ||||||||||||||||||
| 791 | from which you got the reference. | - | ||||||||||||||||||
| 792 | */ | - | ||||||||||||||||||
| 793 | - | |||||||||||||||||||
| 794 | /*! \fn QJsonValueRef *QJsonArray::iterator::operator->() const | - | ||||||||||||||||||
| 795 | - | |||||||||||||||||||
| 796 | Returns a pointer to a modifiable reference to the current item. | - | ||||||||||||||||||
| 797 | */ | - | ||||||||||||||||||
| 798 | - | |||||||||||||||||||
| 799 | /*! \fn QJsonValueRef QJsonArray::iterator::operator[](int j) const | - | ||||||||||||||||||
| 800 | - | |||||||||||||||||||
| 801 | Returns a modifiable reference to the item at offset \a j from the | - | ||||||||||||||||||
| 802 | item pointed to by this iterator (the item at position \c{*this + j}). | - | ||||||||||||||||||
| 803 | - | |||||||||||||||||||
| 804 | This function is provided to make QJsonArray iterators behave like C++ | - | ||||||||||||||||||
| 805 | pointers. | - | ||||||||||||||||||
| 806 | - | |||||||||||||||||||
| 807 | The return value is of type QJsonValueRef, a helper class for QJsonArray | - | ||||||||||||||||||
| 808 | and QJsonObject. When you get an object of type QJsonValueRef, you can | - | ||||||||||||||||||
| 809 | use it as if it were a reference to a QJsonValue. If you assign to it, | - | ||||||||||||||||||
| 810 | the assignment will apply to the character in the QJsonArray of QJsonObject | - | ||||||||||||||||||
| 811 | from which you got the reference. | - | ||||||||||||||||||
| 812 | - | |||||||||||||||||||
| 813 | \sa operator+() | - | ||||||||||||||||||
| 814 | */ | - | ||||||||||||||||||
| 815 | - | |||||||||||||||||||
| 816 | /*! | - | ||||||||||||||||||
| 817 | \fn bool QJsonArray::iterator::operator==(const iterator &other) const | - | ||||||||||||||||||
| 818 | \fn bool QJsonArray::iterator::operator==(const const_iterator &other) const | - | ||||||||||||||||||
| 819 | - | |||||||||||||||||||
| 820 | Returns \c true if \a other points to the same item as this | - | ||||||||||||||||||
| 821 | iterator; otherwise returns \c false. | - | ||||||||||||||||||
| 822 | - | |||||||||||||||||||
| 823 | \sa operator!=() | - | ||||||||||||||||||
| 824 | */ | - | ||||||||||||||||||
| 825 | - | |||||||||||||||||||
| 826 | /*! | - | ||||||||||||||||||
| 827 | \fn bool QJsonArray::iterator::operator!=(const iterator &other) const | - | ||||||||||||||||||
| 828 | \fn bool QJsonArray::iterator::operator!=(const const_iterator &other) const | - | ||||||||||||||||||
| 829 | - | |||||||||||||||||||
| 830 | Returns \c true if \a other points to a different item than this | - | ||||||||||||||||||
| 831 | iterator; otherwise returns \c false. | - | ||||||||||||||||||
| 832 | - | |||||||||||||||||||
| 833 | \sa operator==() | - | ||||||||||||||||||
| 834 | */ | - | ||||||||||||||||||
| 835 | - | |||||||||||||||||||
| 836 | /*! | - | ||||||||||||||||||
| 837 | \fn bool QJsonArray::iterator::operator<(const iterator& other) const | - | ||||||||||||||||||
| 838 | \fn bool QJsonArray::iterator::operator<(const const_iterator& other) const | - | ||||||||||||||||||
| 839 | - | |||||||||||||||||||
| 840 | Returns \c true if the item pointed to by this iterator is less than | - | ||||||||||||||||||
| 841 | the item pointed to by the \a other iterator. | - | ||||||||||||||||||
| 842 | */ | - | ||||||||||||||||||
| 843 | - | |||||||||||||||||||
| 844 | /*! | - | ||||||||||||||||||
| 845 | \fn bool QJsonArray::iterator::operator<=(const iterator& other) const | - | ||||||||||||||||||
| 846 | \fn bool QJsonArray::iterator::operator<=(const const_iterator& other) const | - | ||||||||||||||||||
| 847 | - | |||||||||||||||||||
| 848 | Returns \c true if the item pointed to by this iterator is less than | - | ||||||||||||||||||
| 849 | or equal to the item pointed to by the \a other iterator. | - | ||||||||||||||||||
| 850 | */ | - | ||||||||||||||||||
| 851 | - | |||||||||||||||||||
| 852 | /*! | - | ||||||||||||||||||
| 853 | \fn bool QJsonArray::iterator::operator>(const iterator& other) const | - | ||||||||||||||||||
| 854 | \fn bool QJsonArray::iterator::operator>(const const_iterator& other) const | - | ||||||||||||||||||
| 855 | - | |||||||||||||||||||
| 856 | Returns \c true if the item pointed to by this iterator is greater | - | ||||||||||||||||||
| 857 | than the item pointed to by the \a other iterator. | - | ||||||||||||||||||
| 858 | */ | - | ||||||||||||||||||
| 859 | - | |||||||||||||||||||
| 860 | /*! | - | ||||||||||||||||||
| 861 | \fn bool QJsonArray::iterator::operator>=(const iterator& other) const | - | ||||||||||||||||||
| 862 | \fn bool QJsonArray::iterator::operator>=(const const_iterator& other) const | - | ||||||||||||||||||
| 863 | - | |||||||||||||||||||
| 864 | Returns \c true if the item pointed to by this iterator is greater | - | ||||||||||||||||||
| 865 | than or equal to the item pointed to by the \a other iterator. | - | ||||||||||||||||||
| 866 | */ | - | ||||||||||||||||||
| 867 | - | |||||||||||||||||||
| 868 | /*! \fn QJsonArray::iterator &QJsonArray::iterator::operator++() | - | ||||||||||||||||||
| 869 | - | |||||||||||||||||||
| 870 | The prefix ++ operator, \c{++it}, advances the iterator to the | - | ||||||||||||||||||
| 871 | next item in the array and returns an iterator to the new current | - | ||||||||||||||||||
| 872 | item. | - | ||||||||||||||||||
| 873 | - | |||||||||||||||||||
| 874 | Calling this function on QJsonArray::end() leads to undefined results. | - | ||||||||||||||||||
| 875 | - | |||||||||||||||||||
| 876 | \sa operator--() | - | ||||||||||||||||||
| 877 | */ | - | ||||||||||||||||||
| 878 | - | |||||||||||||||||||
| 879 | /*! \fn QJsonArray::iterator QJsonArray::iterator::operator++(int) | - | ||||||||||||||||||
| 880 | - | |||||||||||||||||||
| 881 | \overload | - | ||||||||||||||||||
| 882 | - | |||||||||||||||||||
| 883 | The postfix ++ operator, \c{it++}, advances the iterator to the | - | ||||||||||||||||||
| 884 | next item in the array and returns an iterator to the previously | - | ||||||||||||||||||
| 885 | current item. | - | ||||||||||||||||||
| 886 | */ | - | ||||||||||||||||||
| 887 | - | |||||||||||||||||||
| 888 | /*! \fn QJsonArray::iterator &QJsonArray::iterator::operator--() | - | ||||||||||||||||||
| 889 | - | |||||||||||||||||||
| 890 | The prefix -- operator, \c{--it}, makes the preceding item | - | ||||||||||||||||||
| 891 | current and returns an iterator to the new current item. | - | ||||||||||||||||||
| 892 | - | |||||||||||||||||||
| 893 | Calling this function on QJsonArray::begin() leads to undefined results. | - | ||||||||||||||||||
| 894 | - | |||||||||||||||||||
| 895 | \sa operator++() | - | ||||||||||||||||||
| 896 | */ | - | ||||||||||||||||||
| 897 | - | |||||||||||||||||||
| 898 | /*! \fn QJsonArray::iterator QJsonArray::iterator::operator--(int) | - | ||||||||||||||||||
| 899 | - | |||||||||||||||||||
| 900 | \overload | - | ||||||||||||||||||
| 901 | - | |||||||||||||||||||
| 902 | The postfix -- operator, \c{it--}, makes the preceding item | - | ||||||||||||||||||
| 903 | current and returns an iterator to the previously current item. | - | ||||||||||||||||||
| 904 | */ | - | ||||||||||||||||||
| 905 | - | |||||||||||||||||||
| 906 | /*! \fn QJsonArray::iterator &QJsonArray::iterator::operator+=(int j) | - | ||||||||||||||||||
| 907 | - | |||||||||||||||||||
| 908 | Advances the iterator by \a j items. If \a j is negative, the | - | ||||||||||||||||||
| 909 | iterator goes backward. | - | ||||||||||||||||||
| 910 | - | |||||||||||||||||||
| 911 | \sa operator-=(), operator+() | - | ||||||||||||||||||
| 912 | */ | - | ||||||||||||||||||
| 913 | - | |||||||||||||||||||
| 914 | /*! \fn QJsonArray::iterator &QJsonArray::iterator::operator-=(int j) | - | ||||||||||||||||||
| 915 | - | |||||||||||||||||||
| 916 | Makes the iterator go back by \a j items. If \a j is negative, | - | ||||||||||||||||||
| 917 | the iterator goes forward. | - | ||||||||||||||||||
| 918 | - | |||||||||||||||||||
| 919 | \sa operator+=(), operator-() | - | ||||||||||||||||||
| 920 | */ | - | ||||||||||||||||||
| 921 | - | |||||||||||||||||||
| 922 | /*! \fn QJsonArray::iterator QJsonArray::iterator::operator+(int j) const | - | ||||||||||||||||||
| 923 | - | |||||||||||||||||||
| 924 | Returns an iterator to the item at \a j positions forward from | - | ||||||||||||||||||
| 925 | this iterator. If \a j is negative, the iterator goes backward. | - | ||||||||||||||||||
| 926 | - | |||||||||||||||||||
| 927 | \sa operator-(), operator+=() | - | ||||||||||||||||||
| 928 | */ | - | ||||||||||||||||||
| 929 | - | |||||||||||||||||||
| 930 | /*! \fn QJsonArray::iterator QJsonArray::iterator::operator-(int j) const | - | ||||||||||||||||||
| 931 | - | |||||||||||||||||||
| 932 | Returns an iterator to the item at \a j positions backward from | - | ||||||||||||||||||
| 933 | this iterator. If \a j is negative, the iterator goes forward. | - | ||||||||||||||||||
| 934 | - | |||||||||||||||||||
| 935 | \sa operator+(), operator-=() | - | ||||||||||||||||||
| 936 | */ | - | ||||||||||||||||||
| 937 | - | |||||||||||||||||||
| 938 | /*! \fn int QJsonArray::iterator::operator-(iterator other) const | - | ||||||||||||||||||
| 939 | - | |||||||||||||||||||
| 940 | Returns the number of items between the item pointed to by \a | - | ||||||||||||||||||
| 941 | other and the item pointed to by this iterator. | - | ||||||||||||||||||
| 942 | */ | - | ||||||||||||||||||
| 943 | - | |||||||||||||||||||
| 944 | /*! \class QJsonArray::const_iterator | - | ||||||||||||||||||
| 945 | \inmodule QtCore | - | ||||||||||||||||||
| 946 | \brief The QJsonArray::const_iterator class provides an STL-style const iterator for QJsonArray. | - | ||||||||||||||||||
| 947 | - | |||||||||||||||||||
| 948 | QJsonArray::const_iterator allows you to iterate over a | - | ||||||||||||||||||
| 949 | QJsonArray. If you want to modify the QJsonArray as | - | ||||||||||||||||||
| 950 | you iterate over it, use QJsonArray::iterator instead. It is generally a | - | ||||||||||||||||||
| 951 | good practice to use QJsonArray::const_iterator on a non-const QJsonArray | - | ||||||||||||||||||
| 952 | as well, unless you need to change the QJsonArray through the | - | ||||||||||||||||||
| 953 | iterator. Const iterators are slightly faster and improves | - | ||||||||||||||||||
| 954 | code readability. | - | ||||||||||||||||||
| 955 | - | |||||||||||||||||||
| 956 | The default QJsonArray::const_iterator constructor creates an | - | ||||||||||||||||||
| 957 | uninitialized iterator. You must initialize it using a QJsonArray | - | ||||||||||||||||||
| 958 | function like QJsonArray::constBegin(), QJsonArray::constEnd(), or | - | ||||||||||||||||||
| 959 | QJsonArray::insert() before you can start iterating. | - | ||||||||||||||||||
| 960 | - | |||||||||||||||||||
| 961 | Most QJsonArray functions accept an integer index rather than an | - | ||||||||||||||||||
| 962 | iterator. For that reason, iterators are rarely useful in | - | ||||||||||||||||||
| 963 | connection with QJsonArray. One place where STL-style iterators do | - | ||||||||||||||||||
| 964 | make sense is as arguments to \l{generic algorithms}. | - | ||||||||||||||||||
| 965 | - | |||||||||||||||||||
| 966 | Multiple iterators can be used on the same array. However, be | - | ||||||||||||||||||
| 967 | aware that any non-const function call performed on the QJsonArray | - | ||||||||||||||||||
| 968 | will render all existing iterators undefined. | - | ||||||||||||||||||
| 969 | - | |||||||||||||||||||
| 970 | \sa QJsonArray::iterator | - | ||||||||||||||||||
| 971 | */ | - | ||||||||||||||||||
| 972 | - | |||||||||||||||||||
| 973 | /*! \fn QJsonArray::const_iterator::const_iterator() | - | ||||||||||||||||||
| 974 | - | |||||||||||||||||||
| 975 | Constructs an uninitialized iterator. | - | ||||||||||||||||||
| 976 | - | |||||||||||||||||||
| 977 | Functions like operator*() and operator++() should not be called | - | ||||||||||||||||||
| 978 | on an uninitialized iterator. Use operator=() to assign a value | - | ||||||||||||||||||
| 979 | to it before using it. | - | ||||||||||||||||||
| 980 | - | |||||||||||||||||||
| 981 | \sa QJsonArray::constBegin(), QJsonArray::constEnd() | - | ||||||||||||||||||
| 982 | */ | - | ||||||||||||||||||
| 983 | - | |||||||||||||||||||
| 984 | /*! \fn QJsonArray::const_iterator::const_iterator(const QJsonArray *array, int index) | - | ||||||||||||||||||
| 985 | \internal | - | ||||||||||||||||||
| 986 | */ | - | ||||||||||||||||||
| 987 | - | |||||||||||||||||||
| 988 | /*! \typedef QJsonArray::const_iterator::iterator_category | - | ||||||||||||||||||
| 989 | - | |||||||||||||||||||
| 990 | A synonym for \e {std::random_access_iterator_tag} indicating | - | ||||||||||||||||||
| 991 | this iterator is a random access iterator. | - | ||||||||||||||||||
| 992 | */ | - | ||||||||||||||||||
| 993 | - | |||||||||||||||||||
| 994 | /*! \typedef QJsonArray::const_iterator::difference_type | - | ||||||||||||||||||
| 995 | - | |||||||||||||||||||
| 996 | \internal | - | ||||||||||||||||||
| 997 | */ | - | ||||||||||||||||||
| 998 | - | |||||||||||||||||||
| 999 | /*! \typedef QJsonArray::const_iterator::value_type | - | ||||||||||||||||||
| 1000 | - | |||||||||||||||||||
| 1001 | \internal | - | ||||||||||||||||||
| 1002 | */ | - | ||||||||||||||||||
| 1003 | - | |||||||||||||||||||
| 1004 | /*! \typedef QJsonArray::const_iterator::reference | - | ||||||||||||||||||
| 1005 | - | |||||||||||||||||||
| 1006 | \internal | - | ||||||||||||||||||
| 1007 | */ | - | ||||||||||||||||||
| 1008 | - | |||||||||||||||||||
| 1009 | /*! \typedef QJsonArray::const_iterator::pointer | - | ||||||||||||||||||
| 1010 | - | |||||||||||||||||||
| 1011 | \internal | - | ||||||||||||||||||
| 1012 | */ | - | ||||||||||||||||||
| 1013 | - | |||||||||||||||||||
| 1014 | /*! \fn QJsonArray::const_iterator::const_iterator(const const_iterator &other) | - | ||||||||||||||||||
| 1015 | - | |||||||||||||||||||
| 1016 | Constructs a copy of \a other. | - | ||||||||||||||||||
| 1017 | */ | - | ||||||||||||||||||
| 1018 | - | |||||||||||||||||||
| 1019 | /*! \fn QJsonArray::const_iterator::const_iterator(const iterator &other) | - | ||||||||||||||||||
| 1020 | - | |||||||||||||||||||
| 1021 | Constructs a copy of \a other. | - | ||||||||||||||||||
| 1022 | */ | - | ||||||||||||||||||
| 1023 | - | |||||||||||||||||||
| 1024 | /*! \fn QJsonValue QJsonArray::const_iterator::operator*() const | - | ||||||||||||||||||
| 1025 | - | |||||||||||||||||||
| 1026 | Returns the current item. | - | ||||||||||||||||||
| 1027 | */ | - | ||||||||||||||||||
| 1028 | - | |||||||||||||||||||
| 1029 | /*! \fn QJsonValue *QJsonArray::const_iterator::operator->() const | - | ||||||||||||||||||
| 1030 | - | |||||||||||||||||||
| 1031 | Returns a pointer to the current item. | - | ||||||||||||||||||
| 1032 | */ | - | ||||||||||||||||||
| 1033 | - | |||||||||||||||||||
| 1034 | /*! \fn QJsonValue QJsonArray::const_iterator::operator[](int j) const | - | ||||||||||||||||||
| 1035 | - | |||||||||||||||||||
| 1036 | Returns the item at offset \a j from the item pointed to by this iterator (the item at | - | ||||||||||||||||||
| 1037 | position \c{*this + j}). | - | ||||||||||||||||||
| 1038 | - | |||||||||||||||||||
| 1039 | This function is provided to make QJsonArray iterators behave like C++ | - | ||||||||||||||||||
| 1040 | pointers. | - | ||||||||||||||||||
| 1041 | - | |||||||||||||||||||
| 1042 | \sa operator+() | - | ||||||||||||||||||
| 1043 | */ | - | ||||||||||||||||||
| 1044 | - | |||||||||||||||||||
| 1045 | /*! \fn bool QJsonArray::const_iterator::operator==(const const_iterator &other) const | - | ||||||||||||||||||
| 1046 | - | |||||||||||||||||||
| 1047 | Returns \c true if \a other points to the same item as this | - | ||||||||||||||||||
| 1048 | iterator; otherwise returns \c false. | - | ||||||||||||||||||
| 1049 | - | |||||||||||||||||||
| 1050 | \sa operator!=() | - | ||||||||||||||||||
| 1051 | */ | - | ||||||||||||||||||
| 1052 | - | |||||||||||||||||||
| 1053 | /*! \fn bool QJsonArray::const_iterator::operator!=(const const_iterator &other) const | - | ||||||||||||||||||
| 1054 | - | |||||||||||||||||||
| 1055 | Returns \c true if \a other points to a different item than this | - | ||||||||||||||||||
| 1056 | iterator; otherwise returns \c false. | - | ||||||||||||||||||
| 1057 | - | |||||||||||||||||||
| 1058 | \sa operator==() | - | ||||||||||||||||||
| 1059 | */ | - | ||||||||||||||||||
| 1060 | - | |||||||||||||||||||
| 1061 | /*! | - | ||||||||||||||||||
| 1062 | \fn bool QJsonArray::const_iterator::operator<(const const_iterator& other) const | - | ||||||||||||||||||
| 1063 | - | |||||||||||||||||||
| 1064 | Returns \c true if the item pointed to by this iterator is less than | - | ||||||||||||||||||
| 1065 | the item pointed to by the \a other iterator. | - | ||||||||||||||||||
| 1066 | */ | - | ||||||||||||||||||
| 1067 | - | |||||||||||||||||||
| 1068 | /*! | - | ||||||||||||||||||
| 1069 | \fn bool QJsonArray::const_iterator::operator<=(const const_iterator& other) const | - | ||||||||||||||||||
| 1070 | - | |||||||||||||||||||
| 1071 | Returns \c true if the item pointed to by this iterator is less than | - | ||||||||||||||||||
| 1072 | or equal to the item pointed to by the \a other iterator. | - | ||||||||||||||||||
| 1073 | */ | - | ||||||||||||||||||
| 1074 | - | |||||||||||||||||||
| 1075 | /*! | - | ||||||||||||||||||
| 1076 | \fn bool QJsonArray::const_iterator::operator>(const const_iterator& other) const | - | ||||||||||||||||||
| 1077 | - | |||||||||||||||||||
| 1078 | Returns \c true if the item pointed to by this iterator is greater | - | ||||||||||||||||||
| 1079 | than the item pointed to by the \a other iterator. | - | ||||||||||||||||||
| 1080 | */ | - | ||||||||||||||||||
| 1081 | - | |||||||||||||||||||
| 1082 | /*! | - | ||||||||||||||||||
| 1083 | \fn bool QJsonArray::const_iterator::operator>=(const const_iterator& other) const | - | ||||||||||||||||||
| 1084 | - | |||||||||||||||||||
| 1085 | Returns \c true if the item pointed to by this iterator is greater | - | ||||||||||||||||||
| 1086 | than or equal to the item pointed to by the \a other iterator. | - | ||||||||||||||||||
| 1087 | */ | - | ||||||||||||||||||
| 1088 | - | |||||||||||||||||||
| 1089 | /*! \fn QJsonArray::const_iterator &QJsonArray::const_iterator::operator++() | - | ||||||||||||||||||
| 1090 | - | |||||||||||||||||||
| 1091 | The prefix ++ operator, \c{++it}, advances the iterator to the | - | ||||||||||||||||||
| 1092 | next item in the array and returns an iterator to the new current | - | ||||||||||||||||||
| 1093 | item. | - | ||||||||||||||||||
| 1094 | - | |||||||||||||||||||
| 1095 | Calling this function on QJsonArray::end() leads to undefined results. | - | ||||||||||||||||||
| 1096 | - | |||||||||||||||||||
| 1097 | \sa operator--() | - | ||||||||||||||||||
| 1098 | */ | - | ||||||||||||||||||
| 1099 | - | |||||||||||||||||||
| 1100 | /*! \fn QJsonArray::const_iterator QJsonArray::const_iterator::operator++(int) | - | ||||||||||||||||||
| 1101 | - | |||||||||||||||||||
| 1102 | \overload | - | ||||||||||||||||||
| 1103 | - | |||||||||||||||||||
| 1104 | The postfix ++ operator, \c{it++}, advances the iterator to the | - | ||||||||||||||||||
| 1105 | next item in the array and returns an iterator to the previously | - | ||||||||||||||||||
| 1106 | current item. | - | ||||||||||||||||||
| 1107 | */ | - | ||||||||||||||||||
| 1108 | - | |||||||||||||||||||
| 1109 | /*! \fn QJsonArray::const_iterator &QJsonArray::const_iterator::operator--() | - | ||||||||||||||||||
| 1110 | - | |||||||||||||||||||
| 1111 | The prefix -- operator, \c{--it}, makes the preceding item | - | ||||||||||||||||||
| 1112 | current and returns an iterator to the new current item. | - | ||||||||||||||||||
| 1113 | - | |||||||||||||||||||
| 1114 | Calling this function on QJsonArray::begin() leads to undefined results. | - | ||||||||||||||||||
| 1115 | - | |||||||||||||||||||
| 1116 | \sa operator++() | - | ||||||||||||||||||
| 1117 | */ | - | ||||||||||||||||||
| 1118 | - | |||||||||||||||||||
| 1119 | /*! \fn QJsonArray::const_iterator QJsonArray::const_iterator::operator--(int) | - | ||||||||||||||||||
| 1120 | - | |||||||||||||||||||
| 1121 | \overload | - | ||||||||||||||||||
| 1122 | - | |||||||||||||||||||
| 1123 | The postfix -- operator, \c{it--}, makes the preceding item | - | ||||||||||||||||||
| 1124 | current and returns an iterator to the previously current item. | - | ||||||||||||||||||
| 1125 | */ | - | ||||||||||||||||||
| 1126 | - | |||||||||||||||||||
| 1127 | /*! \fn QJsonArray::const_iterator &QJsonArray::const_iterator::operator+=(int j) | - | ||||||||||||||||||
| 1128 | - | |||||||||||||||||||
| 1129 | Advances the iterator by \a j items. If \a j is negative, the | - | ||||||||||||||||||
| 1130 | iterator goes backward. | - | ||||||||||||||||||
| 1131 | - | |||||||||||||||||||
| 1132 | \sa operator-=(), operator+() | - | ||||||||||||||||||
| 1133 | */ | - | ||||||||||||||||||
| 1134 | - | |||||||||||||||||||
| 1135 | /*! \fn QJsonArray::const_iterator &QJsonArray::const_iterator::operator-=(int j) | - | ||||||||||||||||||
| 1136 | - | |||||||||||||||||||
| 1137 | Makes the iterator go back by \a j items. If \a j is negative, | - | ||||||||||||||||||
| 1138 | the iterator goes forward. | - | ||||||||||||||||||
| 1139 | - | |||||||||||||||||||
| 1140 | \sa operator+=(), operator-() | - | ||||||||||||||||||
| 1141 | */ | - | ||||||||||||||||||
| 1142 | - | |||||||||||||||||||
| 1143 | /*! \fn QJsonArray::const_iterator QJsonArray::const_iterator::operator+(int j) const | - | ||||||||||||||||||
| 1144 | - | |||||||||||||||||||
| 1145 | Returns an iterator to the item at \a j positions forward from | - | ||||||||||||||||||
| 1146 | this iterator. If \a j is negative, the iterator goes backward. | - | ||||||||||||||||||
| 1147 | - | |||||||||||||||||||
| 1148 | \sa operator-(), operator+=() | - | ||||||||||||||||||
| 1149 | */ | - | ||||||||||||||||||
| 1150 | - | |||||||||||||||||||
| 1151 | /*! \fn QJsonArray::const_iterator QJsonArray::const_iterator::operator-(int j) const | - | ||||||||||||||||||
| 1152 | - | |||||||||||||||||||
| 1153 | Returns an iterator to the item at \a j positions backward from | - | ||||||||||||||||||
| 1154 | this iterator. If \a j is negative, the iterator goes forward. | - | ||||||||||||||||||
| 1155 | - | |||||||||||||||||||
| 1156 | \sa operator+(), operator-=() | - | ||||||||||||||||||
| 1157 | */ | - | ||||||||||||||||||
| 1158 | - | |||||||||||||||||||
| 1159 | /*! \fn int QJsonArray::const_iterator::operator-(const_iterator other) const | - | ||||||||||||||||||
| 1160 | - | |||||||||||||||||||
| 1161 | Returns the number of items between the item pointed to by \a | - | ||||||||||||||||||
| 1162 | other and the item pointed to by this iterator. | - | ||||||||||||||||||
| 1163 | */ | - | ||||||||||||||||||
| 1164 | - | |||||||||||||||||||
| 1165 | - | |||||||||||||||||||
| 1166 | /*! | - | ||||||||||||||||||
| 1167 | \internal | - | ||||||||||||||||||
| 1168 | */ | - | ||||||||||||||||||
| 1169 | void QJsonArray::detach(uint reserve) | - | ||||||||||||||||||
| 1170 | { | - | ||||||||||||||||||
| 1171 | Q_UNUSED(reserve) | - | ||||||||||||||||||
| 1172 | Q_ASSERT(!reserve); | - | ||||||||||||||||||
| 1173 | detach2(0); | - | ||||||||||||||||||
| 1174 | } never executed: end of block | 0 | ||||||||||||||||||
| 1175 | - | |||||||||||||||||||
| 1176 | /*! | - | ||||||||||||||||||
| 1177 | \internal | - | ||||||||||||||||||
| 1178 | */ | - | ||||||||||||||||||
| 1179 | bool QJsonArray::detach2(uint reserve) | - | ||||||||||||||||||
| 1180 | { | - | ||||||||||||||||||
| 1181 | if (!d) {
| 2-6 | ||||||||||||||||||
| 1182 | if (reserve >= QJsonPrivate::Value::MaxSize) {
| 0-2 | ||||||||||||||||||
| 1183 | qWarning("QJson: Document too large to store in data structure"); | - | ||||||||||||||||||
| 1184 | return false; never executed: return false; | 0 | ||||||||||||||||||
| 1185 | } | - | ||||||||||||||||||
| 1186 | d = new QJsonPrivate::Data(reserve, QJsonValue::Array); | - | ||||||||||||||||||
| 1187 | a = static_cast<QJsonPrivate::Array *>(d->header->root()); | - | ||||||||||||||||||
| 1188 | d->ref.ref(); | - | ||||||||||||||||||
| 1189 | return true; executed 2 times by 1 test: return true;Executed by:
| 2 | ||||||||||||||||||
| 1190 | } | - | ||||||||||||||||||
| 1191 | if (reserve == 0 && d->ref.load() == 1)
| 0-6 | ||||||||||||||||||
| 1192 | return true; never executed: return true; | 0 | ||||||||||||||||||
| 1193 | - | |||||||||||||||||||
| 1194 | QJsonPrivate::Data *x = d->clone(a, reserve); | - | ||||||||||||||||||
| 1195 | if (!x)
| 0-6 | ||||||||||||||||||
| 1196 | return false; never executed: return false; | 0 | ||||||||||||||||||
| 1197 | x->ref.ref(); | - | ||||||||||||||||||
| 1198 | if (!d->ref.deref())
| 2-4 | ||||||||||||||||||
| 1199 | delete d; executed 2 times by 1 test: delete d;Executed by:
| 2 | ||||||||||||||||||
| 1200 | d = x; | - | ||||||||||||||||||
| 1201 | a = static_cast<QJsonPrivate::Array *>(d->header->root()); | - | ||||||||||||||||||
| 1202 | return true; executed 6 times by 1 test: return true;Executed by:
| 6 | ||||||||||||||||||
| 1203 | } | - | ||||||||||||||||||
| 1204 | - | |||||||||||||||||||
| 1205 | /*! | - | ||||||||||||||||||
| 1206 | \internal | - | ||||||||||||||||||
| 1207 | */ | - | ||||||||||||||||||
| 1208 | void QJsonArray::compact() | - | ||||||||||||||||||
| 1209 | { | - | ||||||||||||||||||
| 1210 | if (!d || !d->compactionCounter)
| 0 | ||||||||||||||||||
| 1211 | return; never executed: return; | 0 | ||||||||||||||||||
| 1212 | - | |||||||||||||||||||
| 1213 | detach2(); | - | ||||||||||||||||||
| 1214 | d->compact(); | - | ||||||||||||||||||
| 1215 | a = static_cast<QJsonPrivate::Array *>(d->header->root()); | - | ||||||||||||||||||
| 1216 | } never executed: end of block | 0 | ||||||||||||||||||
| 1217 | - | |||||||||||||||||||
| 1218 | - | |||||||||||||||||||
| 1219 | #if !defined(QT_NO_DEBUG_STREAM) && !defined(QT_JSON_READONLY) | - | ||||||||||||||||||
| 1220 | QDebug operator<<(QDebug dbg, const QJsonArray &a) | - | ||||||||||||||||||
| 1221 | { | - | ||||||||||||||||||
| 1222 | QDebugStateSaver saver(dbg); | - | ||||||||||||||||||
| 1223 | if (!a.a) {
| 0-1 | ||||||||||||||||||
| 1224 | dbg << "QJsonArray()"; | - | ||||||||||||||||||
| 1225 | return dbg; executed 1 time by 1 test: return dbg;Executed by:
| 1 | ||||||||||||||||||
| 1226 | } | - | ||||||||||||||||||
| 1227 | QByteArray json; | - | ||||||||||||||||||
| 1228 | QJsonPrivate::Writer::arrayToJson(a.a, json, 0, true); | - | ||||||||||||||||||
| 1229 | dbg.nospace() << "QJsonArray(" | - | ||||||||||||||||||
| 1230 | << json.constData() // print as utf-8 string without extra quotation marks | - | ||||||||||||||||||
| 1231 | << ")"; | - | ||||||||||||||||||
| 1232 | return dbg; never executed: return dbg; | 0 | ||||||||||||||||||
| 1233 | } | - | ||||||||||||||||||
| 1234 | #endif | - | ||||||||||||||||||
| 1235 | - | |||||||||||||||||||
| 1236 | QT_END_NAMESPACE | - | ||||||||||||||||||
| 1237 | - | |||||||||||||||||||
| Source code | Switch to Preprocessed file |