QCache类

QCache<int, Employee> cache;

Employee *employee = new Employee;
employee->setId(37);
employee->setName("Richard Schmit");
...
cache.insert(employee->id(), employee);

QCache<int, MyDataStructure> cache(5000);

成员函数文档

[明确 noexcept] QCache::QCache(qsizetype maxCost = 100)

构建一个缓存，其内容总成本永远不会超过 maxCost。

QCache::~QCache()

销毁缓存。删除缓存中的所有对象。

[noexcept(...)] void QCache::clear()

删除缓存中的所有对象。

另请参阅 remove() 和 take()。

[noexcept] bool QCache::contains(const Key &key) const

如果缓存中与键 key 关联的对象存在，则返回 true；否则返回 false。

另请参阅 take() 和 remove()。

[noexcept] qsizetype QCache::count() const

与 size 相同。

bool QCache::insert(const Key &key, T *object, qsizetype cost = 1)

将 object 插入具有键 key 和相关成本 cost 的缓存中。如果缓存中已经存在具有相同键的对象，则将其删除。

在此调用之后，object 由 QCache 所拥有，可能在任何时候被删除。特别是，如果 cost 大于 maxCost，则对象将立即被删除。

如果对象已插入缓存，则函数返回 true；否则返回 false。

另请参阅 take() 和 remove()。

[noexcept] bool QCache::isEmpty() const

如果缓存中没有对象，则返回 true；否则返回 false。

另请参阅 size()。

QList<Key> QCache::keys() const

返回缓存中的键列表。

[noexcept] qsizetype QCache::maxCost() const

返回缓存允许的最大总成本。

另请参阅setMaxCost() 和 totalCost()。

[noexcept] T *QCache::object(const Key &key) const

返回与键 key 关联的对象，如果键不存在于缓存中，则返回 nullptr。

另请参阅 take() 和 remove()。

[noexcept(...)] bool QCache::remove(const Key &key)

删除与键 key 关联的对象。如果对象存在于缓存中，则返回 true；否则返回 false。

另请参阅take() 和 clear()。

[noexcept(...)] void QCache::setMaxCost(qsizetype cost)

将缓存允许的最大总成本设置为 cost。如果当前总成本大于 cost，则立即删除一些对象。

另请参阅maxCost() 和 totalCost()。

[noexcept] qsizetype QCache::size() const

返回缓存中的对象数量。

另请参阅isEmpty()。

[noexcept(...)] T *QCache::take(const Key &key)

从缓存中取出与键 key 关联的对象而不删除它。返回取出对象的指针，如果键不存在于缓存中，则返回 0。

返回对象的拥有权传递给调用者。

另请参阅remove()。

[noexcept] qsizetype QCache::totalCost() const

返回缓存中对象的总成本。

此值通常低于 maxCost，但 QCache 为 Qt 的 隐式共享 类作例外。如果一个缓存的对象与其另一个实例共享其内部数据，QCache 可能会保留该对象，这可能导致 totalCost() 大于 maxCost。

另请参阅setMaxCost()。

[noexcept] T *QCache::operator[](const Key &key) const

返回与键 key 关联的对象，如果键不存在于缓存中，则返回 nullptr。

这与 object() 相同。