QMetaSequence Class
La clase QMetaSequence permite el acceso con borrado de tipos a contenedores secuenciales. Más información...
| Encabezado: | #include <QMetaSequence> |
| 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 QMetaSequence
| Categoría | Tipos comparables |
|---|---|
| igualdad | QMetaSequence |
Tipos públicos
(since 6.11) class | Iterable |
Funciones públicas
| QMetaSequence() | |
| void | addValue(void *container, const void *value) const |
| void | addValueAtBegin(void *container, const void *value) const |
| void | addValueAtEnd(void *container, const void *value) const |
| bool | canAddValue() const |
| bool | canAddValueAtBegin() const |
| bool | canAddValueAtEnd() const |
| bool | canEraseRangeAtIterator() const |
| bool | canEraseValueAtIterator() const |
| bool | canGetValueAtConstIterator() const |
| bool | canGetValueAtIndex() const |
| bool | canGetValueAtIterator() const |
| bool | canInsertValueAtIterator() const |
| bool | canRemoveValue() const |
| bool | canRemoveValueAtBegin() const |
| bool | canRemoveValueAtEnd() const |
| bool | canSetValueAtIndex() const |
| bool | canSetValueAtIterator() const |
| void | eraseRangeAtIterator(void *container, const void *iterator1, const void *iterator2) const |
| void | eraseValueAtIterator(void *container, const void *iterator) const |
| void | insertValueAtIterator(void *container, const void *iterator, const void *value) const |
| bool | isSortable() const |
| void | removeValue(void *container) const |
| void | removeValueAtBegin(void *container) const |
| void | removeValueAtEnd(void *container) const |
| void | setValueAtIndex(void *container, qsizetype index, const void *value) const |
| void | setValueAtIterator(const void *iterator, const void *value) const |
| void | valueAtConstIterator(const void *iterator, void *result) const |
| void | valueAtIndex(const void *container, qsizetype index, void *result) const |
| void | valueAtIterator(const void *iterator, void *result) const |
| QMetaType | valueMetaType() const |
Miembros públicos estáticos
(since 6.0) QMetaSequence | fromContainer() |
Elementos no miembros relacionados
(since 6.0) bool | operator!=(const QMetaSequence &lhs, const QMetaSequence &rhs) |
(since 6.0) bool | operator==(const QMetaSequence &lhs, const QMetaSequence &rhs) |
Descripción detallada
La clase proporciona una serie de operaciones primitivas de contenedor, utilizando void* como operandos. De este modo, se puede manipular un contenedor genérico obtenido de un Variant sin conocer su tipo.
Los argumentos `void*` de los distintos métodos se crean normalmente 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 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.
Documentación de las funciones miembro
[constexpr noexcept default] QMetaSequence::QMetaSequence()
Crea por defecto una instancia de ` QMetaSequence`.
void QMetaSequence::addValue(void *container, const void *value) const
Añade value a container si es posible. Si canAddValue() devuelve false, value no se añade. De lo contrario, si canAddValueAtEnd() devuelve true, value se añade al final de container. De lo contrario, si canAddValueAtBegin() devuelve true, value se añade al principio del contenedor. De lo contrario, el valor se añade en un lugar no especificado o no se añade en absoluto. Este último es el caso cuando se añaden valores a un contenedor no ordenado, por ejemplo, QSet.
Véase también canAddValue(), canAddValueAtBegin(), canAddValueAtEnd(), isSortable() y removeValue().
void QMetaSequence::addValueAtBegin(void *container, const void *value) const
Añade value al principio de container si es posible. Si canAddValueAtBegin() devuelve false, no se añade value.
Véase también canAddValueAtBegin(), isSortable() y removeValueAtBegin().
void QMetaSequence::addValueAtEnd(void *container, const void *value) const
Añade value al final de container si es posible. Si canAddValueAtEnd() devuelve false, no se añade value.
Véase también canAddValueAtEnd(), isSortable() y removeValueAtEnd().
bool QMetaSequence::canAddValue() const
Devuelve ` true ` si se pueden añadir valores al contenedor; en caso contrario, devuelve ` false `.
Véase también addValue() y isSortable().
bool QMetaSequence::canAddValueAtBegin() const
Devuelve ` true ` si los valores añadidos mediante ` addValue()` pueden colocarse al principio del contenedor; en caso contrario, devuelve ` false`.
Véase también addValueAtBegin() y canAddValueAtEnd().
bool QMetaSequence::canAddValueAtEnd() const
Devuelve ` true ` si los valores añadidos mediante ` addValue()` pueden colocarse al final del contenedor; en caso contrario, devuelve ` false`.
Véase también addValueAtEnd() y canAddValueAtBegin().
bool QMetaSequence::canEraseRangeAtIterator() const
Devuelve ` true ` si es posible borrar del contenedor un intervalo comprendido entre dos iteradores; en caso contrario, devuelve ` false `.
bool QMetaSequence::canEraseValueAtIterator() const
Devuelve ` true ` si el valor al que apunta un iterador no constante puede borrarse; en caso contrario, devuelve ` false `.
Véase también hasIterator() y eraseValueAtIterator().
bool QMetaSequence::canGetValueAtConstIterator() const
Devuelve ` true ` si el contenedor subyacente puede recuperar el valor al que apunta un iterador constante; en caso contrario, devuelve ` false `.
Véase también hasConstIterator() y valueAtConstIterator().
bool QMetaSequence::canGetValueAtIndex() const
Devuelve ` true ` si se pueden recuperar valores del contenedor por índice; en caso contrario, devuelve ` false`.
Véase también valueAtIndex().
bool QMetaSequence::canGetValueAtIterator() const
Devuelve ` true ` si el contenedor subyacente puede recuperar el valor al que apunta un iterador no constante; en caso contrario, devuelve ` false `.
Véase también hasIterator() y valueAtIterator().
bool QMetaSequence::canInsertValueAtIterator() const
Devuelve ` true ` si el contenedor subyacente puede insertar un nuevo valor, teniendo en cuenta la posición a la que apunta un iterador no constante.
Véanse también ` hasIterator()` y ` insertValueAtIterator()`.
bool QMetaSequence::canRemoveValue() const
Devuelve « true » si se pueden eliminar valores del contenedor; en caso contrario, devuelve « false ».
Véase también removeValue() y isSortable().
bool QMetaSequence::canRemoveValueAtBegin() const
Devuelve ` true ` si se pueden eliminar valores del principio del contenedor utilizando ` removeValue()`; en caso contrario, devuelve ` false`.
Véase también removeValueAtBegin() y canRemoveValueAtEnd().
bool QMetaSequence::canRemoveValueAtEnd() const
Devuelve ` true ` si se pueden eliminar valores del final del contenedor mediante ` removeValue()`; en caso contrario, devuelve ` false`.
Véase también removeValueAtEnd() y canRemoveValueAtBegin().
bool QMetaSequence::canSetValueAtIndex() const
Devuelve ` true ` si se puede escribir un valor en el contenedor mediante el índice; en caso contrario, devuelve ` false`.
Véase también setValueAtIndex().
bool QMetaSequence::canSetValueAtIterator() const
Devuelve ` true ` si el contenedor subyacente permite escribir en el valor al que apunta un iterador no constante; en caso contrario, devuelve ` false `.
Véase también hasIterator() y setValueAtIterator().
void QMetaSequence::eraseRangeAtIterator(void *container, const void *iterator1, const void *iterator2) const
Borra el rango de valores comprendido entre los iteradores iterator1 y iterator2 de la lista container, si es posible.
Véanse también canEraseValueAtIterator(), begin() y end().
void QMetaSequence::eraseValueAtIterator(void *container, const void *iterator) const
Borra el valor al que apunta el objeto no constante ` iterator ` de la lista ` container`, si es posible.
Véanse también canEraseValueAtIterator(), begin() y end().
[static constexpr, since 6.0] template <typename T> QMetaSequence QMetaSequence::fromContainer()
Devuelve el objeto ` QMetaSequence ` correspondiente al tipo indicado como parámetro de plantilla.
Esta función se introdujo en Qt 6.0.
void QMetaSequence::insertValueAtIterator(void *container, const void *iterator, const void *value) const
Inserta ` value ` en ` container`, si es posible, teniendo en cuenta que ` iterator ` no es una constante. Si ` canInsertValueAtIterator()` devuelve ` false`, no se inserta ` value `. De lo contrario, si ` isSortable()` devuelve ` true`, el valor se inserta antes del valor al que apunta ` iterator`. En caso contrario, ` value ` se inserta en una posición no especificada o no se inserta en absoluto. En este último caso, el ` iterator ` se toma como una sugerencia. Si apunta al lugar correcto para el ` value`, la operación puede ser más rápida que un ` addValue()` sin iterador.
Véase también canInsertValueAtIterator(), isSortable(), begin() y end().
bool QMetaSequence::isSortable() const
Devuelve ` true ` si el contenedor subyacente es ordenable; en caso contrario, devuelve ` false`. Se considera que un contenedor es ordenable si los valores que se añaden a él se colocan en una ubicación definida. La inserción o adición en un contenedor ordenable siempre se realizará con éxito. La inserción o adición de elementos en un contenedor no ordenable puede no tener éxito, por ejemplo, si el contenedor es un « QSet » que ya contiene el valor que se va a insertar.
Véase también addValue(), insertValueAtIterator(), canAddValueAtBegin(), canAddValueAtEnd(), canRemoveValueAtBegin() y canRemoveValueAtEnd().
void QMetaSequence::removeValue(void *container) const
Elimina un valor de la lista « container » si es posible. Si la función « canRemoveValue()» devuelve « false », no se elimina ningún valor. De lo contrario, si la función « canRemoveValueAtEnd()» devuelve « true », se elimina el último valor de la lista « container ». De lo contrario, si la función « canRemoveValueAtBegin()» devuelve « true », se elimina el primer valor de la lista « container ». De lo contrario, se elimina un valor no especificado o no se elimina nada.
Véase también canRemoveValue(), canRemoveValueAtBegin(), canRemoveValueAtEnd(), isSortable() y addValue().
void QMetaSequence::removeValueAtBegin(void *container) const
Elimina un valor del principio de container si es posible. Si canRemoveValueAtBegin() devuelve false, el valor no se elimina.
Véase también canRemoveValueAtBegin(), isSortable() y addValueAtBegin().
void QMetaSequence::removeValueAtEnd(void *container) const
Elimina un valor del final de container si es posible. Si canRemoveValueAtEnd() devuelve false, el valor no se elimina.
Véanse también canRemoveValueAtEnd(), isSortable() y addValueAtEnd().
void QMetaSequence::setValueAtIndex(void *container, qsizetype index, const void *value) const
Sobrescribe el valor de index en container utilizando el value pasado como parámetro, si es posible.
Véase también valueAtIndex() y canSetValueAtIndex().
void QMetaSequence::setValueAtIterator(const void *iterator, const void *value) const
Escribe value en el valor al que apunta la variable no constante iterator, si es posible.
Véanse también valueAtIterator(), canSetValueAtIterator(), begin() y end().
void QMetaSequence::valueAtConstIterator(const void *iterator, void *result) const
Recupera el valor al que apunta la constante ` iterator ` y lo almacena en la ubicación de memoria a la que apunta ` result`, si es posible.
Véanse también canGetValueAtConstIterator(), constBegin() y constEnd().
void QMetaSequence::valueAtIndex(const void *container, qsizetype index, void *result) const
Recupera el valor de index en el container y lo almacena en la ubicación de memoria a la que apunta result, si es posible.
Véase también setValueAtIndex() y canGetValueAtIndex().
void QMetaSequence::valueAtIterator(const void *iterator, void *result) const
Recupera el valor al que apunta la variable no constante ` iterator ` y lo almacena en la ubicación de memoria a la que apunta ` result`, si es posible.
Véase también setValueAtIterator(), canGetValueAtIterator(), begin() y end().
QMetaType QMetaSequence::valueMetaType() const
Devuelve el tipo de metadatos de los valores almacenados en el contenedor.
Elementos no miembros relacionados
[noexcept, since 6.0] bool operator!=(const QMetaSequence &lhs, const QMetaSequence &rhs)
Devuelve « true » si « QMetaSequence » lhs representa un tipo de contenedor distinto al de « QMetaSequence » rhs; en caso contrario, devuelve « false ».
Esta función se introdujo en Qt 6.0.
[noexcept, since 6.0] bool operator==(const QMetaSequence &lhs, const QMetaSequence &rhs)
Devuelve « true » si « QMetaSequence » lhs representa el mismo tipo de contenedor que « QMetaSequence » rhs; en caso contrario, devuelve « false ».
Esta función se introdujo en Qt 6.0.
© 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.