QCache Class
template <typename Key, typename T> class QCacheLa clase QCache es una clase de plantilla que proporciona una caché. Más información...
| Encabezado: | #include <QCache> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
- Lista de todos los miembros, incluidos los miembros heredados
- QCache forma parte de las clases compartidas implícitamente.
Nota: Todas las funciones de esta clase son reentrantes.
Funciones públicas
| QCache(qsizetype maxCost = 100) | |
| ~QCache() | |
| void | clear() |
| bool | contains(const Key &key) const |
| qsizetype | count() const |
| bool | insert(const Key &key, T *object, qsizetype cost = 1) |
| bool | isEmpty() const |
| QList<Key> | keys() const |
| qsizetype | maxCost() const |
| T * | object(const Key &key) const |
| bool | remove(const Key &key) |
| void | setMaxCost(qsizetype cost) |
| qsizetype | size() const |
| T * | take(const Key &key) |
| qsizetype | totalCost() const |
| T * | operator[](const Key &key) const |
Descripción detallada
QCache<Key, T> define una caché que almacena objetos de tipo T asociados a claves de tipo Key. Por ejemplo, esta es la definición de una caché que almacena objetos de tipo Employee asociados a una clave entera:
QCache<int, Employee> cache;A continuación se explica cómo insertar un objeto en la caché:
Employee *employee = new Employee;
employee->setId(37);
employee->setName("Richard Schmit");
//...
cache.insert(employee->id(), employee);La ventaja de utilizar QCache frente a otras estructuras de datos basadas en claves (como QMap o QHash) es que QCache asume automáticamente la propiedad de los objetos que se insertan en la caché y los elimina para dejar espacio a nuevos objetos, si es necesario. Al insertar un objeto en la caché, puedes especificar un coste, que debería guardar una relación aproximada con la cantidad de memoria que ocupa el objeto. Cuando la suma de los costes de todos los objetos (totalCost()) supera el límite de la caché (maxCost()), QCache comienza a eliminar objetos de la caché para mantenerse por debajo del límite, empezando por los objetos a los que se ha accedido con menos frecuencia.
Por defecto, el valor de ` maxCost()` de QCache es 100. Se puede especificar un valor diferente en el constructor de QCache:
QCache<int, MyDataStructure> cache(5000);Cada vez que se llama a ` insert()` se puede especificar un coste como tercer argumento (después de la clave y del puntero al objeto que se va a insertar). Tras la llamada, el objeto insertado pasa a ser propiedad de QCache, que puede eliminarlo en cualquier momento para dejar espacio a otros objetos.
Para buscar objetos en la caché, utiliza object() o el operador [](). Esta función busca un objeto por su clave y devuelve un puntero al objeto almacenado en caché (que es propiedad de la caché) o nullptr.
Si desea eliminar un objeto de la caché para una clave concreta, llame a remove(). Esto también eliminará el objeto. Si desea eliminar un objeto de la caché sin que QCache lo elimine, utilice take().
Véase también QPixmapCache, QHash y QMap.
Documentación de las funciones de miembro
[explicit noexcept] QCache::QCache(qsizetype maxCost = 100)
Crea una caché cuyo contenido nunca tendrá un coste total superior a maxCost.
QCache::~QCache()
Borra la caché. Elimina todos los objetos de la caché.
[noexcept(...)] void QCache::clear()
Elimina todos los objetos de la caché.
Nota: Esta función es «noexcept» cuando std::is_nothrow_destructible_v<Node> es true.
Véase también remove() y take().
[noexcept] bool QCache::contains(const Key &key) const
Devuelve ` true ` si la caché contiene un objeto asociado a la clave ` key`; en caso contrario, devuelve ` false`.
Véase también take() y remove().
[noexcept] qsizetype QCache::count() const
Es lo mismo que « size()».
bool QCache::insert(const Key &key, T *object, qsizetype cost = 1)
Inserta object en la caché con la clave key y el coste asociado cost. Cualquier objeto con la misma clave que ya se encuentre en la caché se eliminará.
Tras esta llamada, object pasa a ser propiedad de QCache y puede eliminarse en cualquier momento. En concreto, si cost es mayor que maxCost(), el objeto se eliminará inmediatamente.
La función devuelve true si el objeto se ha insertado en la caché; en caso contrario, devuelve false.
Véanse también take() y remove().
[noexcept] bool QCache::isEmpty() const
Devuelve « true » si la caché no contiene ningún objeto; en caso contrario, devuelve « false ».
Véase también size().
QList<Key> QCache::keys() const
Devuelve una lista con las claves de la caché.
[noexcept] qsizetype QCache::maxCost() const
Devuelve el coste total máximo permitido de la caché.
Véanse también setMaxCost() y totalCost().
[noexcept] T *QCache::object(const Key &key) const
Devuelve el objeto asociado a la clave key, o nullptr si la clave no existe en la caché.
Advertencia: El objeto devuelto es propiedad de QCache y puede eliminarse en cualquier momento.
Véase también take() y remove().
[noexcept(...)] bool QCache::remove(const Key &key)
Elimina el objeto asociado a la clave key. Devuelve true si se ha encontrado el objeto en la caché; en caso contrario, devuelve false.
Nota: Esta función es «noexcept» cuando std::is_nothrow_destructible_v<Node> es true.
Véase también take() y clear().
[noexcept(...)] void QCache::setMaxCost(qsizetype cost)
Establece el coste total máximo permitido de la caché en cost. Si el coste total actual es superior a cost, se eliminan inmediatamente algunos objetos.
Nota: Esta función es `noexcept` cuando ` std::is_nothrow_destructible_v<Node> ` es ` true`.
Véanse también maxCost() y totalCost().
[noexcept] qsizetype QCache::size() const
Devuelve el número de objetos que hay en la caché.
Véase también isEmpty().
[noexcept(...)] T *QCache::take(const Key &key)
Extrae de la caché el objeto asociado a la clave key sin eliminarlo. Devuelve un puntero al objeto extraído, o 0 si la clave no existe en la caché.
La propiedad del objeto devuelto se transfiere al llamante.
Nota: Esta función es «noexcept» cuando std::is_nothrow_destructible_v<Key> es « true ».
Véase también ` remove()`.
[noexcept] qsizetype QCache::totalCost() const
Devuelve el coste total de los objetos de la caché.
Este valor suele ser inferior al de ` maxCost()`, pero ` QCache ` constituye una excepción para las clases compartidas implícitamente de Qt. Si un objeto almacenado en caché comparte sus datos internos con otra instancia, ` QCache ` puede mantener el objeto en la memoria, lo que podría contribuir a que `totalCost()` sea mayor que ` maxCost()`.
Véase también setMaxCost().
[noexcept] T *QCache::operator[](const Key &key) const
Devuelve el objeto asociado a la clave key, o nullptr si la clave no existe en la caché.
Esto equivale a object().
Advertencia: El objeto devuelto es propiedad de QCache y puede ser eliminado en cualquier momento.
© 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.