Struct reed_solomon_erasure::ShardByShard

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

Bookkeeper for shard by shard encoding.

This is useful for avoiding incorrect use of encode_single, encode_single_sep, encode_single_shard and encode_single_shard_sep.

Use cases

Shard by shard encoding is useful for streamed data encoding where you do not have all the needed data shards immediately, but you want to spread out the encoding workload rather than doing the encoding after everything is ready.

A concrete example would be network packets encoding, where encoding packet by packet as you receive them may be more efficient than waiting for N packets then encode them all at once.

Example

let r = ReedSolomon::new(3, 2).unwrap();

let mut sbs = ShardByShard::new(&r);

let mut shards = shards!([0,  1,  2,  3,  4],
                         [5,  6,  7,  8,  9],
                         // say we don't have the 3rd data shard yet
                         // and we want to fill it in later
                         [0,  0,  0,  0,  0],
                         [0,  0,  0,  0,  0],
                         [0,  0,  0,  0,  0]);

// encode 1st and 2nd data shard
sbs.encode_shard(&mut shards).unwrap();
sbs.encode_shard(&mut shards).unwrap();

// fill in 3rd data shard
shards[2][0] = 10;
shards[2][1] = 11;
shards[2][2] = 12;
shards[2][3] = 13;
shards[2][4] = 14;

// now do the encoding
sbs.encode_shard(&mut shards).unwrap();

// above is equivalent to doing r.encode_shards(&mut shards)
assert!(r.verify_shards(&shards).unwrap());

Implementations

impl<'a> ShardByShard<'a>

pub fn new(codec: &'a ReedSolomon) -> ShardByShard<'a>

Creates a new instance of the bookkeeping struct.

pub fn parity_ready(&self) -> bool

Checks if the parity shards are ready to use.

pub fn reset(&mut self) -> Result<(), SBSError>

Resets the bookkeeping data.

You should call this when you have added and encoded all data shards, and have finished using the parity shards.

Returns SBSError::LeftoverShards when there are shards encoded but parity shards are not ready to use.

pub fn reset_force(&mut self)

Resets the bookkeeping data without checking.

pub fn cur_input_index(&self) -> usize

Returns the current input shard index.

pub fn encode(&mut self, slices: &mut [&mut [u8]]) -> Result<(), SBSError>

Constructs the parity shards partially using the current input data shard.

Returns SBSError::TooManyCalls when all input data shards have already been filled in via encode or encode_shard.

pub fn encode_sep(
    &mut self,
    data: &[&[u8]],
    parity: &mut [&mut [u8]]
) -> Result<(), SBSError>

Constructs the parity shards partially using the current input data shard.

Returns SBSError::TooManyCalls when all input data shards have already been filled in via encode or encode_shard.

pub fn encode_shard(&mut self, shards: &mut [Shard]) -> Result<(), SBSError>

Constructs the parity shards partially using the current input data shard.

Returns SBSError::TooManyCalls when all input data shards have already been filled in via encode or encode_shard.

pub fn encode_shard_sep(
    &mut self,
    data: &[Shard],
    parity: &mut [Shard]
) -> Result<(), SBSError>

Constructs the parity shards partially using the current input data shard.

Returns TooManyCalls when all input data shards have already been filled in via encode or encode_shard.

Trait Implementations

impl<'a> Debug for ShardByShard<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq<ShardByShard<'a>> for ShardByShard<'a>

fn eq(&self, other: &ShardByShard<'a>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> StructuralPartialEq for ShardByShard<'a>