Struct InternScope 

pub struct InternScope { /* private fields */ }

A StringInterner installed for the duration of a deserialization.

InternedStr fields built while it is in scope share one Arc<str> per distinct string, rather than being deduplicated by a second pass afterwards.

The cache-hit path used to do both halves of that: rkyv handed every occurrence its own fresh Arc (40,015 of them for a ledger with a few dozen distinct strings), and reintern_directives then walked every directive again to collapse them. Interning on the way in makes the walk unnecessary — it establishes exactly the postcondition that pass exists to guarantee, that equal strings share a pointer.

Scoped rather than process-wide on purpose: an interner that outlives the call would accumulate every distinct payee and narration a long-running LSP or FFI host had ever seen, and this crate already offers explicit StringInterner / AccountInterner for callers that want to own one. The table here is dropped with the guard; the Arcs it handed out live on in the deserialized values, which is the whole point.

Nesting is safe: an inner scope observes that one is already installed, leaves it in place, and is a no-op on drop, so the outer scope keeps interning through to its own end.

Implementations

impl InternScope

pub fn new() -> Self

Install an interner for this thread until the returned guard drops.

Trait Implementations

impl Default for InternScope

Available on crate feature rkyv only.

fn default() -> Self

Returns the “default value” for a type.

impl Drop for InternScope

Available on crate feature rkyv only.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.