Struct AssetCache 

pub struct AssetCache { /* private fields */ }

LRU eviction cache that sits on top of AssetRegistry.

When the cache is full, the least-recently-used asset is evicted from the registry. Assets held by live AssetHandles will not be collected by the OS even after eviction, but the registry entry is removed so the next request will trigger a reload.

Capacity is measured in number of assets, not bytes.

Implementations

impl AssetCache

pub fn new(capacity: usize) -> Self

Create a new cache with the given capacity.

A capacity of 0 disables eviction (unlimited).

pub fn touch(&mut self, id: u64) -> Option<u64>

Notify the cache that id was accessed.

Moves id to the most-recently-used position and returns any ID that should now be evicted (the least-recently-used), or None.

pub fn remove(&mut self, id: u64)

Remove id from the tracking queue (called after explicit eviction).

pub fn len(&self) -> usize

Current number of tracked entries.

pub fn is_empty(&self) -> bool

true if no entries are tracked.

pub fn capacity(&self) -> usize

Configured capacity (0 = unlimited).

pub fn set_capacity(&mut self, new_cap: usize) -> Vec<u64>

Change the capacity. If the new capacity is smaller, returns a list of IDs that must be evicted immediately.

Trait Implementations

impl Debug for AssetCache

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.