En esta página

QMetaAssociation Class

La clase QMetaAssociation permite el acceso con tipo borrado a contenedores asociativos. Más información...

Encabezado: #include <QMetaAssociation>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Desde: Qt 6.0
Heredado de: QMetaContainer

Comparaciones de QMetaAssociation

CategoríaTipos comparables
igualdadQMetaAssociation

Tipos públicos

(since 6.11) class Iterable

Funciones públicas

QMetaAssociation()
bool canContainsKey() const
bool canCreateConstIteratorAtKey() const
bool canCreateIteratorAtKey() const
bool canGetKeyAtConstIterator() const
bool canGetKeyAtIterator() const
bool canGetMappedAtConstIterator() const
bool canGetMappedAtIterator() const
bool canGetMappedAtKey() const
bool canInsertKey() const
bool canRemoveKey() const
bool canSetMappedAtIterator() const
bool canSetMappedAtKey() const
bool containsKey(const void *container, const void *key) const
void *createConstIteratorAtKey(const void *container, const void *key) const
void *createIteratorAtKey(void *container, const void *key) const
void insertKey(void *container, const void *key) const
void keyAtConstIterator(const void *iterator, void *key) const
void keyAtIterator(const void *iterator, void *key) const
QMetaType keyMetaType() const
void mappedAtConstIterator(const void *iterator, void *mapped) const
void mappedAtIterator(const void *iterator, void *mapped) const
void mappedAtKey(const void *container, const void *key, void *mapped) const
QMetaType mappedMetaType() const
void removeKey(void *container, const void *key) const
void setMappedAtIterator(const void *iterator, const void *mapped) const
void setMappedAtKey(void *container, const void *key, const void *mapped) const

Miembros públicos estáticos

(since 6.0) QMetaAssociation fromContainer()
bool operator!=(const QMetaAssociation &lhs, const QMetaAssociation &rhs)
bool operator==(const QMetaAssociation &lhs, const QMetaAssociation &rhs)

Descripción detallada

La clase proporciona una serie de operaciones primitivas con contenedores, utilizando void* como operandos. De este modo, se puede manipular un contenedor genérico obtenido de un Variant sin conocer su tipo.

QMetaAssociation abarca tanto contenedores con valores asignados, como QMap o QHash, como contenedores que solo contienen claves, como QSet.

Los argumentos `void*` de los distintos métodos suelen crearse utilizando un ` QVariant ` del contenedor o tipo de valor correspondiente, y llamando a sus métodos ` QVariant::data()` o ` QVariant::constData()`. Sin embargo, también se pueden pasar punteros simples a objetos del contenedor o del tipo de valor.

La invalidación de los iteradores sigue las reglas establecidas por los contenedores subyacentes y no se especifica en la API. Por lo tanto, en el caso de un contenedor verdaderamente genérico, cualquier iterador debe considerarse inválido tras cualquier operación de escritura.

Véase también QMetaContainer, QMetaSequence, QIterable y QIterator.

Documentación de las funciones miembro

[constexpr noexcept default] QMetaAssociation::QMetaAssociation()

Crea de forma predeterminada una instancia de ` QMetaAssociation`.

bool QMetaAssociation::canContainsKey() const

Devuelve ` true ` si se pueden consultar las claves del contenedor mediante ` containsKey()`; en caso contrario, devuelve ` false`.

bool QMetaAssociation::canCreateConstIteratorAtKey() const

Devuelve ` true ` si se puede crear un iterador constante que apunte a una entrada del contenedor mediante ` createConstIteratorAtKey()`; en caso contrario, devuelve `false`.

bool QMetaAssociation::canCreateIteratorAtKey() const

Devuelve « true » si se puede crear un iterador que apunte a una entrada del contenedor mediante « createIteratorAtKey()»; en caso contrario, devuelve «false».

Véase también ` createIteratorAtKey()`.

bool QMetaAssociation::canGetKeyAtConstIterator() const

Devuelve ` true ` si se puede recuperar una clave a partir de un iterador `const` mediante ` keyAtConstIterator()`; en caso contrario, devuelve ` false`.

Véase también keyAtConstIterator().

bool QMetaAssociation::canGetKeyAtIterator() const

Devuelve ` true ` si es posible recuperar una clave a partir de un iterador no constante mediante ` keyAtIterator()`; en caso contrario, devuelve ` false`.

Véase también keyAtIterator().

bool QMetaAssociation::canGetMappedAtConstIterator() const

Devuelve ` true ` si se puede recuperar un valor mapeado a partir de un iterador constante mediante ` mappedAtConstIterator()`; en caso contrario, devuelve ` false`.

Véase también mappedAtConstIterator().

bool QMetaAssociation::canGetMappedAtIterator() const

Devuelve ` true ` si se puede recuperar un valor mapeado desde un iterador no constante mediante ` mappedAtIterator()`, y en caso contrario devuelve ` false`.

Véase también ` mappedAtIterator()`.

bool QMetaAssociation::canGetMappedAtKey() const

Devuelve ` true ` si se pueden consultar los valores del contenedor mediante ` mappedAtKey()`; en caso contrario, devuelve ` false`.

bool QMetaAssociation::canInsertKey() const

Devuelve « true » si se pueden añadir claves al contenedor mediante « insertKey()»; en caso contrario, devuelve « false ».

Véase también insertKey().

bool QMetaAssociation::canRemoveKey() const

Devuelve ` true ` si las claves se pueden eliminar del contenedor mediante ` removeKey()`, y en caso contrario devuelve ` false`.

Véase también removeKey().

