Struct AtomTable 

pub struct AtomTable { /* private fields */ }

Concurrent intern table for atom strings.

The table stores atoms in both directions. Strings are leaked when first interned because runtime atoms are never freed in this design, which lets resolve return a borrowed &str without tying it to a map guard.

Implementations

impl AtomTable

pub fn new() -> Self

Create an atom table with the common atoms at stable indices.

There is deliberately no constructor that omits them. Every Atom::* constant is an index into this table, so a table that seats nothing hands those same indices to whatever it interns first, and Atom::NIL then resolves to a real but unrelated name rather than to nothing. That is worse than a missing name, because a wrong name from the right domain survives the sanity check a missing one would fail: the telemetry span that exposed this reported code.module = "put_chars".

pub fn with_common_atoms() -> Self

Create an atom table with the common atoms at stable indices.

Equivalent to AtomTable::new, which seats them unconditionally. Retained because the name states the invariant at the call site.

pub fn intern(&self, name: &str) -> Atom

Intern name, returning its existing or newly assigned atom.

pub fn lookup(&self, name: &str) -> Option<Atom>

Look up an atom by name without interning it.

Returns Some(atom) if the name has already been interned, None otherwise. Used by binary_to_existing_atom which must not create new atom table entries.

pub fn resolve(&self, atom: Atom) -> Option<&str>

Resolve an atom back to its original string.

pub fn len(&self) -> usize

Return the number of atoms currently interned in this table.

pub fn is_empty(&self) -> bool

Return whether this table currently contains no atoms.

pub const fn limit(&self) -> usize

Return the maximum atom count representable by this table.

Trait Implementations

impl Default for AtomTable

fn default() -> Self

Returns the “default value” for a type.