Класс QJsonArray

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

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

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

Общедоступные типы

Общедоступные функции

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

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

Класс QJsonArray encapsulates a JSON array.

Массив 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(QJsonArray &&other)

Создаёт QJsonArray путём перемещения из other.

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

QJsonArray::~QJsonArray()

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

void QJsonArray::append(const QJsonValue &value)

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

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

QJsonValue QJsonArray::at(int i) const

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

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

QJsonArray::iterator QJsonArray::begin()

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

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

QJsonArray::const_iterator QJsonArray::begin() const

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

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().

int 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.

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

void QJsonArray::insert(int 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(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

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

void QJsonArray::swap(QJsonArray &other)

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

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

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 этому массиву.

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

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

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

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().