Struct BitBuffer

pub struct BitBuffer<Inner = BitVector> { /* private fields */ }

A bit buffer can be used to read bits from or write bits to an underlying bit vector.

Implementations

impl<Block: BlockType> BitBuffer<BitVector<Block>>

pub fn new() -> Self

Creates a new, empty bit buffer.

pub fn with_capacity(capacity: u64) -> Self

Creates a new, empty bit buffer with the given capacity (in bits) preallocated.

impl<Inner: BitVec> BitBuffer<Inner>

pub fn from(input: Inner) -> Self

Creates a new bit buffer for reading from a bit vector.

pub fn append(vec: Inner) -> Self

Creates a new bit buffer for appending to a bit vector.

pub fn seek(&mut self, position: u64) -> Result<()>

Moves the position for the next read or write.

impl<Inner> BitBuffer<Inner>

pub fn into_inner(self) -> Inner

Returns the bit vector underlying the bit buffer.

pub fn inner(&self) -> &Inner

Gives access to the bit vector underlying the bit buffer.

pub fn position(&self) -> u64

The position in the bit buffer where the next read or write will occur.

Trait Implementations

impl<Inner: BitVec> BitRead for BitBuffer<Inner>

fn read_bit(&mut self) -> Result<Option<bool>>

Reads a single bit from the source.

fn read_int<N: PrimInt>(&mut self, nbits: usize) -> Result<Option<N>>

Reads nbits bits as an integer, least-significant bit first.

fn read_int_be<N: PrimInt>(&mut self, nbits: usize) -> Result<Option<N>>

Reads nbits bits as an integer, most-significant bit first.

impl<Inner: BitVec> BitVec for BitBuffer<Inner>

type Block = <Inner as BitVec>::Block

The underlying block type used to store the bits of the vector.

fn block_len(&self) -> usize

The length of the slice in blocks.

fn bit_len(&self) -> u64

The length of the slice in bits.

fn get_block(&self, position: usize) -> Self::Block

Gets the block at position

fn get_bit(&self, position: u64) -> bool

Gets the bit at position

fn get_bits(&self, start: u64, count: usize) -> Self::Block

Gets count bits starting at bit index start, interpreted as a little-endian integer.

impl<Inner: BitVecMut> BitVecMut for BitBuffer<Inner>

fn set_block(&mut self, position: usize, value: Self::Block)

Sets the block at position to value.

fn set_bit(&mut self, position: u64, value: bool)

Sets the bit at position to value.

fn set_bits(&mut self, start: u64, count: usize, value: Self::Block)

Sets count bits starting at bit index start, interpreted as a little-endian integer.

impl<Inner: BitVecPush> BitWrite for BitBuffer<Inner>

fn write_bit(&mut self, value: bool) -> Result<()>

Writes a single bit to the sink.

fn write_int<N: PrimInt>(&mut self, nbits: usize, value: N) -> Result<()>

Writes the lower nbits of value, least-significant first.

fn write_int_be<N: PrimInt>(&mut self, nbits: usize, value: N) -> Result<()>

Writes the lower nbits of value, most-significant first.

impl<Inner: Clone> Clone for BitBuffer<Inner>

fn clone(&self) -> BitBuffer<Inner>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Inner: Debug> Debug for BitBuffer<Inner>

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

Formats the value using the given formatter.