Класс iterator

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

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

Типы

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

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

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

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

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

Конструктор по умолчанию QJsonArray::iterator создает неинициализированный итератор. Вы должны инициализировать его с помощью функции QJsonArray, такой как 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+().