Struct SegmentSliceVec 

pub struct SegmentSliceVec { /* private fields */ }

One validator’s slices of a work package’s segments: one slice per segment, all of the same length.

Erasure-coding n segments for v validators yields a v x n matrix of slices; this type is one row. Segment j is reconstructed from the j-th slice of any D(v) rows:

                 seg 0   seg 1   ...   seg n-1
validator 0      slice   slice         slice     <- one SegmentSliceVec
...
validator v-1    slice   slice         slice

The row is stored as data, the concatenation of the validator’s slices in segment order; slice_len (SEGMENT_LEN / D(v), a property of the erasure coding rather than a protocol constant) gives the slice boundaries within it. The slice count is bound by the maximum number of segments a work package may export.

Every constructor takes the slice length, so slice_len is always in [1, MAX_SEGMENT_SLICE_LEN].

Implementations

impl SegmentSliceVec

pub fn raw(&self) -> &[u8]

Get the raw byte buffer: all slices concatenated in segment order.

pub fn into_inner(self) -> Vec<u8>

Get the underlying Vec.

pub fn slice_len(&self) -> usize

Returns the length of each contained slice.

pub fn from_bytes(data: Vec<u8>, slice_len: usize) -> Option<Self>

Creates a vec of slice_len-sized slices from serialized bytes. Returns None if the size is incorrect.

pub fn with_capacity(capacity: usize, slice_len: usize) -> Self

Preallocates a vec for the given number of slice_len-sized slices.

pub fn len(&self) -> usize

Returns the number of slices.

pub fn is_empty(&self) -> bool

Check if the vec is empty.

pub fn push(&mut self, slice: &[u8]) -> Result<(), &'static str>

Appends a slice to this vec. Returns an error if the slice size is incorrect or the vec overflows.

pub fn push_default(&mut self) -> Result<&mut [u8], &'static str>

Adds a new empty slice to the vec and returns a reference to it. Produces an error if the vec overflows.

Trait Implementations

impl Clone for SegmentSliceVec

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SegmentSliceVec

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

Formats the value using the given formatter.

impl Eq for SegmentSliceVec

impl Index<usize> for SegmentSliceVec

type Output = [u8]

The returned type after indexing.

fn index(&self, index: usize) -> &Self::Output

Performs the indexing (container[index]) operation.

impl PartialEq for SegmentSliceVec

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for SegmentSliceVec