Класс QJsonArray

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

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

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

Открытые типы

Открытые функции

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

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

Класс QJsonArray инкапсулирует JSON-массив.

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

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

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

Вы можете преобразовать массив в JSON-текст и из него с помощью QJsonDocument.

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

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

typedef QJsonArray::ConstIterator

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

typedef QJsonArray::Iterator

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

typedef QJsonArray::const_pointer

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

typedef QJsonArray::const_reference

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

typedef QJsonArray::difference_type

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

typedef QJsonArray::pointer

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

typedef QJsonArray::reference

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

typedef QJsonArray::size_type

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

typedef QJsonArray::value_type

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

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

QJsonArray::QJsonArray()

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

QJsonArray::QJsonArray(std::initializer_list<QJsonValue> args)

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

QJsonArray может быть создан, похожим на запись JSON, например:

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

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

QJsonArray::QJsonArray(const QJsonArray &other)

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

Так как QJsonArray неявно разделяется, копия является поверхностной, пока объект не будет изменён.

QJsonArray::~QJsonArray()

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

void QJsonArray::append(const QJsonValue &value)

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

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

QJsonValue QJsonArray::at(int i) const

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

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

iterator QJsonArray::begin()

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

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

const_iterator QJsonArray::begin() const

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

const_iterator QJsonArray::constBegin() const

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

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

const_iterator QJsonArray::constEnd() const

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

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

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

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

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

int QJsonArray::count() const

То же, что и size().

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

bool QJsonArray::empty() const

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

iterator QJsonArray::end()

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

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

const_iterator QJsonArray::end() const

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

iterator QJsonArray::erase(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.

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

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

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

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

iterator QJsonArray::insert(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(int 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(int i, const QJsonValue &value)

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

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

int QJsonArray::size() const

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

QJsonValue QJsonArray::takeAt(int i)

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

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

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

QVariantList QJsonArray::toVariantList() const

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

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

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

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

QJsonArray QJsonArray::operator+(const QJsonValue &value) const

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

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

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

QJsonArray &QJsonArray::operator+=(const QJsonValue &value)

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

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

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

QJsonArray &QJsonArray::operator<<(const QJsonValue &value)

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

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

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

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

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

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

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

QJsonValueRef QJsonArray::operator[](int i)

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

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

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

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

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

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