Struct NameTable 

pub struct NameTable { /* private fields */ }

String interning table for names and namespace URIs

Provides O(1) average-case lookup and insertion. All strings in the schema model should be interned through this table.

Uses interior mutability to allow adding strings through shared references.

Example

use xsd_schema::namespace::NameTable;

let table = NameTable::new();
let id1 = table.add("hello");
let id2 = table.add("hello");
assert_eq!(id1, id2); // Same string -> same ID
assert_eq!(table.resolve(id1), "hello");

Implementations

impl NameTable

pub fn new() -> Self

Create a new name table pre-seeded with standard namespaces

pub fn add(&self, value: &str) -> NameId

Add a string to the table, returning its NameId

If the string already exists, returns the existing NameId. Otherwise, creates a new entry and returns a new NameId.

Uses interior mutability, so this can be called through a shared reference.

pub fn get(&self, value: &str) -> Option<NameId>

Get the NameId for a string if it exists

pub fn resolve_ref(&self, id: NameId) -> &str

Resolve a NameId to a string slice (zero-allocation).

Prefer this over resolve() in performance-critical paths (e.g., DomNavigator implementations).

Safety (internal)

Uses RefCell::as_ptr() to bypass the borrow guard. This is sound because:

• Entry.text is Box<str> — heap-stable allocation
• Entry.text is never replaced or removed after insertion (other Entry fields like next may be mutated during rehashing, but only text stability matters here)
• The returned &str points to the Box’s heap data, not the Vec buffer, so it remains valid even if the Vec reallocates during a later add()

Panics

Panics if the NameId is out of bounds.

pub fn try_resolve_ref(&self, id: NameId) -> Option<&str>

Try to resolve a NameId to a string slice (zero-allocation).

Returns None if the NameId is out of bounds.

pub fn resolve(&self, id: NameId) -> String

Resolve a NameId to its string value

Returns a copy of the string. For zero-allocation access, use resolve_ref().

Panics

Panics if the NameId is invalid (out of bounds).

pub fn try_resolve(&self, id: NameId) -> Option<String>

Try to resolve a NameId to its string value

Returns a copy of the string. For zero-allocation access, use try_resolve_ref().

pub fn len(&self) -> usize

Get the number of interned strings

pub fn is_empty(&self) -> bool

Check if the table is empty

Trait Implementations

impl Debug for NameTable

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

Formats the value using the given formatter.

impl Default for NameTable

fn default() -> Self

Returns the “default value” for a type.