En esta página

QMetaAssociation::Iterable Class

class QMetaAssociation::Iterable

QMetaAssociation::Iterable es una interfaz iterable para un contenedor asociativo en un QVariant. Más información...

Esta clase se introdujo en Qt 6.11.

Tipos públicos

Funciones públicas

bool containsKey(const QVariant &key) const
QMetaAssociation::Iterable::ConstIterator find(const QVariant &key) const
void insertKey(const QVariant &key)
QMetaAssociation::Iterable::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

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 ` QMetaAssociation::Iterable ` de un ` QVariant ` si este se puede convertir en un ` QVariantHash ` o un ` QVariantMap `, o si se ha registrado una vista mutable personalizada.

QHash<int, QString> mapping;
mapping.insert(7,  «Siete»);
mapping.insert(11,  «Once»);
mapping.insert(42,  «Cuarenta y dos»);

QVariant variant = QVariant::fromValue(mapping);
if (variant.canConvert<QVariantHash>()) {
    QMetaAssociation::Iterable iterable = variant.value<QMetaAssociation::Iterable>();
    // Se puede utilizar el bucle «range-for» de C++11 sobre los valores:
    for (const QVariant&v: iterable) {
        qDebug() << v;
    }
    // Se pueden utilizar iteradores:
    QMetaAssociation::Iterable::const_iteratorit = iterable.begin();
    const QMetaAssociation::Iterable::const_iteratorend = iterable.end();
    for ( ; it != end;++it) {
        qDebug() << *it; // The current value
        qDebug() << it.key();
        qDebug() << it.value();
    }
}

El contenedor en sí no se copia antes de recorrerlo.

Véase también QVariant.

Documentación sobre tipos de miembro

[alias] Iterable::BidirectionalConstIterator

Expone un const_iterator mediante std::bidirectional_iterator_tag.

[alias] Iterable::BidirectionalIterator

Expone un iterador mediante std::bidirectional_iterator_tag.

[alias] Iterable::ForwardConstIterator

Expone un const_iterator mediante std::forward_iterator_tag.

[alias] Iterable::ForwardIterator

Expone un iterador mediante std::forward_iterator_tag.

[alias] Iterable::InputConstIterator

Expone un const_iterator mediante std::input_iterator_tag.

[alias] Iterable::InputIterator

Expone un iterador utilizando std::input_iterator_tag.

[alias] Iterable::RandomAccessConstIterator

Expone un const_iterator mediante std::random_access_iterator_tag.

[alias] Iterable::RandomAccessIterator

Expone un iterador mediante std::random_access_iterator_tag.

Documentación de las funciones miembro

bool Iterable::containsKey(const QVariant &key) const

Devuelve ` true ` si el contenedor tiene una entrada con el ` key` indicado; en caso contrario, devuelve ` false `. Si el ` key ` no es convertible al tipo esperado, se devuelve ` false `.

QMetaAssociation::Iterable::ConstIterator Iterable::find(const QVariant &key) const

Recupera un ` ConstIterator ` 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 Iterable::insertKey(const QVariant &key)

Inserta una nueva entrada con el valor « key » especificado, o restablece el valor asignado de cualquier entrada existente con el valor « key » especificado al valor asignado predeterminado. El valor « key » se convierte al tipo esperado: si no es convertible, se inserta un valor por defecto.

QMetaAssociation::Iterable::Iterator Iterable::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 Iterable::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 Iterable::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 Iterable::value(const QVariant &key) const

Recupera el valor asignado en la clave dada key, o un QVariant de una instancia del tipo asignado creada por defecto, si la clave no existe. Si el key no es convertible al tipo de la clave, se devuelve el valor asignado 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.