Struct SExprCanon 

pub struct SExprCanon<'a> { /* private fields */ }

The Rivest-canonical-form [ChunkSource] over a borrowed, grammar-validated S-expression byte slice. Constructed by crate::sexp::address after SExprCanon::validate succeeds; lives in the caller’s stack frame while the model folds it.

Implementations

impl<'a> SExprCanon<'a>

pub fn new(raw: &'a [u8]) -> Self

Wrap a grammar-validated raw S-expression slice. Call SExprCanon::validate first; the carrier assumes well-formed input (its [ChunkSource] emission cannot surface errors).

pub fn validate(raw: &[u8]) -> Result<(), ShapeViolation>

Validate raw against the S-expression grammar in a single pass: UTF-8, balanced parentheses, exactly one top-level value, and well-formed canonical atoms.

Errors

[INVALID_SEXPR_VIOLATION] (validUtf8SExpr) if raw is not a well-formed UTF-8 S-expression.

Trait Implementations

impl ChunkSource for SExprCanon<'_>

fn for_each_chunk(&self, f: &mut dyn FnMut(&[u8]))

Fold each chunk into the closure in canonical order. The total folded byte count is unbounded; each &[u8] slice is valid only for the duration of the call (not retained).

fn total_bytes(&self) -> Option<usize>

Total byte count if statically known, else None.

impl<'a> Clone for SExprCanon<'a>

fn clone(&self) -> SExprCanon<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for SExprCanon<'a>

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

Formats the value using the given formatter.

impl<'a> Copy for SExprCanon<'a>