Класс QJsonArray

Класс QJsonArray инкапсулирует массив JSON. Подробнее...

• Список всех членов, включая унаследованные

Примечание: Все функции в этом классе являются реентерабельными.

Публичные типы

Публичные функции

Статические публичные члены

Подробное описание

Массив JSON представляет собой список значений. Список можно изменять, вставляя и удаляя QJsonValue из массива.

QJsonArray можно преобразовать в QVariantList и обратно. Вы можете запросить количество элементов с помощью size(), insert() и removeAt(), извлечь элементы и перебрать содержимое, используя стандартный шаблон итераторов C++.

QJsonArray — это класс с неявной совместной собственностью, и он разделяет данные с документом, из которого он был создан, пока он не изменяется.

Вы можете преобразовать массив в текстовый JSON и обратно через QJsonDocument.

См. также Поддержка JSON в Qt и Пример JSON-сохранения игры.

Документация по типам членов

QJsonArray::ConstIterator

Синоним Qt-стиля для QJsonArray::const_iterator.

QJsonArray::Iterator

Синоним Qt-стиля для QJsonArray::iterator.

QJsonArray::const_pointer

Тип-псевдоним для const QJsonValue *. Предоставлен для совместимости со STL.

QJsonArray::const_reference

Тип-псевдоним для const QJsonValue &. Предоставлен для совместимости со STL.

QJsonArray::difference_type

Тип-псевдоним для qsizetype. Предоставлен для совместимости со STL.

QJsonArray::pointer

Тип-псевдоним для QJsonValue *. Предоставлен для совместимости со STL.

QJsonArray::reference

Тип-псевдоним для QJsonValue &. Предоставлен для совместимости со STL.

QJsonArray::size_type

Тип-псевдоним для qsizetype. Предоставлен для совместимости со STL.

QJsonArray::value_type

Тип-псевдоним для QJsonValue. Предоставлен для совместимости со STL.

Документация по функциям-членам

[since 5.10] QJsonArray::QJsonArray(QJsonArray &&other)

Конструирует QJsonArray из other с помощью перемещения.

Эта функция была введена в Qt 5.10.

QJsonArray::QJsonArray(const QJsonArray &other)

Создает копию other.

Поскольку QJsonArray имеет неявную совместную собственность, копия является поверхностной, пока объект не изменится.

[since 5.4] QJsonArray::QJsonArray(std::initializer_list<QJsonValue> args)

Создает массив, инициализированный списком инициализации args.

QJsonArray можно сконструировать, подобно JSON-нотации, например:

QJsonArray array = { 1, 2.2, QString() };

Эта функция была введена в Qt 5.4.

QJsonArray::QJsonArray()

Создает пустой массив.

[since 5.10] QJsonArray &QJsonArray::operator=(QJsonArray &&other)

Присваивает other этому массиву с помощью перемещения.

Эта функция была введена в Qt 5.10.

QJsonArray &QJsonArray::operator=(const QJsonArray &other)

Присваивает other этому массиву.

QJsonArray::~QJsonArray()

Удаляет массив.

void QJsonArray::append(const QJsonValue &value)

Вставляет value в конец массива.

См. также prepend() и insert().

QJsonValue QJsonArray::at(qsizetype i) const

Возвращает QJsonValue, представляющую значение для индекса i.

Возвращаемое QJsonValue является Undefined, если i находится вне границ.

QJsonArray::iterator QJsonArray::begin()

Возвращает итератор STL, указывающий на первый элемент массива.

См. также constBegin() и end().

QJsonArray::const_iterator QJsonArray::begin() const

Это перегруженная функция.

QJsonArray::const_iterator QJsonArray::cbegin() const

Возвращает постоянный итератор STL, указывающий на первый элемент массива.

См. также begin() и cend().

QJsonArray::const_iterator QJsonArray::cend() const

Возвращает постоянный итератор STL, указывающий на воображаемый элемент после последнего элемента массива.

См. также cbegin() и end().

QJsonArray::const_iterator QJsonArray::constBegin() const

Возвращает постоянный итератор STL, указывающий на первый элемент массива.

См. также begin() и constEnd().

QJsonArray::const_iterator QJsonArray::constEnd() const

Возвращает постоянный итератор STL, указывающий на воображаемый элемент после последнего элемента массива.

См. также constBegin() и end().

bool QJsonArray::contains(const QJsonValue &value) const

Возвращает true, если массив содержит вхождение value, в противном случае false.

См. также count().

qsizetype QJsonArray::count() const

То же самое, что size().

См. также size().

bool QJsonArray::empty() const

Эта функция предоставлена для совместимости со STL. Она эквивалентна isEmpty() и возвращает true, если массив пуст.

QJsonArray::iterator QJsonArray::end()

Возвращает итератор STL, указывающий на воображаемый элемент после последнего элемента массива.

См. также begin() и constEnd().

QJsonArray::const_iterator QJsonArray::end() const

Это перегруженная функция.

QJsonArray::iterator QJsonArray::erase(QJsonArray::iterator it)

Удаляет элемент, на который указывает it, и возвращает итератор, указывающий на следующий элемент.

См. также removeAt().

QJsonValue QJsonArray::first() const

Возвращает первое значение, хранящееся в массиве.

То же самое, что at(0).

См. также at().

[static] QJsonArray QJsonArray::fromStringList(const QStringList &list)

Преобразует список строк list в QJsonArray.

Значения в list будут преобразованы в JSON-значения.

См. также toVariantList() и QJsonValue::fromVariant().

