Struct Snapshot 

pub struct Snapshot<'view> { /* private fields */ }

Validated, borrowed handle to a snapshot’s bytes and section table.

A Snapshot is constructed via Snapshot::open (default ValidationLevel::Layout) or Snapshot::open_with. The handle itself is Copy and trivially cheap to pass; cloning it does not re-validate.

For header-only inspection without parsing the section table, use HeaderOnlySnapshot instead — Snapshot always carries a validated section table.

Performance

Open is O(s^2) for s sections at ValidationLevel::Layout due to duplicate-kind detection, otherwise O(s). Subsequent reads are O(1) to O(s) per call. No allocation occurs.

Implementations

impl<'view> Snapshot<'view>

pub fn open(bytes: &'view [u8]) -> Result<Self, SnapshotError>

Opens bytes as a validated snapshot at ValidationLevel::Layout.

Errors

Returns SnapshotError for any header, section table, or layout invariant violation.

Performance

O(s^2) for s section entries.

pub fn open_with( bytes: &'view [u8], level: ValidationLevel, ) -> Result<Self, SnapshotError>

Opens bytes as a snapshot validated at the requested level.

level selects between ValidationLevel::SectionTable (per-entry self-consistency only) and ValidationLevel::Layout (full payload-bounds and duplicate-kind walk). Header-only validation is deliberately not selectable here; callers wanting it should use HeaderOnlySnapshot::open.

Errors

Returns SnapshotError for any invariant violation visible at the requested level.

Performance

O(s) at ValidationLevel::SectionTable, O(s^2) at ValidationLevel::Layout.

pub const fn format_major(&self) -> u32

Returns the format major version recorded in the snapshot header.

Performance

This method is O(1).

pub const fn format_minor(&self) -> u32

Returns the format minor version recorded in the snapshot header.

Performance

This method is O(1).

pub const fn section_count(&self) -> usize

Returns the number of validated sections.

Performance

This method is O(1).

pub fn sections(&self) -> SectionIter<'view>

Returns an iterator over all validated sections.

Performance

Constructing the iterator is O(1); advancing it is O(1) per step.

pub fn section(&self, kind: u32) -> Option<Section<'view>>

Returns the section with the given kind, when present.

Performance

This method is O(s) for s section entries.

Trait Implementations

impl<'view> Clone for Snapshot<'view>

fn clone(&self) -> Snapshot<'view>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'view> Debug for Snapshot<'view>

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

Formats the value using the given formatter.

impl<'view> Copy for Snapshot<'view>