QAssociativeIterable Class
La clase `QAssociativeIterable` es una interfaz iterable para un contenedor asociativo en un ` QVariant`. Más información...
| Encabezado: | #include <QAssociativeIterable> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredado de: | QIterable |
| Estado: | Hasta la versión 6.15 |
Está previsto que esta clase quede obsoleta en la versión 6.15.
Tipos públicos
| BidirectionalConstIterator | |
| BidirectionalIterator | |
| ForwardConstIterator | |
| ForwardIterator | |
| InputConstIterator | |
| InputIterator | |
| RandomAccessConstIterator | |
| RandomAccessIterator | |
(until 6.15) | const_iterator |
(since 6.0, until 6.15) | iterator |
Funciones públicas
| bool | containsKey(const QVariant &key) |
| QAssociativeIterable::const_iterator | find(const QVariant &key) const |
| void | insertKey(const QVariant &key) |
| QAssociativeIterable::iterator | mutableFind(const QVariant &key) |
| void | removeKey(const QVariant &key) |
| void | setValue(const QVariant &key, const QVariant &mapped) |
| QVariant | value(const QVariant &key) const |
Descripción detallada
Utiliza en su lugar ` QMetaAssociation::Iterable `.
Esta clase permite varios métodos para acceder a los elementos de un contenedor asociativo almacenado en un ` QVariant`. Se puede extraer una instancia de `QAssociativeIterable` de un ` QVariant ` si este se puede convertir en un ` QVariantHash ` o un ` QVariantMap `, o si se ha registrado una vista mutable personalizada.
El contenedor en sí no se copia antes de iterar sobre él.
Véase también QVariant.
Documentación sobre los tipos de miembros
[alias] QAssociativeIterable::BidirectionalConstIterator
Expone un ` const_iterator ` utilizando `std::bidirectional_iterator_tag`.
[alias] QAssociativeIterable::BidirectionalIterator
Expone un iterador mediante std::bidirectional_iterator_tag.
[alias] QAssociativeIterable::ForwardConstIterator
Expone un ` const_iterator ` utilizando `std::forward_iterator_tag`.
[alias] QAssociativeIterable::ForwardIterator
Expone un iterador mediante std::forward_iterator_tag.
[alias] QAssociativeIterable::InputConstIterator
Expone un ` const_iterator ` utilizando `std::input_iterator_tag`.
[alias] QAssociativeIterable::InputIterator
Expone un iterador mediante std::input_iterator_tag.
[alias] QAssociativeIterable::RandomAccessConstIterator
Expone un ` const_iterator ` utilizando `std::random_access_iterator_tag`.
[alias] QAssociativeIterable::RandomAccessIterator
Expone un iterador mediante std::random_access_iterator_tag.
[alias, until 6.15] QAssociativeIterable::const_iterator
Está previsto que este `typedef` quede obsoleto en la versión 6.15.
Utiliza en su lugar ` QMetaAssociation::Iterable::ConstIterator `.
El `QAssociativeIterable::const_iterator` permite iterar sobre un contenedor en un ` QVariant`.
Un QAssociativeIterable::const_iterator solo puede crearse a partir de una instancia de ` QAssociativeIterable ` y puede utilizarse de forma similar a otros iteradores de estilo STL.
Véase también ` QAssociativeIterable`.
[alias, since 6.0, until 6.15] QAssociativeIterable::iterator
Está previsto que este `typedef` quede obsoleto en la versión 6.15.
Utiliza en su lugar ` QMetaAssociation::Iterable::Iterator `.
El QAssociativeIterable::iterator permite iterar sobre un contenedor en un QVariant.
Un `QAssociativeIterable::iterator` solo puede crearse a partir de una instancia de ` QAssociativeIterable `, y puede utilizarse de forma similar a otros iteradores de estilo STL.
Este typedef se introdujo en Qt 6.0.
Véase también ` QAssociativeIterable`.
Documentación de funciones miembro
bool QAssociativeIterable::containsKey(const QVariant &key)
Devuelve ` true ` si el contenedor tiene una entrada con el valor ` key` indicado; en caso contrario, devuelve ` false `. Si el valor ` key ` no es convertible al tipo esperado, se devuelve ` false `.
QAssociativeIterable::const_iterator QAssociativeIterable::find(const QVariant &key) const
Recupera un ` const_iterator ` que apunta al elemento situado en la ` key` indicada, o al final del contenedor si dicha clave no existe. Si la ` key ` no es convertible al tipo esperado, se devuelve el final del contenedor.
void QAssociativeIterable::insertKey(const QVariant &key)
Inserta una nueva entrada con el ` key` indicado, o restablece el valor mapeado de cualquier entrada existente con el ` key ` indicado al valor mapeado predeterminado. El ` key ` se convierte al tipo esperado: si no es convertible, se inserta un valor por defecto.
QAssociativeIterable::iterator QAssociativeIterable::mutableFind(const QVariant &key)
Recupera un iterador que apunta al elemento correspondiente a la clave dada ` key`, o al final del contenedor si dicha clave no existe. Si la clave ` key ` no es convertible al tipo esperado, se devuelve el final del contenedor.
void QAssociativeIterable::removeKey(const QVariant &key)
Elimina del contenedor la entrada con el key indicado. El key se convierte al tipo esperado: si no es convertible, se elimina el valor por defecto.
void QAssociativeIterable::setValue(const QVariant &key, const QVariant &mapped)
Establece el valor asignado asociado a key en mapped, si es posible. Inserta una nueva entrada si aún no existe ninguna, para el key dado. Si el key no es convertible al tipo de clave, se sobrescribe el valor del tipo de clave construido por defecto.
Véase también value().
QVariant QAssociativeIterable::value(const QVariant &key) const
Recupera el valor mapeado en la clave dada key, o un QVariant del tipo mapeado creado por defecto, si la clave no existe. Si el key no es convertible al tipo de la clave, se devuelve el valor mapeado asociado a la clave creada por defecto.
Véase también setValue().
© 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.