Класс ConstIterator

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

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

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

Типы публичного интерфейса

Публичные функции

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

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

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

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

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

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

ConstIterator::iterator_category

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

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

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

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

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

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

Возвращает true , если other указывает на другой элемент в карте, чем этот итератор; в противном случае возвращает 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

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