Класс iterator

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

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

Типы публичного доступа

Функции публичного доступа

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

Класс QJsonArray::iterator предоставляет итератор в стиле STL для QJsonArray.

QJsonArray::iterator позволяет перебирать QJsonArray и изменять элементы массива, на которые указывает итератор. Для перебора по константному QJsonArray используйте QJsonArray::const_iterator. Рекомендуется использовать QJsonArray::const_iterator и для неконстантных QJsonArray, если вам не нужно изменять QJsonArray через итератор. Константные итераторы немного быстрее и улучшают читаемость кода.

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

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

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

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

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

typedef 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+(int j) const

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

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

iterator &iterator::operator++()

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

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

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

iterator iterator::operator++(int)

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

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

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

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

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

iterator iterator::operator-(int j) const

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

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

int iterator::operator-(iterator other) const

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

iterator &iterator::operator--()

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

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

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

iterator iterator::operator--(int)

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

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

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

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

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

QJsonValueRef *iterator::operator->() const

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

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

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

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

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

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