Enum Frame 

pub enum Frame {
    Record(Box<RunRecord>),
    Unreadable {
        bytes: usize,
    },
}

One frame off the wire: a record this build understands, or a complete payload it does not.

The distinction is the whole point of the length prefix. A frame whose content is unreadable - a record kind added by a later build - is a well-formed frame whose bytes can be stepped over, and everything after it is still readable. A frame that is torn cannot be stepped over, because its length is unknown or its payload ran out, and the file ends there.

Conflating the two is what made adding a record kind a breaking change: read_archive_lenient stopped at the first unknown record and returned the prefix, silently dropping every readable record after it.

Variants

Record(Box<RunRecord>)

A record this build knows how to read.

Unreadable

A complete frame whose payload this build cannot parse, stepped over. Carries its size so a caller can report what it skipped.

Fields

bytes: usize

Payload length in bytes.

Trait Implementations

impl Clone for Frame

fn clone(&self) -> Frame

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Frame

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

Formats the value using the given formatter.

impl PartialEq for Frame

fn eq(&self, other: &Frame) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Frame