Struct Symbol 

pub struct Symbol<'s>(/* private fields */);

An interned identifier: an index into the SymbolStore that minted it, branded with that store’s borrow lifetime.

Copy + Eq + Hash in one u32, so scope stacks, type environments and the compiler’s lexical frames compare and hash identifiers by integer instead of by string content.

Equality is index equality, which is exactly string equality for symbols from the same store (the store deduplicates on intern). Comparing symbols from two different stores is meaningless but not unsound — see SymbolStore::resolve.

Ord is index order (insertion order), not lexicographic order. It exists only so symbols can key a BTreeMap/BTreeSet for deterministic iteration within one run. Anywhere the output depends on ordering (type error text, record kinds, optional-label rows), sort by SymbolStore::resolve text instead — see this module’s header.

Implementations

impl Symbol<'_>

pub fn index(self) -> u32

The raw index. Useful for dense side-tables keyed by symbol; carries no meaning without the store that minted it.

Trait Implementations

impl<'s> Clone for Symbol<'s>

fn clone(&self) -> Symbol<'s>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'s> Copy for Symbol<'s>

impl Debug for Symbol<'_>

Prints the index, not the text — a Symbol is a bare u32 plus a zero-sized brand, so it has no way to reach its store from here.

This is a deliberate choice: golden tests must diff resolved strings produced at their format site, never Debug-of-AST.

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

Formats the value using the given formatter.

impl<'s> Eq for Symbol<'s>

impl<'s> Hash for Symbol<'s>

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

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<'s> Ord for Symbol<'s>

fn cmp(&self, other: &Symbol<'s>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'s> PartialEq for Symbol<'s>

fn eq(&self, other: &Symbol<'s>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'s> PartialOrd for Symbol<'s>

fn partial_cmp(&self, other: &Symbol<'s>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'s> StructuralPartialEq for Symbol<'s>