Класс ConstIterator

Класс QCborMap::ConstIterator предоставляет итератор const-типа в стиле STL для QCborMap. Подробнее...

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

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

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

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

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

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

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

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

См. также QCborMap::Iterator.

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

typedef ConstIterator::iterator_category

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

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

Возвращает true если элемент в map, на который указывает этот итератор, находится после или совпадает с элементом, на который указывает итератор other.

Возвращает true если элемент в map, на который указывает этот итератор, находится после элемента, на который указывает итератор other.

Возвращает true если элемент в map, на который указывает этот итератор, находится перед или совпадает с элементом, на который указывает итератор other.

Возвращает true если элемент в map, на который указывает этот итератор, находится перед элементом, на который указывает итератор other.

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

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

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

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

ConstIterator::ConstIterator(const ConstIterator &other)

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

ConstIterator::ConstIterator()

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

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

См. также QCborMap::constBegin() и QCborMap::constEnd().

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

Преобразует этот итератор в копию other и возвращает ссылку на этот итератор.

QCborValue ConstIterator::key() const

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

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

QCborValueRef ConstIterator::value() const

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

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

ConstIterator::value_type ConstIterator::operator*() const

Возвращает пару, содержащую ключ и значение текущего элемента.

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

ConstIterator ConstIterator::operator+(qsizetype j) const

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

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

ConstIterator &ConstIterator::operator++()

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

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

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

ConstIterator ConstIterator::operator++(int)

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

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

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

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

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

ConstIterator ConstIterator::operator-(qsizetype j) const

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

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

qsizetype ConstIterator::operator-(ConstIterator j) const

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

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

ConstIterator &ConstIterator::operator--()

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

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

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

ConstIterator ConstIterator::operator--(int)

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

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

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

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

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

const QCborValueRef *ConstIterator::operator->() const

Возвращает указатель на значение текущей пары.