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.

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.

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.