QMetaAssociation::Iterable Class

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

Esta clase se introdujo en Qt 6.11.

Lista de todos los miembros, incluyendo los heredados

Tipos públicos

`(since 6.11)` class	ConstIterator
`(since 6.11)` class	Iterator
	BidirectionalConstIterator
	BidirectionalIterator
	ForwardConstIterator
	ForwardIterator
	InputConstIterator
	InputIterator
	RandomAccessConstIterator
	RandomAccessIterator

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 de acceso a los elementos de un contenedor asociativo contenido en un QVariant. Una instancia de QMetaAssociation::Iterable puede extraerse de un QVariant si puede convertirse en un QVariantHash o 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 variante = QVariant::fromValue(cartografía);if (variant.canConvert<QVariantHash>()) { QMetaAssociation::Iterable iterable = variant.value<QMetaAssociation::Iterable>(); // Puede usar C++11 range-for sobre los valores: for(const QVariant &v: iterable) {        qDebug() << v;
    } // Puede utilizar iteradores:    QMetaAssociation::Iterable::const_iterator it = iterable.begin(); const QMetaAssociation::Iterable::const_iterator end = iterable.end(); for ( ; it != end; ++it) {        qDebug() << *it; // The current value
        qDebug() << it.key();
        qDebug() << it.value();
    } }

El propio contenedor no se copia antes de iterar sobre él.

Véase también QVariant.

Documentación de tipos de miembros

`[alias]` Iterable::BidirectionalConstIterator

Expone un const_iterator usando std::bidirectional_iterator_tag.

`[alias]` Iterable::BidirectionalIterator

Expone un iterador utilizando std::bidirectional_iterator_tag.

`[alias]` Iterable::ForwardConstIterator

Expone un const_iterator usando std::forward_iterator_tag.

`[alias]` Iterable::ForwardIterator

Expone un iterador utilizando std::forward_iterator_tag.

`[alias]` Iterable::InputConstIterator

Expone un const_iterator usando std::input_iterator_tag.

`[alias]` Iterable::InputIterator

Expone un iterador utilizando std::input_iterator_tag.

`[alias]` Iterable::RandomAccessConstIterator

Expone un const_iterator usando std::random_access_iterator_tag.

`[alias]` Iterable::RandomAccessIterator

Expone un iterador utilizando std::random_access_iterator_tag.

Documentación de la función miembro

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

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.

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

Recupera un ConstIterator 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 Iterable::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.

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

Recupera el valor mapeado en el key dado, o un QVariant de una instancia construida 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.