Struct CompileCache 

pub struct CompileCache<K, V> { /* private fields */ }

A compile cache created from one immutable key.

Compilation inputs live in the key, so changing one produces a new, empty cache through CompileCache::map_key; nothing is ever cleared by hand. Clones share their results. A variant distinguishes environments that are not part of the key, such as the font snapshot a paragraph is shaped with.

Implementations

impl<K, V: Clone> CompileCache<K, V>

pub fn new(key: K) -> Self

Creates an empty cache for a key.

pub fn key(&self) -> &K

The immutable key every cached result was compiled from.

pub fn shares(&self, other: &Self) -> bool

Whether two caches share their results, as clones and unchanged keys do.

pub fn is_compiled(&self) -> bool

Whether any result has been compiled yet.

pub fn get_or_compile(&self, variant: u64, compile: impl FnOnce(&K) -> V) -> V

Returns the result for a variant, compiling it once from the key. The compiler runs while the cache is locked, so concurrent callers never compile the same variant twice.

impl<K: Clone + PartialEq, V: Clone> CompileCache<K, V>

pub fn map_key(&self, change: impl FnOnce(&mut K)) -> Self

Applies a change to a copy of the key. An unchanged key keeps sharing this cache; a changed key gets a new one.

Trait Implementations

impl<K, V> Clone for CompileCache<K, V>

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<K: Debug, V> Debug for CompileCache<K, V>

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

Formats the value using the given formatter.