Struct CanonicalBytesScanner 

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

A zero-allocation canonical-layout recognizer over raw bytes.

Unlike converting the complete input with std::str::from_utf8 first, this scanner validates only captured string fields. Structural fragments are matched as ASCII bytes. A successful recognizer still proves that the complete accepted layout is valid UTF-8 JSON because every byte is either an exact ASCII literal, an ASCII number/boolean, or part of a validated string.

Implementations

impl<'a> CanonicalBytesScanner<'a>

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

Starts matching a byte slice without a full-input UTF-8 pre-pass.

pub fn literal(&mut self, expected: &str) -> Option<()>

Consumes an exact ASCII JSON fragment.

pub fn plain_string(&mut self) -> Option<&'a str>

Consumes a JSON string with no escapes and validates only its payload.

pub fn plain_ascii_string(&mut self) -> Option<&'a [u8]>

Consumes an unescaped ASCII JSON string and returns its bytes.

This is the fastest byte-input path for protocol identifiers and other fields whose canonical form is ASCII. Non-ASCII input returns None so the caller can fall back to Self::plain_string or a general parser.

pub fn unsigned(&mut self) -> Option<u64>

Consumes one unsigned JSON integer.

pub fn boolean(&mut self) -> Option<bool>

Consumes true or false.

pub const fn remaining(&self) -> &'a [u8]

Returns the unmatched suffix.

pub const fn is_finished(&self) -> bool

Returns true only when the recognizer consumed the complete input.

Trait Implementations

impl<'a> Clone for CanonicalBytesScanner<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for CanonicalBytesScanner<'a>

impl<'a> Debug for CanonicalBytesScanner<'a>

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

Formats the value using the given formatter.