Struct SymbolId 

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

High-performance internal symbol ID

Properties

• O(1) comparison and hashing
• Generation counter for dangling reference detection
• 8 bytes fixed size

Important: Always obtain via SymbolRegistry

SymbolId must be obtained through SymbolRegistry::register() or SymbolRegistry::lookup(). Direct construction is prohibited.

// Correct usage
let id = registry.register(path, kind)?;
let id = registry.lookup(&path)?;

// Prohibited: direct construction
// let id = SymbolId::default();  // Compiles but forbidden

Stability

SymbolId はセッション内でのみ安定。サーバー再起動で値が変わるため、 セッション跨ぎでのキャッシュや永続化には使用不可。 永続的な参照が必要な場合は UUID (MatchResult.uuid) を使用すること。

Thread Safety

SymbolId is Copy and can be safely shared across threads. However, the SymbolRegistry that owns the symbol data must be properly synchronized.

Implementations

impl SymbolId

pub fn parse(s: &str) -> Option<SymbolId>

Parse SymbolId from string representation.

Accepts formats:

• "165v1" - compact format (index v version)
• "SymbolId(165v1)" - debug format

Examples

let id = SymbolId::parse("165v1");
let id = SymbolId::parse("SymbolId(165v1)");

Trait Implementations

impl Clone for SymbolId

fn clone(&self) -> SymbolId

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SymbolId

Debug: wrapped format “SymbolId(165v1)”

Overrides the default SlotMap KeyData debug output for cleaner logs.

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

Formats the value using the given formatter.

impl Default for SymbolId

fn default() -> SymbolId

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for SymbolId

fn deserialize<D>( deserializer: D, ) -> Result<SymbolId, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for SymbolId

Display: compact format “165v1”

Use this for user-facing output and serialization.

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

Formats the value using the given formatter.

impl From<KeyData> for SymbolId

fn from(k: KeyData) -> SymbolId

Converts to this type from the input type.

impl Hash for SymbolId

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 Key for SymbolId

fn data(&self) -> KeyData

Gets the KeyData stored in this key.

fn null() -> Self

Creates a new key that is always invalid and distinct from any non-null key. A null key can only be created through this method (or default initialization of keys made with new_key_type!, which calls this method).

fn is_null(&self) -> bool

Checks if a key is null. There is only a single null key, that is a.is_null() && b.is_null() implies a == b.

impl Ord for SymbolId

fn cmp(&self, other: &SymbolId) -> 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 PartialEq for SymbolId

fn eq(&self, other: &SymbolId) -> 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 PartialOrd for SymbolId

fn partial_cmp(&self, other: &SymbolId) -> 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 Serialize for SymbolId

fn serialize<S>( &self, serializer: S, ) -> Result<<S as Serializer>::Ok, <S as Serializer>::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Copy for SymbolId

impl Eq for SymbolId

impl StructuralPartialEq for SymbolId