QMetaAssociation::Iterable Class
class QMetaAssociation::IterableQMetaAssociation::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
(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 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.