Класс iterator

Класс QJsonObject::iterator предоставляет итератор в стиле STL для QJsonObject. Подробнее...

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

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

Общие типы

Общие функции

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

QJsonObject::iterator позволяет итерироваться по QJsonObject и изменять значения (но не ключи), хранящиеся под определенным ключом. Если вы хотите итерироваться по QJsonObject, используйте QJsonObject::const_iterator. В общем случае рекомендуется использовать QJsonObject::const_iterator даже для неконстантного QJsonObject, за исключением случаев, когда вам необходимо изменить QJsonObject через итератор. Константные итераторы немного быстрее и повышают читаемость кода.

Итератор QJsonObject::iterator по умолчанию создает неинициализированный итератор. Вам необходимо инициализировать его с помощью функции QJsonObject::begin(), QJsonObject::end() или QJsonObject::find() перед началом итерации.

Можно использовать несколько итераторов для одного объекта. Однако существующие итераторы станут висячими (dangling), как только объект будет изменен.

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

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

iterator::iterator_category

Синоним для std::random_access_iterator_tag, указывающий, что этот итератор — итератор произвольного доступа.

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

Возвращает true true, если элемент, на который указывает этот итератор, больше или равен элементу, на который указывает итератор other.

Возвращает true true, если элемент, на который указывает этот итератор, больше элемента, на который указывает итератор other.

Возвращает true true, если элемент, на который указывает этот итератор, меньше или равен элементу, на который указывает итератор other.

Возвращает true true, если элемент, на который указывает этот итератор, меньше элемента, на который указывает итератор other.

Возвращает true true, если other указывает на другой элемент, чем этот итератор; иначе возвращает false false.

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

Возвращает true , если other указывает на тот же элемент, что и этот итератор; в противном случае возвращает false.

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

iterator::iterator()

Конструирует неинициализированный итератор.

Функции, такие как key(), value() и operator++(), не должны вызываться для неинициализированного итератора. Используйте operator=() для присвоения значения перед использованием.

См. также QJsonObject::begin() и QJsonObject::end().

QString iterator::key() const

Возвращает ключ текущего элемента.

Нет прямого способа изменения ключа элемента с помощью итератора, хотя это можно сделать, вызвав QJsonObject::erase() и затем QJsonObject::insert().

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

QJsonValueRef iterator::value() const

Возвращает изменяемую ссылку на значение текущего элемента.

Вы можете изменить значение элемента, используя value() в левой части оператора присваивания.

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

См. также key() и operator*().

QJsonValueRef iterator::operator*() const

Возвращает изменяемую ссылку на значение текущего элемента.

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

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

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

iterator iterator::operator+(qsizetype j) const

Возвращает итератор на элемент, находящийся на j позиций вперёд от текущего итератора. Если j отрицательно, итератор перемещается назад.

См. также operator-().

iterator &iterator::operator++()

Префиксный оператор ++, ++i, перемещает итератор к следующему элементу объекта и возвращает итератор на новый текущий элемент.

Вызов этой функции для QJsonObject::end() приводит к неопределённым результатам.

См. также operator--().

iterator iterator::operator++(int)

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

Постфиксный оператор ++, i++, перемещает итератор к следующему элементу объекта и возвращает итератор на ранее текущий элемент.

iterator &iterator::operator+=(qsizetype j)

Перемещает итератор на j элементов вперёд. Если j отрицательно, итератор перемещается назад.

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

iterator iterator::operator-(qsizetype j) const

Возвращает итератор на элемент, находящийся на j позиций назад от текущего итератора. Если j отрицательно, итератор перемещается вперёд.

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

qsizetype iterator::operator-(iterator other) const

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

iterator &iterator::operator--()

Префиксный оператор --, --i, делает предыдущий элемент текущим и возвращает итератор, указывающий на новый текущий элемент.

Вызов этой функции для QJsonObject::begin() приводит к неопределённым результатам.

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

iterator iterator::operator--(int)

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

Постфиксный оператор --, i--, делает предыдущий элемент текущим и возвращает итератор, указывающий на ранее текущий элемент.

iterator &iterator::operator-=(qsizetype j)

Перемещает итератор назад на j элементов. Если j отрицательно, итератор перемещается вперёд.

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

QJsonValueRef *iterator::operator->() const

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

const QJsonValueRef iterator::operator[](qsizetype j)

Возвращает изменяемую ссылку на элемент с смещением j от элемента, на который указывает этот итератор (элемент в позиции *this + j).

Эта функция предназначена для того, чтобы итераторы QJsonObject вели себя как указатели C++.

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

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