En esta página

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

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.