Класс Iterator

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

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

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

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

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

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

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

Итераторы инициализируются с помощью функции QCborArray, такой как QCborArray::begin(), QCborArray::end() или QCborArray::insert(). Итерация возможна только после этого.

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

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

См. также QCborArray::ConstIterator.

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

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(const Iterator &other)

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

Iterator::Iterator()

Создаёт неинициализированный итератор.

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

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

Iterator &Iterator::operator=(const Iterator &other)

Делает этот итератор копией other и возвращает ссылку на этот итератор.

QCborValueRef Iterator::operator*() const

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

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

Значение возврата имеет тип QCborValueRef, вспомогательный класс для QCborArray и QCborMap. Когда вы получаете объект типа QCborValueRef, вы можете использовать его как ссылку на QCborValue. Если вы присваиваете ему значение, присваивание будет применено к элементу в QCborArray или QCborMap, из которого вы получили ссылку.

Iterator Iterator::operator+(qsizetype j) const

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

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

Iterator &Iterator::operator++()

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

Вызов этой функции для QCborArray::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, делает предыдущий элемент текущим и возвращает этот итератор.

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

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

Iterator Iterator::operator--(int)

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

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

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

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

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

QCborValueRef *Iterator::operator->() const

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

QCborValueRef Iterator::operator[](qsizetype j)

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

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

Значение возврата имеет тип QCborValueRef, вспомогательный класс для QCborArray и QCborMap. Когда вы получаете объект типа QCborValueRef, вы можете использовать его как ссылку на QCborValue. Если вы присваиваете ему значение, присваивание будет применено к элементу в QCborArray или QCborMap, из которого вы получили ссылку.

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