Struct SnapshotPlan 

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

Validated plan that can compute its encoded length and write itself.

SnapshotPlan performs all duplicate-kind, alignment, and count checks at construction. After construction, encoded_len and write_into are guaranteed to succeed for any caller-supplied buffer that is at least encoded_len() bytes long.

Performance

Construction is O(s^2) for s sections (duplicate-kind check). encoded_len and write_into are O(s + total payload bytes).

Implementations

impl<'a> SnapshotPlan<'a>

pub fn new(sections: &'a [PendingSection<'a>]) -> Result<Self, PlanError>

Validates a slice of pending sections and constructs a plan.

Errors

Returns PlanError when alignment is too large, too many sections are supplied, or duplicate kinds are present.

Performance

This function is O(s^2) for s sections.

pub const fn section_count(&self) -> usize

Returns the number of sections in this plan.

Performance

This method is O(1).

pub fn encoded_len(&self) -> Result<usize, PlanError>

Computes the total bytes the encoded snapshot will occupy.

Errors

Returns PlanError::PayloadOverflow when offset arithmetic exceeds usize or u64 representable values.

Performance

This function is O(s) for s sections.

pub fn write_into(&self, out: &mut [u8]) -> Result<usize, PlanError>

Writes the encoded snapshot into out and returns the number of bytes written.

Padding bytes between the section table and each section payload are zero-filled deterministically; the resulting bytes are stable for any logical input.

Errors

Returns PlanError::BufferTooSmall when out.len() is less than encoded_len or PlanError::PayloadOverflow when offset arithmetic overflows during the write walk.

Performance

This function is O(s + total payload bytes).

Trait Implementations

impl<'a> Clone for SnapshotPlan<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for SnapshotPlan<'a>

impl<'a> Debug for SnapshotPlan<'a>

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

Formats the value using the given formatter.