Struct ValueCodecRegistry 

pub struct ValueCodecRegistry<D: 'static> { /* private fields */ }

An immutable value-codec registry sorted by stable ID.

Type Parameters

• D: Copyable, static descriptor identifying one wire representation.

Examples

use qubit_codec::ValueCodecRegistry;
use qubit_codec::ValueStringCodecDescriptor;
use qubit_codec::ValueStringCodecRegistry;

let registry: ValueCodecRegistry<ValueStringCodecDescriptor> =
    ValueStringCodecRegistry::empty();
assert!(registry.get("missing.example").is_none());

Implementations

impl<D: Copy + 'static> ValueCodecRegistry<D>

pub fn from_registrations( registrations: impl IntoIterator<Item = &'static ValueCodecRegistration<D>>, ) -> Result<Self, ValueCodecRegistryError>

Builds a local registry from static registrations.

Parameters

• registrations: Static entries copied into this registry; input order is ignored.

Returns

An owned, immutable registry sorted by ID, independent of the iterator.

Errors

Returns a duplicate-ID error when multiple entries claim one ID.

pub fn empty() -> Self

Returns an empty local registry.

Returns

A local registry with no registrations or indexed IDs.

pub fn get(&self, id: &str) -> Option<&ValueCodecRegistration<D>>

Finds a registration by stable ID.

Parameters

• id: Exact stable ID to look up, without normalization.

Returns

Some borrows the matching registration from this registry; None means the ID is absent. Lookup uses a logarithmic tree search.

pub fn registrations(&self) -> &[ValueCodecRegistration<D>]

Returns registrations in deterministic ID order.

Returns

The immutable registration slice borrowed from this registry without allocation.

impl ValueCodecRegistry<ValueStringCodecDescriptor>

pub fn try_global() -> Result<&'static Self, ValueCodecRegistryError>

Initializes and returns the process-wide linked string registry.

Initialization is synchronized and cached, including construction failures.

Returns

A shared static registry containing all linked string registrations.

Errors

Returns the cached construction error when linked registrations conflict. The error identifies the lexically first duplicate ID and all declarations for that ID in source-field order.

pub fn global() -> &'static Self

Returns the process-wide string registry or panics with a stable diagnostic.

Returns

A shared static registry, initialized at most once by try_global.

Panics

Panics when linked registrations conflict.

impl ValueCodecRegistry<ValueBytesCodecDescriptor>

pub fn try_global() -> Result<&'static Self, ValueCodecRegistryError>

Initializes and returns the process-wide linked bytes registry.

Initialization is synchronized and cached, including construction failures.

Returns

A shared static registry containing all linked bytes registrations.

Errors

Returns the cached construction error when linked registrations conflict. The error identifies the lexically first duplicate ID and all declarations for that ID in source-field order.

pub fn global() -> &'static Self

Returns the process-wide bytes registry or panics with a stable diagnostic.

Returns

A shared static registry, initialized at most once by try_global.

Panics

Panics when linked registrations conflict.

Trait Implementations

impl<D: Debug + 'static> Debug for ValueCodecRegistry<D>

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

Formats the value using the given formatter.