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ía | Tipos comparables |
|---|---|
| igualdad | QMetaAssociation |
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() |
Elementos no miembros relacionados
| 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.