Struct CompileCache 

pub struct CompileCache { /* private fields */ }

Content-addressed cache of JIT-compiled functions.

See the module documentation for full details.

Implementations

impl CompileCache

pub fn new() -> Self

Create a new, empty cache.

pub fn compile( &mut self, expr: ExprId, inputs: &[ExprId], pool: &ExprPool, ) -> Result<Arc<CompiledFn>, JitError>

Compile expr with the given inputs, returning a cached Arc<CompiledFn>.

Cache behaviour

• Miss: the expression is compiled via jit::compile and the result is stored. Subsequent calls with the same (expr, inputs) pair return the cached value immediately.
• Hit: returns Arc::clone of the cached value — O(1), no recompilation.

Errors

Returns Err(JitError) only on a cache miss where compilation fails. Cache hits never fail.

pub fn compile_with( &mut self, expr: ExprId, inputs: &[ExprId], pool: &ExprPool, config: CompileConfig, ) -> Result<Arc<CompiledFn>, JitError>

Like compile but passes CompileConfig to tier selection.

Use CompileConfig::for_batch when the cached function will drive a large call_bulk / call_batch sweep so LLVM is selected when available.

pub fn len(&self) -> usize

Number of (expr, inputs) pairs currently cached.

pub fn is_empty(&self) -> bool

Returns true if the cache contains no entries.

pub fn contains(&self, expr: ExprId, inputs: &[ExprId]) -> bool

Returns true if a compiled function for (expr, inputs) is cached.

pub fn contains_with( &self, expr: ExprId, inputs: &[ExprId], config: CompileConfig, ) -> bool

Returns true if (expr, inputs, config) is cached.

pub fn compile_count(&self) -> u64

Total number of compilations performed (cache misses that succeeded).

pub fn hit_count(&self) -> u64

Total number of cache hits.

pub fn hit_rate(&self) -> f64

Cache hit rate in [0.0, 1.0]; 0.0 when no lookups have been made.

pub fn clear(&mut self)

Evict all cached functions, freeing compiled code unless other Arcs keep them alive.

pub fn evict( &mut self, expr: ExprId, inputs: &[ExprId], ) -> Option<Arc<CompiledFn>>

Evict a single entry. Returns the cached function if it was present.

pub fn evict_with( &mut self, expr: ExprId, inputs: &[ExprId], config: CompileConfig, ) -> Option<Arc<CompiledFn>>

Evict a single entry for the given compile configuration.

Trait Implementations

impl Default for CompileCache

fn default() -> Self

Returns the “default value” for a type.