En esta página

QAssociativeIterable Class

La clase QAssociativeIterable es una interfaz iterable para un contenedor asociativo en un QVariant. Más...

Cabecera: #include <QAssociativeIterable>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Hereda: QIterable
Status: Hasta 6.15

Esta clase está programada para ser 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

Utilice QMetaAssociation::Iterable en su lugar.

Esta clase permite varios métodos de acceso a los elementos de un contenedor asociativo mantenido dentro de un QVariant. Se puede extraer una instancia de QAssociativeIterable de un QVariant si se puede convertir a un QVariantHash o 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 de tipos de miembros

[alias] QAssociativeIterable::BidirectionalConstIterator

Expone un const_iterator usando std::bidirectional_iterator_tag.

[alias] QAssociativeIterable::BidirectionalIterator

Expone un iterador utilizando std::bidirectional_iterator_tag.

[alias] QAssociativeIterable::ForwardConstIterator

Expone un const_iterator usando std::forward_iterator_tag.

[alias] QAssociativeIterable::ForwardIterator

Expone un iterador utilizando std::forward_iterator_tag.

[alias] QAssociativeIterable::InputConstIterator

Expone un const_iterator usando std::input_iterator_tag.

[alias] QAssociativeIterable::InputIterator

Expone un iterador utilizando std::input_iterator_tag.

[alias] QAssociativeIterable::RandomAccessConstIterator

Expone un const_iterator usando std::random_access_iterator_tag.

[alias] QAssociativeIterable::RandomAccessIterator

Expone un iterador usando std::random_access_iterator_tag.

[alias, until 6.15] QAssociativeIterable::const_iterator

Este typedef está previsto que desaparezca en la versión 6.15.

Utilice QMetaAssociation::Iterable::ConstIterator en su lugar.

El QAssociativeIterable::const_iterator permite la iteración sobre un contenedor en un QVariant.

Un QAssociativeIterable::const_iterator sólo puede ser creado por una instancia de QAssociativeIterable, y puede ser usado de forma similar a otros iteradores de estilo stl.

Véase también QAssociativeIterable.

[alias, since 6.0, until 6.15] QAssociativeIterable::iterator

Este typedef está previsto que desaparezca en la versión 6.15.

Utilice QMetaAssociation::Iterable::Iterator en su lugar.

El QAssociativeIterable::iterator permite la iteración sobre un contenedor en un QVariant.

Un QAssociativeIterable::iterator sólo puede ser creado por una instancia de QAssociativeIterable, y puede ser usado 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 las funciones miembro

bool QAssociativeIterable::containsKey(const QVariant &key)

Devuelve true si el contenedor tiene una entrada con el tipo key, o false en caso contrario. Si 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 en el key dado, o al final del contenedor si esa clave no existe. Si 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 valor key, o restablece el valor asignado de cualquier entrada existente con el valor key al valor asignado construido por defecto. 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 en la clave dada key, o al final del contenedor si esa clave no existe. Si 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 la dirección key indicada. 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 key no es convertible al tipo de clave, se sobrescribe el valor para el tipo de clave construido por defecto.

Véase también value().

QVariant QAssociativeIterable::value(const QVariant &key) const

Recupera el valor mapeado en el key dado, o un QVariant construido por defecto del tipo mapeado, si la clave no existe. Si key no es convertible al tipo de clave, se devuelve el valor asignado asociado a la clave construida 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.