Struct TunerCache 

pub struct TunerCache {
    pub entries: BTreeMap<String, [u32; 3]>,
}

Per-adapter tuner decisions keyed by program fingerprint.

Fields

entries: BTreeMap<String, [u32; 3]>

program_fingerprint -> best_workgroup_size.

Implementations

impl TunerCache

pub fn get(&self, program_fp: &str) -> Option<[u32; 3]>

Return the best workgroup size for the given key, if cached.

pub fn get_key(&self, key: &TunerProgramKey) -> Option<[u32; 3]>

Return the cached decision for a typed tuner key.

pub fn set(&mut self, program_fp: impl Into<String>, size: [u32; 3])

Record a decision.

pub fn set_key(&mut self, key: TunerProgramKey, size: [u32; 3])

Record a decision under a typed key.

HOT PATH (autotuner cache write): takes ownership of key so the fingerprint String moves into the map - set(key.as_str(), …) would allocate a second copy of the same bytes.

pub fn load(path: &Path) -> Result<Self, String>

Load from a TOML file. Missing file returns an empty cache.

Errors

Returns when the file exists but contains invalid TOML.

pub fn save(&self, path: &Path) -> Result<(), String>

Persist to disk. Creates parent directories as needed.

Errors

Returns when the parent directory cannot be created or the file cannot be written.

Trait Implementations

impl Clone for TunerCache

fn clone(&self) -> TunerCache

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TunerCache

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

Formats the value using the given formatter.

impl Default for TunerCache

fn default() -> TunerCache

Returns the “default value” for a type.

impl Eq for TunerCache

impl PartialEq for TunerCache

fn eq(&self, other: &TunerCache) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for TunerCache