Struct ReadoutOptions 

pub struct ReadoutOptions { /* private fields */ }

Per-call readout options. Storage = small inline Vec<(String, OptionValue)>; option counts are typically 0-3 so a hashmap is overkill. SRD-63 §5.1 option grammar — every key=value pair the body parser produces (other than the structural keys lod / layout / color / style which have dedicated paths) lands here.

Lookup is linear — fine at the option counts we expect. Two accessor families:

• Lenient (get_str, get_int, …) — return None for both “missing key” and “wrong type.” Right for readouts that fall back to a sensible default.
• Strict (try_get_str, try_get_int, …) — return Ok(None) on missing, Err(OptionTypeMismatch) on type mismatch. Right for readouts that should reject typo’d configurations rather than silently ignore them.

Implementations

impl ReadoutOptions

pub fn new() -> Self

Construct an empty option set.

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

Insert / overwrite. Last-one-wins on duplicate keys, matching the standard YAML / kv-list convention.

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

Borrow the value for key, if any.

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

Lenient: borrow as &str if the key holds a string value. Returns None for missing key OR wrong type. Use try_get_str when the distinction matters.

pub fn get_int(&self, key: &str) -> Option<i64>

Lenient: extract the integer value, if any.

pub fn get_float(&self, key: &str) -> Option<f64>

Lenient: extract the float value, casting from Int when needed.

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

Lenient: extract the bool value, if any.

pub fn try_get_str(&self, key: &str) -> Result<Option<&str>, OptionTypeMismatch>

Strict: Ok(None) on missing key, Ok(Some(...)) on string match, Err(...) when the key holds a non-string value. Per feedback_never_ignore_silently: callers that mean to reject typo’d options use this instead of get_str.

pub fn try_get_int(&self, key: &str) -> Result<Option<i64>, OptionTypeMismatch>

Strict integer accessor. See try_get_str.

pub fn try_get_float( &self, key: &str, ) -> Result<Option<f64>, OptionTypeMismatch>

Strict float accessor. Accepts Int (cast to f64) alongside Float; rejects everything else.

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

Strict bool accessor.

pub fn is_empty(&self) -> bool

True iff at least one option is set.

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

Iterate every (key, value) pair.

Trait Implementations

impl Clone for ReadoutOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReadoutOptions

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

Formats the value using the given formatter.

impl Default for ReadoutOptions

fn default() -> Self

Returns the “default value” for a type.