Класс iterator

Класс QJsonArray::iterator предоставляет итератор в стиле STL без модификатора const для QJsonArray. Подробнее...

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

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

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

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

QJsonArray::iterator позволяет итерироваться по QJsonArray и изменять элементы массива, связанные с итератором. Если нужно итерироваться по массиву QJsonArray без модификатора const, используйте QJsonArray::const_iterator вместо этого. В общем случае рекомендуется использовать QJsonArray::const_iterator даже для не-const QJsonArray, за исключением случаев, когда требуется изменение QJsonArray через итератор. Итераторы без модификатора const несколько быстрее и улучшают читаемость кода.

Конструктор QJsonArray::iterator по умолчанию создает неинициализированный итератор. Необходимо инициализировать его с помощью функции QJsonArray, например QJsonArray::begin(), QJsonArray::end() или QJsonArray::insert(), прежде чем начать итерацию.

Большинство функций QJsonArray принимают целочисленный индекс, а не итератор. Поэтому итераторы редко используются в связи с QJsonArray. Одно из мест, где итераторы в стиле STL имеют смысл, — это аргументы для общих алгоритмов.

Можно использовать несколько итераторов для одного и того же массива. Однако учтите, что любое обращение к функции QJsonArray без модификатора const сделает все существующие итераторы неопределёнными.

См. также QJsonArray::const_iterator.

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

iterator::iterator_category

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

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

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

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

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

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

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

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

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

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

iterator::iterator()

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

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

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

QJsonValueRef iterator::operator*() const

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

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

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

iterator iterator::operator+(qsizetype j) const

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

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

iterator &iterator::operator++()

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

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

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

iterator iterator::operator++(int)

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

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

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

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

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

iterator iterator::operator-(qsizetype j) const

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

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

qsizetype iterator::operator-(iterator other) const

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

iterator &iterator::operator--()

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

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

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

iterator iterator::operator--(int)

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

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

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

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

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

QJsonValueRef *iterator::operator->() const

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

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

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

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

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

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