Struct SymbolTable 

pub struct SymbolTable { /* private fields */ }

Hierarchical symbol table mapping names to values or nested tables.

Supports dotted paths: table.set("Param.Frame", 42) creates a nested structure Param -> Frame -> 42.

Implementations

impl SymbolTable

pub fn new() -> Self

pub fn from_pairs<'a, I>(pairs: I) -> Result<Self, SymbolTableError>

where I: IntoIterator<Item = (&'a str, ExprValue)>,

Construct from a list of (dotted_key, value) pairs. Build a SymbolTable from any iterable of (dotted_key, value) pairs.

Accepts any IntoIterator, so callers can pass Vec, arrays, iterators (e.g., from map/filter chains), or other containers without collecting first.

pub fn set_table(&mut self, key: &str, subtable: SymbolTable)

Set a nested SymbolTable at a key (for dict-like nesting).

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

Get a subtable at a key, or None.

pub fn set( &mut self, key: &str, value: impl Into<ExprValue>, ) -> Result<(), SymbolTableError>

Set a value at a dotted path, creating intermediate tables as needed.

Accepts anything convertible to ExprValue via Into:

• i32, i64 → ExprValue::Int
• bool → ExprValue::Bool
• &str, String → ExprValue::String
• ExprType → ExprValue::Unresolved (for type-checking symbol tables)
• ExprValue → used directly

For floats, construct ExprValue::Float(Float64::new(v)?) explicitly.

Returns an error if an intermediate path component is already set to a value (not a table). For example, setting "A.B.C" fails if "A.B" is already a scalar value.

pub fn set_string( &mut self, key: &str, value: &str, ) -> Result<(), SymbolTableError>

Set a string value at a dotted path (convenience).

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

Get an entry at a dotted path.

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

Get a value at a dotted path, returning None if not found or if it’s a table.

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

Get a string value at a dotted path.

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

pub fn keys(&self) -> impl Iterator<Item = &str>

Top-level keys.

pub fn all_paths(&self, prefix: &str) -> Vec<String>

Collect all leaf symbol paths (dotted names) in this table.

If prefix is non-empty, each returned path is prefixed with "{prefix}.". Use "" for a top-level walk.

pub fn merge_from(&mut self, other: &SymbolTable)

Merge all entries from other into this table, overwriting on conflict.

Trait Implementations

impl Clone for SymbolTable

fn clone(&self) -> SymbolTable

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SymbolTable

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

Formats the value using the given formatter.

impl Default for SymbolTable

fn default() -> SymbolTable

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SymbolTable

fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>

Deserialize this value from the given Serde deserializer.

impl<'a> FromIterator<(&'a str, ExprValue)> for SymbolTable

Collect (&str, ExprValue) pairs into a SymbolTable.

Panics

Panics if a dotted path conflicts with an existing non-table entry. Use SymbolTable::set directly if you need error handling.

fn from_iter<I: IntoIterator<Item = (&'a str, ExprValue)>>(iter: I) -> Self

Creates a value from an iterator.

impl Serialize for SymbolTable

fn serialize<S: Serializer>(&self, s: S) -> Result<S::Ok, S::Error>

Serialize this value into the given Serde serializer.