Struct Intern

pub struct Intern<'a> { /* private fields */ }

Implementations

impl Intern<'_>

pub fn new() -> Self

Create a new intern table.

pub fn with_capacity(capacity: usize) -> Self

Create a new intern table with the given capacity.

pub fn intern<V: Into<String> + AsRef<str>>(&mut self, input: V) -> InternId

Intern a string. Returns the interned id. If the string is already interned, returns the existing id. The string is stored in the intern table for the lifetime of the program. The id is a 32-bit integer, so there can be at most 2^32 unique strings interned. If the limit is reached, this function will panic. The id is guaranteed to be unique for the lifetime of the program.

Examples

use intern_string::Intern;

let mut intern = Intern::new();
let id = intern.intern("hello");
assert_eq!(intern.lookup(id), "hello");

pub fn lookup(&self, id: InternId) -> &str

Lookup the interned string by id.

Panics

Panics if the id is not valid.

Examples

use intern_string::Intern;

let mut intern = Intern::new();
let id = intern.intern("hello");
assert_eq!(intern.lookup(id), "hello");

pub fn try_lookup(&self, id: InternId) -> Option<&str>

Lookup the interned string by id. Returns None if the id is not valid.

Examples

use intern_string::Intern;

let mut intern = Intern::new();
let id = intern.intern("hello");
assert_eq!(intern.try_lookup(id), Some("hello"));

Trait Implementations

impl<'a> Default for Intern<'a>

fn default() -> Intern<'a>

Returns the “default value” for a type.