Класс QJsonArray

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

Этот класс был введен в Qt 5.0.

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

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

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

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

Статические открытые члены

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

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

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

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

QJsonArray::QJsonArray(const QJsonArray &other)

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

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

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

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

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

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

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

QJsonArray::QJsonArray()

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

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

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

QJsonArray QJsonArray::fromStringList(const QStringList &list)

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

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

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

QJsonArray QJsonArray::fromVariantList(const QVariantList &list)

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

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

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

См. также 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().

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