Struct symbol_table::SymbolTable

pub struct SymbolTable<const N: usize = DEFAULT_N_SHARDS, S = DeterministicHashBuilder> { /* private fields */ }

A table in which you can intern strings and get back Symbols.

The table is sharded N times (default DEFAULT_N_SHARDS) for lower contention when accessing concurrently.

Implementations

impl SymbolTable<DEFAULT_N_SHARDS, DeterministicHashBuilder>

pub fn new() -> Self

Creates a new SymbolTable with the default generic arguments. This symbol table will be determinisitic, using a seeded ahash.

impl<const N: usize, S: BuildHasher> SymbolTable<N, S>

pub fn intern(&self, string: &str) -> Symbol

Intern a string into the SymbolTable.

Note how this method only takes &self, so it can be used concurrently.

Interning the same string will give the same symbol.

let mut table = symbol_table::SymbolTable::new();
assert_eq!(table.intern("foo"), table.intern("foo"));

pub fn resolve(&self, sym: Symbol) -> &str

Resolve a symbol to the interned string.

The resolved string is immutable and will live as long as the SymbolTable.

let mut table = symbol_table::SymbolTable::new();
let foo = table.intern("foo");
assert_eq!(table.resolve(foo), "foo");

Trait Implementations

impl<const N: usize, S: Default + BuildHasher> Default for SymbolTable<N, S>

fn default() -> Self

Returns the “default value” for a type.