QMetaContainer Class
La clase `QMetaContainer` proporciona funcionalidades comunes para los contenedores secuenciales y asociativos. Más información...
| Encabezado: | #include <QMetaContainer> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Desde: | Qt 6.0 |
| Heredado por: |
Comparaciones de QMetaContainer
| Categoría | Tipos comparables |
|---|---|
| igualdad | QMetaContainer |
Funciones públicas
| QMetaContainer() | |
| void | advanceConstIterator(void *iterator, qsizetype step) const |
| void | advanceIterator(void *iterator, qsizetype step) const |
| void * | begin(void *container) const |
| bool | canClear() const |
| void | clear(void *container) const |
| bool | compareConstIterator(const void *i, const void *j) const |
| bool | compareIterator(const void *i, const void *j) const |
| void * | constBegin(const void *container) const |
| void * | constEnd(const void *container) const |
| void | copyConstIterator(void *target, const void *source) const |
| void | copyIterator(void *target, const void *source) const |
| void | destroyConstIterator(const void *iterator) const |
| void | destroyIterator(const void *iterator) const |
| qsizetype | diffConstIterator(const void *i, const void *j) const |
| qsizetype | diffIterator(const void *i, const void *j) const |
| void * | end(void *container) const |
| bool | hasBidirectionalIterator() const |
| bool | hasConstIterator() const |
| bool | hasForwardIterator() const |
| bool | hasInputIterator() const |
| bool | hasIterator() const |
| bool | hasRandomAccessIterator() const |
| bool | hasSize() const |
| qsizetype | size(const void *container) const |
Descripción detallada
QMetaContainer forma parte del sistema de metatipos de Qt, que permite el acceso con el tipo oculto a tipos similares a contenedores en tiempo de ejecución.
Sirve como base común para acceder a las propiedades de los contenedores de forma genérica, como el tamaño, la iteración y las operaciones de borrado, sin conocer el tipo real del contenedor.
Las clases derivadas, como QMetaSequence, proporcionan interfaces especializadas para contenedores secuenciales.
Documentación de funciones miembro
[constexpr noexcept default] QMetaContainer::QMetaContainer()
Crea por defecto una instancia de ` QMetaContainer`.
void QMetaContainer::advanceConstIterator(void *iterator, qsizetype step) const
Avanza el const iterator en step pasos. Si step es negativo, el iterator se desplaza hacia atrás, en dirección al principio del contenedor. El comportamiento no está especificado para valores negativos de step si hasBidirectionalIterator() devuelve «false».
Véanse también constBegin() y constEnd().
void QMetaContainer::advanceIterator(void *iterator, qsizetype step) const
Avanza el « iterator » no constante step pasos. Si step es negativo, el « iterator » se desplaza hacia atrás, en dirección al principio del contenedor. El comportamiento no está especificado para valores negativos de step si hasBidirectionalIterator() devuelve «false».
Véanse también begin() y end().
void *QMetaContainer::begin(void *container) const
Crea y devuelve un iterador no constante que apunta al principio de container. El iterador se asigna en el montón mediante «new». Finalmente, debe destruirse mediante « destroyIterator » para liberar la memoria.
Devuelve ` nullptr ` si el contenedor no ofrece ningún iterador no constante.
Véase también end(), constBegin(), constEnd() y destroyIterator().
bool QMetaContainer::canClear() const
Devuelve ` true ` si el contenedor se puede vaciar; en caso contrario, devuelve ` false `.
Véase también clear().
void QMetaContainer::clear(void *container) const
Borra el container indicado, si es posible hacerlo.
Véase también canClear().
bool QMetaContainer::compareConstIterator(const void *i, const void *j) const
Devuelve ` true ` si los iteradores constantes ` i ` y ` j ` apuntan al mismo valor en el contenedor por el que están iterando; en caso contrario, devuelve ` false`.
Véase también constBegin() y constEnd().
bool QMetaContainer::compareIterator(const void *i, const void *j) const
Devuelve ` true ` si los iteradores no constantes ` i ` y ` j ` apuntan al mismo valor en el contenedor por el que están iterando; en caso contrario, devuelve ` false`.
Véase también begin() y end().
void *QMetaContainer::constBegin(const void *container) const
Crea y devuelve un iterador const que apunta al principio de container. El iterador se asigna en el montón mediante `new`. Finalmente, debe destruirse mediante ` destroyConstIterator ` para liberar la memoria.
Devuelve ` nullptr ` si el contenedor no ofrece ningún iterador const.
Véase también constEnd(), begin(), end() y destroyConstIterator().
void *QMetaContainer::constEnd(const void *container) const
Crea y devuelve un iterador const que apunta al final de container. El iterador se asigna en el montón mediante new. Finalmente, debe destruirse mediante destroyConstIterator para liberar la memoria.
Devuelve ` nullptr ` si el contenedor no ofrece ningún iterador const.
Véase también constBegin(), begin(), end() y destroyConstIterator().
void QMetaContainer::copyConstIterator(void *target, const void *source) const
Copia el iterador const source en el iterador const target. A continuación, compareConstIterator(destino, origen) devuelve true.
Véase también constBegin() y constEnd().
void QMetaContainer::copyIterator(void *target, const void *source) const
Copia el iterador no constante source en el iterador no constante target. A continuación, compareIterator(destino, origen) devuelve true.
Véase también begin() y end().
void QMetaContainer::destroyConstIterator(const void *iterator) const
Destruye un objeto ` iterator ` constante creado previamente mediante ` constBegin()` o ` constEnd()`.
Véanse también constBegin(), constEnd() y destroyIterator().
void QMetaContainer::destroyIterator(const void *iterator) const
Destruye un objeto « iterator » no constante creado previamente mediante « begin()» o « end()».
Véanse también begin(), end() y destroyConstIterator().
qsizetype QMetaContainer::diffConstIterator(const void *i, const void *j) const
Devuelve la distancia entre los iteradores const i y j, lo que equivale a i - j . Si j está más cerca del final del contenedor que i, el valor devuelto es negativo. En este caso, el comportamiento no está especificado si hasBidirectionalIterator() devuelve false.
Véanse también constBegin() y constEnd().
qsizetype QMetaContainer::diffIterator(const void *i, const void *j) const
Devuelve la distancia entre los iteradores no constantes i y j, lo que equivale a i, - y j. Si j está más cerca del final del contenedor que i, el valor devuelto es negativo. En este caso, el comportamiento no está especificado si hasBidirectionalIterator() devuelve false.
Véanse también begin() y end().
void *QMetaContainer::end(void *container) const
Crea y devuelve un iterador no constante que apunta al final de container. El iterador se asigna en el montón mediante «new». Finalmente, debe destruirse mediante destroyIterator para liberar la memoria.
Devuelve ` nullptr ` si el contenedor no ofrece ningún iterador no constante.
Véanse también hasIterator(), begin(), constBegin(), constEnd() y destroyIterator().
bool QMetaContainer::hasBidirectionalIterator() const
Devuelve ` true ` si el contenedor subyacente proporciona un iterador bidireccional o un iterador de acceso aleatorio, tal y como se definen en `std::bidirectional_iterator_tag` y `std::random_access_iterator_tag`, respectivamente. En caso contrario, devuelve ` false`.
QMetaContainer Se supone que los iteradores const y no const de un mismo contenedor tienen los mismos rasgos de iterador.
bool QMetaContainer::hasConstIterator() const
Devuelve ` true ` si el contenedor subyacente ofrece un iterador `const`, y ` false ` en caso contrario.
Véase también constBegin(), constEnd(), destroyConstIterator(), compareConstIterator(), diffConstIterator(), advanceConstIterator() y copyConstIterator().
bool QMetaContainer::hasForwardIterator() const
Devuelve ` true ` si el contenedor subyacente proporciona al menos un iterador hacia adelante tal y como se define en `std::forward_iterator_tag`; en caso contrario, devuelve ` false`. Los iteradores bidireccionales y los iteradores de acceso aleatorio son especializaciones de los iteradores hacia adelante. Este método también devolverá ` true ` si el contenedor proporciona uno de ellos.
QMetaContainer Se supone que los iteradores const y no const para un mismo contenedor tienen los mismos rasgos de iterador.
bool QMetaContainer::hasInputIterator() const
Devuelve ` true ` si el contenedor subyacente proporciona al menos un iterador de entrada tal y como se define en `std::input_iterator_tag`; en caso contrario, devuelve ` false`. Los iteradores de avance, bidireccionales y de acceso aleatorio son especializaciones de los iteradores de entrada. Este método también devolverá ` true ` si el contenedor proporciona alguno de ellos.
QMetaContainer Se supone que los iteradores const y no const para un mismo contenedor tienen los mismos rasgos de iterador.
bool QMetaContainer::hasIterator() const
Devuelve ` true ` si el contenedor subyacente ofrece un iterador no constante; en caso contrario, devuelve ` false `.
Véase también begin(), end(), destroyIterator(), compareIterator(), diffIterator(), advanceIterator() y copyIterator().
bool QMetaContainer::hasRandomAccessIterator() const
Devuelve ` true ` si el contenedor subyacente proporciona un iterador de acceso aleatorio tal y como se define en `std::random_access_iterator_tag`; en caso contrario, devuelve ` false`.
QMetaContainer Se supone que los iteradores const y no const del mismo contenedor tienen los mismos rasgos de iterador.
bool QMetaContainer::hasSize() const
Devuelve « true » si es posible consultar el tamaño del contenedor; en caso contrario, devuelve « false ».
Véase también size().
qsizetype QMetaContainer::size(const void *container) const
Devuelve el número de valores que contiene el ` container ` dado, si es posible consultar su tamaño. De lo contrario, devuelve ` -1`.
Véase también hasSize().
© 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.