Struct string_interner::backend::SimpleBackend

pub struct SimpleBackend<S = DefaultSymbol> { /* private fields */ }

A simple backend that stores a separate allocation for every interned string.

Use this if you can afford many small allocations and if you want to have especially decent performance for look-ups when the string interner is already filled to some extend.

Usage Hint

Never actually use this interner backend since it only acts as a trivial baseline.

Usage

• Fill: Efficiency of filling an empty string interner.
• Resolve: Efficiency of interned string look-up given a symbol.
• Allocations: The number of allocations performed by the backend.
• Footprint: The total heap memory consumed by the backend.
• Contiguous: True if the returned symbols have contiguous values.

Rating varies between bad, ok, good and best.

Scenario	Rating
Fill	bad
Resolve	good
Allocations	bad
Footprint	bad
Supports get_or_intern_static	no
Send + Sync	yes
Contiguous	yes

Trait Implementations

impl<S> Backend for SimpleBackend<S>

where S: Symbol,

type Symbol = S

The symbol used by the string interner backend.

fn with_capacity(cap: usize) -> Self

Creates a new backend for the given capacity.

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

Interns the given string and returns its interned ref and symbol.

fn shrink_to_fit(&mut self)

Shrink backend capacity to fit interned symbols exactly.

fn resolve(&self, symbol: Self::Symbol) -> Option<&str>

Resolves the given symbol to its original string contents.

unsafe fn resolve_unchecked(&self, symbol: Self::Symbol) -> &str

Resolves the given symbol to its original string contents.

fn intern_static(&mut self, string: &'static str) -> Self::Symbol

Interns the given static string and returns its interned ref and symbol.

impl<S> Clone for SimpleBackend<S>

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S: Debug> Debug for SimpleBackend<S>

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

Formats the value using the given formatter.

impl<S> Default for SimpleBackend<S>

fn default() -> Self

Returns the “default value” for a type.

impl<'a, S> IntoIterator for &'a SimpleBackend<S>

where S: Symbol,

type Item = (S, &'a str)

The type of the elements being iterated over.

type IntoIter = Iter<'a, S>

Which kind of iterator are we turning this into?

fn into_iter(self) -> Self::IntoIter

Creates an iterator from a value.

impl<S> PartialEq for SimpleBackend<S>

where S: Symbol,

fn eq(&self, other: &Self) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<S> Eq for SimpleBackend<S>

where S: Symbol,