Struct Matter 

pub struct Matter<'a, C: CesrCode> { /* private fields */ }

Available on crate feature core only.

A CESR-encoded primitive with typed code C, a raw payload, and an optional soft field.

Implementations

impl<'a, C: CesrCode> Matter<'a, C>

pub const PAD: &'static str = "_"

B64 pad char for special codes with xtra size pre-padded soft values

pub const fn code(&self) -> &C

Returns the CESR code of this primitive.

pub fn soft(&self) -> &str

Returns the soft (variable-length metadata) field of this primitive.

pub fn raw(&self) -> &[u8]

Returns the raw binary payload of this primitive.

impl<C: CesrCode> Matter<'_, C>

pub fn to_qb64b(&self) -> Vec<u8>

Encodes this primitive into its qualified Base64 (qb64) CESR wire format as bytes (qb64b).

The output is allocated once at the final size fs; the Base64 payload is written directly into it, then the header (code + soft field) is written over the first cs bytes. Supports all fixed- and variable-size CESR codes.

Panics

Panics only on an internal-invariant break (a corrupt sizage table or a mis-sized output buffer) — impossible for any Matter built through the validated builder. This mirrors [Indexer::to_qb64] and is the programmer-bug carve-out, not a data-validation path.

pub fn to_qb64(&self) -> String

Encodes this primitive into its qualified Base64 (qb64) CESR wire format as a String.

qb64 output is pure ASCII (URL-safe Base64 alphabet + CESR code chars), so UTF-8 validity is guaranteed by construction.

Panics

Never, in practice: see Self::to_qb64b. The from_utf8 step cannot fail because qb64 bytes are ASCII.

impl<C: CesrCode> Matter<'_, C>

pub fn into_static(self) -> Matter<'static, C>

Convert to Matter<'static> by owning any borrowed fields.

Near-zero cost: raw is always already owned (base64 decode produces new bytes), so only the soft field (0-4 bytes for most codes) is cloned when borrowed.

impl<'a> Matter<'a, MatterCode>

pub fn narrow<C>(self) -> Result<Matter<'a, C>, ValidationError>

where C: CesrCode + TryFrom<MatterCode, Error = ValidationError>,

Converts this untyped Matter<MatterCode> into a typed Matter<C>.

Errors

Returns a ValidationError if the code cannot be narrowed to C.

Trait Implementations

impl<'a, C: Clone + CesrCode> Clone for Matter<'a, C>

fn clone(&self) -> Matter<'a, C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a, C: Debug + CesrCode> Debug for Matter<'a, C>

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

Formats the value using the given formatter.

impl<'a, C: Eq + CesrCode> Eq for Matter<'a, C>

impl<'a, C: PartialEq + CesrCode> PartialEq for Matter<'a, C>

fn eq(&self, other: &Matter<'a, C>) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl<'a, C: PartialEq + CesrCode> StructuralPartialEq for Matter<'a, C>