En esta página

QTaggedIterator Class

template <typename Iterator, typename IteratorCategory> class QTaggedIterator

QTaggedIterator es una clase de plantilla que envuelve un iterador y expone las características estándar de los iteradores. Más información...

Encabezado: #include <QTaggedIterator>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Desde: Qt 6.0

Funciones públicas

QTaggedIterator(Iterator &&it)
bool operator!=(const QTaggedIterator<Iterator, IteratorCategory> &other) const
QTaggedIterator<Iterator, IteratorCategory> operator+(qsizetype j) const
QTaggedIterator<Iterator, IteratorCategory> &operator++()
QTaggedIterator<Iterator, IteratorCategory> operator++(int x)
QTaggedIterator<Iterator, IteratorCategory> &operator+=(qsizetype j)
qsizetype operator-(const QTaggedIterator<Iterator, IteratorCategory> &j) const
QTaggedIterator<Iterator, IteratorCategory> operator-(qsizetype j) const
QTaggedIterator<Iterator, IteratorCategory> &operator--()
QTaggedIterator<Iterator, IteratorCategory> operator--(int x)
QTaggedIterator<Iterator, IteratorCategory> &operator-=(qsizetype j)
bool operator==(const QTaggedIterator<Iterator, IteratorCategory> &other) const
QTaggedIterator<Iterator, IteratorCategory> operator+(qsizetype j, const QTaggedIterator<Iterator, IteratorCategory> &k)

Descripción detallada

QTaggedIterator<Iterator, IteratorCategory> envuelve un iterador, donde Iterator es el tipo de iterador subyacente (como QIterator o QConstIterator) y IteratorCategory es una etiqueta de categoría de iterador estándar (como std::forward_iterator_tag o std::random_access_iterator_tag).

Para poder utilizar un iterador en cualquiera de los algoritmos estándar, es necesario conocer sus rasgos de iterador. Dado que un ` QMetaSequence::Iterable ` puede funcionar con muchos tipos diferentes de contenedores, no podemos declarar los rasgos en las propias clases de iterador. Un `QTaggedIterator` te permite declarar explícitamente un rasgo para una instancia concreta de un iterador o de un ` QConstIterator`.

Documentación de las funciones miembro

QTaggedIterator::QTaggedIterator(Iterator &&it)

Crea un `QTaggedIterator` a partir de un iterador o de un ` QConstIterator ` it. Comprueba si la `IteratorCategory` pasada como argumento de plantilla se ajusta a las capacidades en tiempo de ejecución de it; si no hay coincidencia, se rechaza it.

bool QTaggedIterator::operator!=(const QTaggedIterator<Iterator, IteratorCategory> &other) const

Devuelve ` true ` si ` other ` apunta a un elemento distinto de este iterador; en caso contrario, devuelve ` false`.

Véase también operator==().

QTaggedIterator<Iterator, IteratorCategory> QTaggedIterator::operator+(qsizetype j) const

Devuelve un iterador que apunta al elemento situado a j posiciones por delante de este iterador.

Véase también ` operator-()` y ` operator+=()`.

QTaggedIterator<Iterator, IteratorCategory> &QTaggedIterator::operator++()

El operador prefijo ++ (++it) hace avanzar el iterador hasta el siguiente elemento del contenedor y devuelve un iterador al nuevo elemento actual.

La llamada a esta función en QMetaSequence::Iterable::constEnd() da lugar a resultados indefinidos.

Véase también operator--().

QTaggedIterator<Iterator, IteratorCategory> QTaggedIterator::operator++(int x)

El operador postfijo « ++ » (it++) avanza el iterador hasta el siguiente elemento del contenedor y devuelve un iterador que apunta al elemento que era el actual anteriormente.

Se trata de una función sobrecargada.

QTaggedIterator<Iterator, IteratorCategory> &QTaggedIterator::operator+=(qsizetype j)

Avanza el iterador j elementos.

Véase también operator-=() y operator+().

qsizetype QTaggedIterator::operator-(const QTaggedIterator<Iterator, IteratorCategory> &j) const

Devuelve la distancia entre este iterador y j.

Véase también operator+(), operator-=() y QIterable::canReverseIterate().

QTaggedIterator<Iterator, IteratorCategory> QTaggedIterator::operator-(qsizetype j) const

Devuelve un iterador al elemento situado a j posiciones hacia atrás desde este iterador.

Si el contenedor especificado en ` QVariant ` no admite la iteración bidireccional, la llamada a esta función da lugar a resultados indefinidos.

Véanse también operator+(), operator-=() y QIterable::canReverseIterate().

QTaggedIterator<Iterator, IteratorCategory> &QTaggedIterator::operator--()

El operador prefijo « -- » (--it) establece el elemento anterior como el actual y devuelve un iterador al nuevo elemento actual.

La llamada a esta función en QMetaSequence::Iterable::constBegin() da lugar a resultados indefinidos.

Si el contenedor de QVariant no admite la iteración bidireccional, llamar a esta función da lugar a resultados indefinidos.

Véase también operator++() y QIterable::canReverseIterate().

QTaggedIterator<Iterator, IteratorCategory> QTaggedIterator::operator--(int x)

El operador postfijo « -- » (it--) convierte el elemento anterior en el elemento actual y devuelve un iterador al elemento que era el actual anteriormente.

Si el contenedor de QVariant no admite la iteración bidireccional, llamar a esta función da lugar a resultados indefinidos.

Se trata de una función sobrecargada.

Véase también ` QIterable::canReverseIterate()`.

QTaggedIterator<Iterator, IteratorCategory> &QTaggedIterator::operator-=(qsizetype j)

Hace que el iterador retroceda j elementos.

Si el contenedor especificado en ` QVariant ` no admite la iteración bidireccional, llamar a esta función dará lugar a resultados indefinidos.

Véase también operator+=(), operator-() y QIterable::canReverseIterate().

bool QTaggedIterator::operator==(const QTaggedIterator<Iterator, IteratorCategory> &other) const

Devuelve ` true ` si ` other ` apunta al mismo elemento que este iterador; en caso contrario, devuelve ` false`.

Véase también operator!=().

Elementos no miembros relacionados

QTaggedIterator<Iterator, IteratorCategory> operator+(qsizetype j, const QTaggedIterator<Iterator, IteratorCategory> &k)

Devuelve un iterador al elemento situado a « j » posiciones por delante del iterador « k ».

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.