QCache Class

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);

メンバ関数のドキュメント

[explicit 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() と同じです。