Struct BlockBuilder 

pub struct BlockBuilder<T: Copy, const N: usize> { /* private fields */ }

Privately fills one block and publishes it to the caller only when complete.

A discontinuous sample is rejected without changing the partial block. The caller can preserve it, or call clear and retry the returned sample as the start of a new window. This keeps loss policy explicit.

Implementations

impl<T: Copy, const N: usize> BlockBuilder<T, N>

pub const fn new() -> Self

Create an empty builder.

N == 0 is rejected at compile time.

pub fn push( &mut self, sequence: u32, sample: T, ) -> Result<Option<Block<T, N>>, FillError<T>>

Append one sequenced sample.

Returns Ok(None) while the block is partial and Ok(Some(block)) exactly when the Nth sample completes it. Completion also resets the builder, ready for the next block.

pub fn clear(&mut self)

Discard the partial block, if any.

pub const fn len(&self) -> usize

Number of samples currently held in the private partial block.

pub const fn is_empty(&self) -> bool

Whether no partial block is being filled.

pub const fn capacity(&self) -> usize

Number of samples required for a complete block.

pub const fn expected_sequence(&self) -> Option<u32>

Sequence required by the next push, or None when any non-zero sequence may start a new block.

Trait Implementations

impl<T: Copy, const N: usize> Debug for BlockBuilder<T, N>

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

Formats the value using the given formatter.

impl<T: Copy, const N: usize> Default for BlockBuilder<T, N>

fn default() -> Self

Returns the “default value” for a type.