Struct Interner 

pub struct Interner { /* private fields */ }

An append-only set of strings, each mapped to a Symbol.

Strings are never removed, which is what makes a Symbol valid for the lifetime of the compilation and what lets the storage be a plain growing buffer.

Implementations

impl Interner

pub fn new() -> Self

An empty interner.

pub fn with_capacity(cap: usize) -> Self

An interner with room for cap strings, to avoid regrowing on a large header set.

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

Interns s, returning the existing symbol if it has been seen.

Panics

Panics if more than Idx::MAX distinct strings are interned.

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

The text behind a symbol.

Panics

Panics if the symbol came from a different interner. There is one interner per compilation, so this is a bug rather than a condition to handle.

pub fn len(&self) -> usize

How many distinct strings have been interned.

pub fn is_empty(&self) -> bool

Whether anything has been interned.

pub fn bytes(&self) -> usize

Total bytes of interned text, which is the number worth watching on a large build.

Trait Implementations

impl Debug for Interner

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

Formats the value using the given formatter.

impl Default for Interner

fn default() -> Interner

Returns the “default value” for a type.