QCborArray::Iterator Class
class QCborArray::IteratorLa clase ` QCborArray::Iterator ` proporciona un iterador no constante, al estilo de la STL, para ` QCborArray`. Más información...
- Lista de todos los miembros, incluidos los miembros heredados
- El iterador forma parte del soporte CBOR en Qt.
Comparaciones de QCborArray::Iterator
| Categoría | Tipos comparables |
|---|---|
| fuerte | QCborArray::Iterator |
| strong | QCborArray::ConstIterator. |
Tipos públicos
Funciones públicas
| Iterator() | |
| Iterator(const QCborArray::Iterator &other) | |
| QCborValueRef | operator*() const |
| QCborArray::Iterator | operator+(qsizetype j) const |
| QCborArray::Iterator & | operator++() |
| QCborArray::Iterator | operator++(int) |
| QCborArray::Iterator & | operator+=(qsizetype j) |
| qsizetype | operator-(QCborArray::Iterator other) const |
| QCborArray::Iterator | operator-(qsizetype j) const |
| QCborArray::Iterator & | operator--() |
| QCborArray::Iterator | operator--(int) |
| QCborArray::Iterator & | operator-=(qsizetype j) |
| const QCborValueConstRef * | operator->() const |
| QCborArray::Iterator & | operator=(const QCborArray::Iterator &other) |
| QCborValueRef | operator[](qsizetype j) const |
Elementos no miembros relacionados
| bool | operator!=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator!=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator<(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator<(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator<=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator<=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator==(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator==(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator>(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator>(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
| bool | operator>=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs) |
| bool | operator>=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs) |
Descripción detallada
QCborArray::Iterator permite iterar sobre un ` QCborArray ` y modificar el elemento de la matriz asociado al iterador. Si deseas iterar sobre un `const QCborArray`, utiliza en su lugar ` QCborArray::ConstIterator `. Por lo general, es recomendable utilizar ` QCborArray::ConstIterator ` también con un `non-const QCborArray `, a menos que necesites modificar el ` QCborArray ` a través del iterador. Los iteradores `const` son ligeramente más rápidos y mejoran la legibilidad del código.
Los iteradores se inicializan utilizando una función QCborArray como QCborArray::begin(), QCborArray::end() o QCborArray::insert(). Solo después de eso es posible la iteración.
La mayoría de las funciones de « QCborArray » aceptan un índice entero en lugar de un iterador. Por ese motivo, los iteradores rara vez resultan útiles en relación con ` QCborArray`. Un caso en el que los iteradores al estilo STL sí tienen sentido es como argumentos de ` generic algorithms`.
Se pueden utilizar varios iteradores en la misma matriz. Sin embargo, hay que tener en cuenta que cualquier llamada a una función no const realizada sobre ` QCborArray ` hará que todos los iteradores existentes queden indefinidos.
Véase también QCborArray::ConstIterator.
Documentación sobre tipos de miembros
Iterator::iterator_category
Sinónimo de «std::random_access_iterator_tag» que indica que este iterador es un iterador de acceso aleatorio.
Documentación de las funciones miembro
[constexpr noexcept default] Iterator::Iterator()
Crea un iterador no inicializado.
No se deben invocar funciones como operator*() y operator++() en un iterador no inicializado. Utiliza operator=() para asignarle un valor antes de utilizarlo.
Véase también QCborArray::begin() y QCborArray::end().
[constexpr noexcept default] Iterator::Iterator(const QCborArray::Iterator &other)
Crea una copia de other.
QCborValueRef Iterator::operator*() const
Devuelve una referencia modificable al elemento actual.
Se puede cambiar el valor de un elemento utilizando el operador *() en el lado izquierdo de una asignación.
El valor devuelto es de tipo QCborValueRef, una clase auxiliar para QCborArray y QCborMap. Cuando se obtiene un objeto de tipo QCborValueRef, se puede utilizar como si fuera una referencia a un QCborValue. Si se le asigna un valor, la asignación se aplicará al elemento de QCborArray o QCborMap del que se obtuvo la referencia.
QCborArray::Iterator Iterator::operator+(qsizetype j) const
Devuelve un iterador al elemento situado en la posición j pasos hacia delante desde este iterador. Si j es negativo, el iterador se desplaza hacia atrás.
Véanse también operator-() y operator+=().
QCborArray::Iterator &Iterator::operator++()
El operador prefijo « ++ », ++it, hace avanzar el iterador hasta el siguiente elemento del array y devuelve dicho iterador.
La llamada a esta función en QCborArray::end() da lugar a resultados indefinidos.
Véase también operator--().
QCborArray::Iterator Iterator::operator++(int)
El operador postfijo « ++ », it++, avanza el iterador hasta el siguiente elemento del array y devuelve un iterador que apunta al elemento que era el actual en ese momento.
Se trata de una función sobrecargada.
QCborArray::Iterator &Iterator::operator+=(qsizetype j)
Avanza el iterador j posiciones. Si j es negativo, el iterador retrocede. Devuelve una referencia a este iterador.
Véanse también operator-=() y operator+().
qsizetype Iterator::operator-(QCborArray::Iterator other) const
Devuelve el desplazamiento de este iterador con respecto a other.
QCborArray::Iterator Iterator::operator-(qsizetype j) const
Devuelve un iterador al elemento situado en la posición j pasos hacia atrás desde este iterador. Si j es negativo, el iterador avanza.
Véase también operator+() y operator-=().
QCborArray::Iterator &Iterator::operator--()
El operador prefijo --, --it, convierte el elemento anterior en el elemento actual y devuelve este iterador.
La llamada a esta función en QCborArray::begin() da lugar a resultados indefinidos.
Véase también ` operator++()`.
QCborArray::Iterator Iterator::operator--(int)
El operador postfijo « -- », it--, convierte el elemento anterior en el elemento actual y devuelve un iterador al elemento que era el actual anteriormente.
Se trata de una función sobrecargada.
QCborArray::Iterator &Iterator::operator-=(qsizetype j)
Hace que el iterador retroceda j posiciones. Si j es negativo, el iterador avanza. Devuelve una referencia a este iterador.
Véase también operator+=() y operator-().
const QCborValueConstRef *Iterator::operator->() const
Devuelve un puntero a una referencia modificable del elemento actual.
QCborArray::Iterator &Iterator::operator=(const QCborArray::Iterator &other)
Convierte este iterador en una copia de other y devuelve una referencia a este iterador.
QCborValueRef Iterator::operator[](qsizetype j) const
Devuelve una referencia modificable al elemento situado a una distancia de j pasos hacia delante del elemento al que apunta este iterador.
Esta función se proporciona para que los iteradores de QCborArray se comporten como punteros de C++.
El valor devuelto es de tipo QCborValueRef, una clase auxiliar para QCborArray y QCborMap. Cuando se obtiene un objeto de tipo QCborValueRef, se puede utilizar como si fuera una referencia a un QCborValue. Si se le asigna un valor, la asignación se aplicará al elemento de QCborArray o QCborMap del que se obtuvo la referencia.
Véase también operator+().
Elementos no miembros relacionados
[noexcept] bool operator!=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator!=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Devuelve true si lhs apunta a una entrada del array distinta a la del iterador rhs; en caso contrario, devuelve false.
Véase también operator==().
[noexcept] bool operator<(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator<(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Devuelve ` true ` si la entrada del array a la que apunta el iterador ` lhs ` aparece antes que la entrada a la que apunta el iterador ` rhs `.
[noexcept] bool operator<=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator<=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Devuelve ` true ` si la entrada del array a la que apunta el iterador ` lhs ` se encuentra antes o es la misma que la que señala el iterador ` rhs `.
[noexcept] bool operator==(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator==(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Devuelve ` true ` si ` lhs ` apunta a la misma entrada del array que el iterador ` rhs `; en caso contrario, devuelve ` false`.
Véase también operator!=().
[noexcept] bool operator>(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator>(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Devuelve ` true ` si la entrada del array a la que apunta el iterador ` lhs ` se encuentra después de la entrada a la que apunta el iterador ` rhs `.
[noexcept] bool operator>=(const QCborArray::Iterator &lhs, const QCborArray::ConstIterator &rhs)
[noexcept] bool operator>=(const QCborArray::Iterator &lhs, const QCborArray::Iterator &rhs)
Devuelve ` true ` si la entrada del array a la que apunta el iterador ` lhs ` se encuentra después de la entrada a la que apunta el iterador ` rhs `, o si es la misma entrada.
© 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.