[static] QJsonArray QJsonArray::fromVariantList(const QVariantList &list)

Преобразует список вариантов list в QJsonArray.

Значения QVariant в list будут преобразованы в JSON-значения.

Примечание: Преобразование из QVariant не является полностью без потерь. Для получения дополнительной информации см. документацию по QJsonValue::fromVariant().

См. также toVariantList() и QJsonValue::fromVariant().

void QJsonArray::insert(qsizetype i, const QJsonValue &value)

Вставляет value в позицию с индексом i в массиве. Если i равно 0, значение добавляется в начало массива. Если i равно size(), значение добавляется в конец массива.

См. также append(), prepend(), replace() и removeAt().

QJsonArray::iterator QJsonArray::insert(QJsonArray::iterator before, const QJsonValue &value)

Вставляет value перед позицией, на которую указывает before, и возвращает итератор, указывающий на вставленный элемент.

См. также erase() и insert().

bool QJsonArray::isEmpty() const

Возвращает true, если объект пуст. Это то же самое, что и size() == 0.

См. также size().

QJsonValue QJsonArray::last() const

Возвращает последнее значение, хранящееся в массиве.

То же самое, что и at(size() - 1).

См. также at().

void QJsonArray::pop_back()

Эта функция предоставляется для совместимости со STL. Она эквивалентна removeLast(). Массив не должен быть пустым. Если массив может быть пустым, вызовите isEmpty() перед вызовом этой функции.

void QJsonArray::pop_front()

Эта функция предоставляется для совместимости со STL. Она эквивалентна removeFirst(). Массив не должен быть пустым. Если массив может быть пустым, вызовите isEmpty() перед вызовом этой функции.

void QJsonArray::prepend(const QJsonValue &value)

Вставляет value в начало массива.

Это то же самое, что и insert(0, value), и добавит value в начало массива.

См. также append() и insert().

void QJsonArray::push_back(const QJsonValue &value)

Эта функция предоставляется для совместимости со STL. Она эквивалентна append(value) и добавит value в конец массива.

void QJsonArray::push_front(const QJsonValue &value)

Эта функция предоставляется для совместимости со STL. Она эквивалентна prepend(value) и добавит value в начало массива.

void QJsonArray::removeAt(qsizetype i)

Удаляет значение с индексом i. i должен быть корректным индексом в массиве (т.е., 0 <= i < size()).

См. также insert() и replace().

void QJsonArray::removeFirst()

Удаляет первый элемент в массиве. Вызов этой функции эквивалентен вызову removeAt(0). Массив не должен быть пустым. Если массив может быть пустым, вызовите isEmpty() перед вызовом этой функции.

См. также removeAt() и removeLast().

void QJsonArray::removeLast()

Удаляет последний элемент в массиве. Вызов этой функции эквивалентен вызову removeAt(size() - 1). Массив не должен быть пустым. Если массив может быть пустым, вызовите isEmpty() перед вызовом этой функции.

См. также removeAt() и removeFirst().

void QJsonArray::replace(qsizetype i, const QJsonValue &value)

Заменяет элемент с индексом i на value. i должен быть корректным индексом в массиве (т.е., 0 <= i < size()).

См. также operator[]() и removeAt().

qsizetype QJsonArray::size() const

Возвращает количество значений, хранящихся в массиве.

[since 5.10] void QJsonArray::swap(QJsonArray &other)

Меняет местами массив other с этим. Эта операция очень быстрая и никогда не терпит неудачу.

Эта функция была введена в Qt 5.10.

QJsonValue QJsonArray::takeAt(qsizetype i)

Удаляет элемент с индексом i и возвращает его. i должен быть корректным индексом в массиве (т.е., 0 <= i < size()).

Если вам не нужно значение возврата, то removeAt() будет более эффективным.

См. также removeAt().

QVariantList QJsonArray::toVariantList() const

Преобразует этот объект в QVariantList.

Возвращает созданный список.

bool QJsonArray::operator!=(const QJsonArray &other) const

Возвращает true, если этот массив не равен other.

[since 5.3] QJsonArray QJsonArray::operator+(const QJsonValue &value) const

Возвращает массив, содержащий все элементы этого массива, за которым следует предоставленное значение value.

Эта функция была введена в Qt 5.3.

См. также operator+=().

[since 5.3] QJsonArray &QJsonArray::operator+=(const QJsonValue &value)

Добавляет value в конец массива и возвращает ссылку на сам массив.

Эта функция была введена в Qt 5.3.

См. также append() и operator<<().

[since 5.3] QJsonArray &QJsonArray::operator<<(const QJsonValue &value)

Добавляет value в конец массива и возвращает ссылку на сам массив.

Эта функция была введена в Qt 5.3.

См. также operator+=() и append().

bool QJsonArray::operator==(const QJsonArray &other) const

Возвращает true, если этот массив равен other.

QJsonValueRef QJsonArray::operator[](qsizetype i)

Возвращает значение с индексом i как изменяемую ссылку. i должен быть корректным индексом в массиве (т.е., 0 <= i < size()).

Значение возврата имеет тип QJsonValueRef, вспомогательный класс для QJsonArray и QJsonObject. При получении объекта типа QJsonValueRef, вы можете использовать его так, как будто это ссылка на QJsonValue. Если вы присваиваете значение, то присваивание будет применено к элементу в QJsonArray или QJsonObject, из которого вы получили ссылку.

См. также at().

QJsonValue QJsonArray::operator[](qsizetype i) const

Это перегруженная функция.

То же самое, что и at().