Struct ThreadedInterner

pub struct ThreadedInterner { /* private fields */ }

A thread-safe interner, allowing multiple threads to concurrently intern strings.

Implementations

impl ThreadedInterner

pub fn new() -> Self

Creates a new ThreadedInterner.

pub fn len(&self) -> usize

Returns the number of strings stored in the interner.

pub fn is_empty(&self) -> bool

Returns true if the interner is empty.

pub fn get(&self, string: impl AsRef<str>) -> Option<StringIdentifier>

Returns the identifier for the specified interned string.

Arguments

• string - The interned string.

Returns

The identifier for the interned string, or None if the string is not interned.

pub fn intern(&self, string: impl AsRef<str>) -> StringIdentifier

Interns a string and returns its identifier.

If the string is already interned, the existing identifier is returned.

Arguments

• string - The string to intern.

pub fn interned_str(&self, string: impl AsRef<str>) -> &str

Interns a string if it has not already been interned, then returns a reference to the interned string.

Arguments

• string - A string or any type that implements AsRef<str>, representing the string to intern.

Returns

A reference to the interned version of the string.

Panics

This method will panic if it encounters an invalid identifier. This should never occur unless there is an issue with the identifier or the interner is used incorrectly.

pub fn lowered(&self, identifier: &StringIdentifier) -> StringIdentifier

Given an identifier, returns the identifier for the same string but with all characters in lowercase.

Arguments

• identifier - The identifier of the string to lower.

Returns

The identifier of the string with all characters in lowercase.

pub fn lookup(&self, identifier: &StringIdentifier) -> &str

Looks up an interned string by its identifier.

Arguments

• identifier - The identifier of the interned string to look up.

Panics

This method will panic if it encounters an invalid identifier. This should never occur unless there is an issue with the identifier or the interner is used incorrectly.

pub fn all(&self) -> HashSet<(StringIdentifier, &str)>

Returns all interned strings and their identifiers as a hashmap.

Trait Implementations

impl Clone for ThreadedInterner

fn clone(&self) -> ThreadedInterner

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ThreadedInterner

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

Formats the value using the given formatter.

impl Default for ThreadedInterner

fn default() -> Self

Returns the “default value” for a type.

impl Send for ThreadedInterner

impl Sync for ThreadedInterner