Struct BlockAccountant 

pub struct BlockAccountant { /* private fields */ }

Keeps track of downloaded data on per-block basis.

Implementations

impl BlockAccountant

pub fn new(pieces: Rc<PieceInfo>) -> Self

pub fn submit_block(&mut self, block_info: &BlockInfo) -> Result<usize, Error>

Try to add a received block to the internal records. Fails if the block has invalid offset, index or length.

pub fn submit_piece(&mut self, piece_index: usize) -> bool

Mark a piece as downloaded. Fails if the piece index is invalid.

pub fn submit_bitfield(&mut self, bitfield: &Bitfield) -> bool

Update internal records from a bitfield. All pieces present in the bitfield will be marked as downloaded. Fails if the bitfield has unexpected length.

pub fn remove_piece(&mut self, piece_index: usize)

Remove a piece from the internal records, i.e. no longer consider it as downloaded.

pub fn has_exact_block_at(&self, global_offset: usize, length: usize) -> bool

Check whether length bytes at global_offset have been downloaded.

pub fn has_exact_block(&self, block_info: &BlockInfo) -> bool

Check presense of an exact block among the downloaded data.

pub fn has_piece(&self, piece_index: usize) -> bool

Check whether the piece at piece_index has been downloaded.

pub fn generate_bitfield(&self) -> Bitfield

Represent the internal state as a bitfield. Partially downloaded pieces won’t be included.

pub fn accounted_bytes(&self) -> usize

The total number of downloaded bytes.

pub fn missing_bytes(&self) -> usize

The total number of missing bytes.

Trait Implementations

impl Debug for BlockAccountant

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

Formats the value using the given formatter.