Struct ParamValues 

pub struct ParamValues(/* private fields */);

2026-09-26: The edited values handed to Benchmark::configure.

Accessors return Err on a missing or mistyped key rather than falling back to a default: a benchmark that reads a key its schema never declared is a bug, and a substituted value would hide it behind a plausible number. float also accepts an Int.

Implementations

impl ParamValues

pub fn iter(&self) -> impl Iterator<Item = (&str, &ParamValue)>

2026-09-26: Every (key, value) pair, in key order (the map is a BTreeMap), so records built from the same values diff cleanly.

pub fn to_strings(&self) -> BTreeMap<String, String>

2026-09-26: The whole configuration as text, for persistence.

pub fn from_overrides<'a>( specs: &[ParamSpec], overrides: impl IntoIterator<Item = (&'a str, &'a str)>, ) -> Result<Self>

2026-09-26: Schema defaults with overrides applied on top.

Every value is routed through ParamKind::parse, so an out-of-domain override fails here rather than mid-run. An unknown key is an error naming the valid ones: an ignored --param typo would measure something other than what was asked for.

impl ParamValues

pub fn defaults(specs: &[ParamSpec]) -> Self

2026-09-26: Starting values for a schema: each spec’s default.

pub fn set(&mut self, key: impl Into<String>, value: ParamValue)

pub fn get(&self, key: &str) -> Option<&ParamValue>

pub fn bool(&self, key: &str) -> Result<bool>

pub fn int(&self, key: &str) -> Result<i64>

pub fn usize(&self, key: &str) -> Result<usize>

2026-09-26: int, refused when negative.

pub fn float(&self, key: &str) -> Result<f64>

pub fn text(&self, key: &str) -> Result<&str>

pub fn int_list(&self, key: &str) -> Result<&[i64]>

pub fn validate_against(&self, specs: &[ParamSpec]) -> Result<()>

2026-09-26: Refuse an unknown key, a missing key, or a value that does not parse-check against its spec. Headless runs call it before a run, and every driver’s configure except vision’s and video’s calls it first, so a bad field is reported against the field rather than as a mid-run failure.

Trait Implementations

impl Clone for ParamValues

fn clone(&self) -> ParamValues

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParamValues

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

Formats the value using the given formatter.

impl Default for ParamValues

fn default() -> ParamValues

Returns the “default value” for a type.

impl PartialEq for ParamValues

fn eq(&self, other: &ParamValues) -> 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 ParamValues