bool QMetaAssociation::canSetMappedAtIterator() const

Devuelve ` true ` si se puede establecer un valor mapeado mediante un iterador no constante utilizando ` setMappedAtIterator()`; en caso contrario, devuelve ` false`.

Véase también setMappedAtIterator().

bool QMetaAssociation::canSetMappedAtKey() const

Devuelve ` true ` si los valores asignados pueden modificarse en el contenedor mediante ` setMappedAtKey()`; en caso contrario, devuelve ` false`.

Véase también ` setMappedAtKey()`.

bool QMetaAssociation::containsKey(const void *container, const void *key) const

Devuelve ` true ` si es posible consultar las claves de ` container ` y este contiene ` key`; en caso contrario, devuelve ` false`.

Véase también canContainsKey().

void *QMetaAssociation::createConstIteratorAtKey(const void *container, const void *key) const

Devuelve un iterador const que apunta a la entrada de ` key ` en ` container`, si es posible. Si la entrada no existe, crea un iterador const que apunta al final de ` container`. Si no se puede crear ningún iterador const, devuelve ` nullptr`.

El iterador const debe destruirse mediante destroyConstIterator().

Véase también canCreateConstIteratorAtKey(), constBegin(), constEnd() y destroyConstIterator().

void *QMetaAssociation::createIteratorAtKey(void *container, const void *key) const

Devuelve un iterador no constante que apunta a la entrada de key en container, si es posible. Si la entrada no existe, crea un iterador no constante que apunta al final de container. Si no se puede crear ningún iterador no constante, devuelve nullptr.

El iterador no constante debe destruirse mediante la función destroyIterator().

Véanse también canCreateIteratorAtKey(), begin(), end() y destroyIterator().

[static constexpr, since 6.0] template <typename T> QMetaAssociation QMetaAssociation::fromContainer()

Devuelve el objeto ` QMetaAssociation ` correspondiente al tipo indicado como parámetro de plantilla.

Esta función se introdujo en Qt 6.0.

void QMetaAssociation::insertKey(void *container, const void *key) const

Inserta el ` key ` en el ` container ` si es posible. Si el contenedor tiene valores asignados, se asocia un valor asignado de creación por defecto al ` key`.

Véase también canInsertKey().

void QMetaAssociation::keyAtConstIterator(const void *iterator, void *key) const

Recupera la clave a la que apunta el const iterator y la almacena en la ubicación de memoria a la que apunta key, si es posible.

Véanse también canGetKeyAtConstIterator(), constBegin(), constEnd() y createConstIteratorAtKey().

void QMetaAssociation::keyAtIterator(const void *iterator, void *key) const

Recupera la clave a la que apunta la variable no constante ` iterator ` y la almacena en la ubicación de memoria a la que apunta ` key`, si es posible.

Véanse también canGetKeyAtIterator(), begin(), end() y createIteratorAtKey().

QMetaType QMetaAssociation::keyMetaType() const

Devuelve el metatipo de las claves del contenedor.

void QMetaAssociation::mappedAtConstIterator(const void *iterator, void *mapped) const

Recupera el valor mapeado al que apunta `const iterator ` y lo almacena en la ubicación de memoria a la que apunta ` mapped`, si es posible.

Véanse también canGetMappedAtConstIterator(), constBegin(), constEnd() y createConstIteratorAtKey().

void QMetaAssociation::mappedAtIterator(const void *iterator, void *mapped) const

Recupera el valor mapeado al que apunta el objeto no constante ` iterator ` y lo almacena en la ubicación de memoria a la que apunta ` mapped`, si es posible.

Véanse también setMappedAtIterator(), canGetMappedAtIterator(), begin(), end() y createIteratorAtKey().

void QMetaAssociation::mappedAtKey(const void *container, const void *key, void *mapped) const

Recupera el valor asignado asociado a la entrada ` key ` en la tabla de hash ` container ` y lo coloca en la ubicación de memoria a la que apunta ` mapped`, si es posible.

Véanse también setMappedAtKey() y canGetMappedAtKey().

QMetaType QMetaAssociation::mappedMetaType() const

Devuelve el metatipo de los valores asignados en el contenedor.

void QMetaAssociation::removeKey(void *container, const void *key) const

Elimina el objeto « key » y su valor asociado del objeto « container », si es posible.

Véase también canRemoveKey().

void QMetaAssociation::setMappedAtIterator(const void *iterator, const void *mapped) const

Escribe el valor de ` mapped ` en la ubicación del contenedor a la que apunta ` iterator` (no constante), si es posible.

Véase también mappedAtIterator(), canSetMappedAtIterator(), begin(), end() y createIteratorAtKey().

void QMetaAssociation::setMappedAtKey(void *container, const void *key, const void *mapped) const

Sobrescribe el valor asociado a ` key ` en ` container ` utilizando el valor de ` mapped ` pasado como argumento, si es posible.

Véanse también mappedAtKey() y canSetMappedAtKey().

Elementos no miembros relacionados

[noexcept] bool operator!=(const QMetaAssociation &lhs, const QMetaAssociation &rhs)

Devuelve « true » si « QMetaAssociation » lhs representa un tipo de contenedor distinto al de « QMetaAssociation » rhs; en caso contrario, devuelve « false ».

[noexcept] bool operator==(const QMetaAssociation &lhs, const QMetaAssociation &rhs)

Devuelve « true » si el objeto ` QMetaAssociation ` lhs representa el mismo tipo de contenedor que el objeto ` QMetaAssociation ` rhs; en caso contrario, devuelve « false ».

© 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.