Класс 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().