Struct PicoStr

pub struct PicoStr(/* private fields */);

An interned string representation that is cheap to copy and hash, but more expensive to access.

This type takes up 8 bytes and is copyable and null-optimized (i.e. Option<PicoStr> also takes 8 bytes).

Supports compile-time string interning via PicoStr::constant in two flavors:

• Strings of length at most 12 containing only chars from ‘a’-‘z’, ‘1’-‘4’, and ‘-’ are stored inline in the number
• Other strings can be compile-time interned the same way, but must first be added to the list in exceptions::LIST.

No such restrictions apply at runtime (via PicoStr::intern).

Implementations

impl PicoStr

pub fn intern(string: &str) -> PicoStr

Intern a string at runtime.

pub fn get(string: &str) -> Option<PicoStr>

Try to create a PicoStr, but don’t intern it if it does not exist yet.

This is useful to try to compare against one or multiple PicoStr without interning needlessly.

Will always return Some(_) if the string can be represented inline.

pub const fn constant(string: &'static str) -> PicoStr

Creates a compile-time constant PicoStr.

Should only be used in const contexts because it can panic.

pub const fn try_constant(string: &str) -> Result<PicoStr, EncodingError>

Try to intern a string statically at compile-time.

pub fn resolve(self) -> ResolvedPicoStr

Resolve to a decoded string.

Trait Implementations

impl Clone for PicoStr

fn clone(&self) -> PicoStr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PicoStr

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

Formats the value using the given formatter.

impl From<Label> for PicoStr

fn from(value: Label) -> PicoStr

Converts to this type from the input type.

impl Hash for PicoStr

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PicoStr

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Copy for PicoStr

impl Eq for PicoStr

impl StructuralPartialEq for PicoStr