Struct BitsBuffer 

pub struct BitsBuffer<'a, T> { /* private fields */ }

Available on crate feature alloc only.

Implementations

impl<'a, T> BitsBuffer<'a, T>

pub fn new(inner: BitsWrapper<'a, T>) -> Self

impl<T> BitsBuffer<'_, T>

pub fn flush_every_n(&mut self, n: usize)

Trait Implementations

impl<'a, T: 'a> Bits for BitsBuffer<'a, T>

where BitsWrapper<'a, T>: Bits,

fn next_u8(&mut self) -> Result<Option<u8>, Error>

Optionally returns a single u8

fn read_some_into<R: MutBits>(&mut self, buf: &mut R) -> Result<usize, Error>

Reads some subset of the data into the specified target.

fn read_u8(&mut self) -> Result<u8, Error>

Reads a single u8

fn read_i8(&mut self) -> Result<i8, Error>

Reads a single i8

fn next_i8(&mut self) -> Result<Option<i8>, Error>

Optionally returns a single i8

fn read_bool(&mut self) -> Result<bool, Error>

Reads a single bool (u8), returning true if 1, false if 0, or InvalidInput if anything else.

fn next_bool(&mut self) -> Result<Option<bool>, Error>

Reads a single bool (u8), returning true if 1, false if 0, or InvalidInput if anything else.

fn read_be_utf8_char(&mut self) -> Result<char, Error>

Reads 1, 2, 3, or 4 bytes to construct a UTF-8 charpoint.

fn read_be_u16(&mut self) -> Result<u16, Error>

Reads a single u16 in big-endian order, 2 bytes, MSB first.

fn read_le_u16(&mut self) -> Result<u16, Error>

Reads a single u16 in little-endian order, 2 bytes, LSB first.

fn next_be_u16(&mut self) -> Result<Option<u16>, Error>

Optionally reads a single u16 in big-endian order, 2 bytes, MSB first.

fn next_le_u16(&mut self) -> Result<Option<u16>, Error>

Optionally reads a single u16 in little-endian order, 2 bytes, LSB first.

fn read_be_u32(&mut self) -> Result<u32, Error>

Reads a single u32 in big-endian order, 4 bytes, MSB first.

fn read_le_u32(&mut self) -> Result<u32, Error>

Reads a single u32 in little-endian order, 4 bytes, LSB first.

fn next_be_u32(&mut self) -> Result<Option<u32>, Error>

Optionally reads a single u32 in big-endian order, 4 bytes, MSB first.

fn next_le_u32(&mut self) -> Result<Option<u32>, Error>

Optionally reads a single u32 in little-endian order, 4 bytes, LSB first.

fn read_be_u64(&mut self) -> Result<u64, Error>

Reads a single u64 in big-endian order, 8 bytes, MSB first.

fn read_le_u64(&mut self) -> Result<u64, Error>

Reads a single u64 in big-endian order, 8 bytes, MSB first.

fn next_be_u64(&mut self) -> Result<Option<u64>, Error>

Optionally reads a single u64 in big-endian order, 8 bytes, MSB first.

fn next_le_u64(&mut self) -> Result<Option<u64>, Error>

Optionally reads a single u64 in little-endian order, 4 bytes, LSB first.

fn read_be_u128(&mut self) -> Result<u128, Error>

Reads a single u128 in big-endian order, 16 bytes, MSB first.

fn next_be_u128(&mut self) -> Result<Option<u128>, Error>

Optionally reads a single u128 in big-endian order, 16 bytes, MSB first.

fn read_be_i128(&mut self) -> Result<i128, Error>

Reads a single i128 in big-endian order, 16 bytes, MSB first.

fn next_be_i128(&mut self) -> Result<Option<i128>, Error>

Optionally reads a single i128 in big-endian order, 16 bytes, MSB first.

fn read_be_f32(&mut self) -> Result<f32, Error>

Reads a single f32, 4 bytes. Standard IEEE754 encoding

fn read_le_f32(&mut self) -> Result<f32, Error>

Reads a single f32, 4 bytes. Reversed IEEE754 encoding

fn read_f32(&mut self, order: ByteOrder) -> Result<f32, Error>

Reads a single f32, 4 bytes. Specified byte ordering.

fn next_be_f32(&mut self) -> Result<Option<f32>, Error>

Optionally reads a single f32, 4 bytes. Standard IEEE754 encoding

fn next_le_f32(&mut self) -> Result<Option<f32>, Error>

Optionally reads a single f32, 4 bytes. Reversed IEEE754 encoding

fn read_be_f64(&mut self) -> Result<f64, Error>

Reads a single f64, 8 bytes. Standard IEEE754 encoding

fn read_le_f64(&mut self) -> Result<f64, Error>

Reads a single f64, 8 bytes. Reversed IEEE754 encoding

fn next_be_f64(&mut self) -> Result<Option<f64>, Error>

Optionally reads a single f64, 8 bytes. Standard IEEE754 encoding

fn next_le_f64(&mut self) -> Result<Option<f64>, Error>

Optionally reads a single f64, 8 bytes. Reversed IEEE754 encoding

fn read_f64(&mut self, order: ByteOrder) -> Result<f64, Error>

Reads a single f64, 8 bytes. Specified byte ordering.

fn read_be_i16(&mut self) -> Result<i16, Error>

Reads a single i16 in big-endian order, 2 bytes, MSB first.

fn read_le_i16(&mut self) -> Result<i16, Error>

Reads a single i16 in little-endian order, 2 bytes, LSB first.

fn next_be_i16(&mut self) -> Result<Option<i16>, Error>

Optionally reads a single i16 in big-endian order, 2 bytes, MSB first.

fn next_le_i16(&mut self) -> Result<Option<i16>, Error>

Optionally reads a single i16 in little-endian order, 2 bytes, LSB first.

fn read_be_i32(&mut self) -> Result<i32, Error>

Reads a single i32 in big-endian order, 4 bytes, MSB first.

fn read_le_i32(&mut self) -> Result<i32, Error>

Reads a single i32 in little-endian order, 4 bytes, LSB first.

fn next_be_i32(&mut self) -> Result<Option<i32>, Error>

Optionally reads a single i32 in big-endian order, 4 bytes, MSB first.

fn next_le_i32(&mut self) -> Result<Option<i32>, Error>

Optionally reads a single i32 in little-endian order, 4 bytes,LSB first.

fn read_be_i64(&mut self) -> Result<i64, Error>

Reads a single i64 in big-endian order, 8 bytes, MSB first.

fn read_le_i64(&mut self) -> Result<i64, Error>

Reads a single i64 in little-endian order, 8 bytes, LSB first.

fn next_be_i64(&mut self) -> Result<Option<i64>, Error>

Optionally reads a single i64 in big-endian order, 8 bytes, MSB first.

fn next_le_i64(&mut self) -> Result<Option<i64>, Error>

Optionally reads a single i64 in little-endian order, 8 bytes, LSB first.

fn read_le_i128(&mut self) -> Result<i128, Error>

Reads a single i128 in little-endian order, 8 bytes, LSB first.

fn next_le_i128(&mut self) -> Result<Option<i128>, Error>

Optionally reads a single i64 in little-endian order, 8 bytes, LSB first.

fn read_le_u128(&mut self) -> Result<u128, Error>

Reads a single u128 in little-endian order, 8 bytes, LSB first.

fn next_le_u128(&mut self) -> Result<Option<u128>, Error>

Optionally reads a single i64 in little-endian order, 8 bytes, LSB first.

fn advance(&mut self, len: usize) -> Result<usize, Error>

Advances the stream by at most ‘len’ bytes. The actual amount of bytes advanced may be less, and is returned in [Ok(usize)]

fn read_u8_blob_into<T: MutBits>(&mut self, into: &mut T) -> Result<(), Error>

fn read_u16_blob_into<T: MutBits>(&mut self, into: &mut T) -> Result<(), Error>

fn read_u32_blob_into<T: MutBits>(&mut self, into: &mut T) -> Result<(), Error>

fn read_u64_blob_into<T: MutBits>(&mut self, into: &mut T) -> Result<(), Error>

fn read_str_nul_terminated_into<T: MutBits>( &mut self, into: &mut T, ) -> Result<(), Error>

reads from the stream until a null (0x0) is encountered into the provided output, does NOT include null.

fn read_u8_blob(&mut self) -> Result<Vec<u8>, Error>

Reads a sized blob, a series of bytes preceded by a u8 declaring the size.

fn read_be_u16_blob(&mut self) -> Result<Vec<u8>, Error>

Reads a sized blob, a series of bytes preceded by a u16 declaring the size.

fn read_le_u16_blob(&mut self) -> Result<Vec<u8>, Error>

Reads a sized blob, a series of bytes preceded by a u16 declaring the size.

fn read_be_u32_blob(&mut self) -> Result<Vec<u8>, Error>

Reads a sized blob, a series of bytes preceded by a u32 declaring the size.

fn read_le_u32_blob(&mut self) -> Result<Vec<u8>, Error>

Reads a sized blob, a series of bytes preceded by a u32 declaring the size.

fn read_be_u64_blob(&mut self) -> Result<Vec<u8>, Error>

Reads a sized blob, a series of bytes preceded by a u64 declaring the size.

fn read_le_u64_blob(&mut self) -> Result<Vec<u8>, Error>

Reads a sized blob, a series of bytes preceded by a u64 declaring the size.

fn read_exact_vec(&mut self, size: usize) -> Result<Vec<u8>, Error>

Reads the specified amount of bytes into a Vec<u8> and returns it

fn read_all_str_lossy(&mut self) -> Result<String, Error>

Reads the entire stream into a UTF-8 String, dropping all other bytes.

fn read_str_sized_lossy(&mut self, len: usize) -> Result<String, Error>

Reads the specified amount of bytes into a UTF-8 String, dropping all other bytes.

fn read_str_null_terminated(&mut self) -> Result<String, Error>

Reads a string from the stream, terminated by a null byte. Does NOT include the null byte.

fn read_all_vec(&mut self) -> Result<Vec<u8>, Error>

Reads to the end of the stream and returns the data as a Vec<u8>

fn read_until(&mut self, search: &[u8]) -> Result<Vec<u8>, Error>

Reads from the input stream until:

fn read_line_vec(&mut self) -> Result<Option<Vec<u8>>, Error>

Reads until the next \n character, ignoring any \r characters along the way.

fn read_line_str_lossy(&mut self) -> Result<Option<String>, Error>

Reads until the next \n character, then calls String::from_utf8_lossy.

fn read_line_str(&mut self) -> Result<Option<String>, Error>

Reads until the next \n character, then calls String::from_utf8

fn consume_until(&mut self, search: &[u8]) -> Result<bool, Error>

Consumes data from the input stream until:

fn read_str_u32_blob(&mut self) -> Result<String, Error>

Reads a specific sized string from the stream, a string prefixed by a 4-byte big-endian length.

fn read_exact<const N: usize>(&mut self) -> Result<[u8; N], Error>

Reads the specified amount of bytes into a stack-allocated array.

fn read_exact_into<T: MutBits>( &mut self, size: usize, into: &mut T, ) -> Result<(), Error>

Reads the specified amount of bytes into the specified target.

fn read_all_into<T: MutBits>(&mut self, into: &mut T) -> Result<(), Error>

Reads to the end of the stream, and writes it into the specified target.

fn read_filling<T: MutBits>(&mut self, into: &mut T) -> Result<(), Error>

Fills the provided buffer

fn read_u16(&mut self, order: ByteOrder) -> Result<u16, Error>

Reads a single u16 in the specified order order, 2 bytes.

fn read_u32(&mut self, order: ByteOrder) -> Result<u32, Error>

Reads a single u32 in the specified order order, 4 bytes.

fn read_u64(&mut self, order: ByteOrder) -> Result<u64, Error>

Reads a single u64 in the specified order order, 8 bytes.

fn read_u128(&mut self, order: ByteOrder) -> Result<u128, Error>

Reads a single u128 in the specified order order, 16 bytes.

fn read_i16(&mut self, order: ByteOrder) -> Result<i16, Error>

Reads a single i16 in the specified order order, 2 bytes.

fn read_i32(&mut self, order: ByteOrder) -> Result<i32, Error>

Reads a single i32 in the specified order order, 4 bytes.

fn read_i64(&mut self, order: ByteOrder) -> Result<i64, Error>

Reads a single i64 in the specified order order, 4 bytes.

fn read_i128(&mut self, order: ByteOrder) -> Result<i128, Error>

Reads a single i128 in the specified order order, 16 bytes.

fn remaining(&self) -> Option<usize>

Some implementations may be able to return the size of the remaining data in the buffer.

impl<'a, T: 'a> BufBits for BitsBuffer<'a, T>

where BitsWrapper<'a, T>: Bits,

fn fill_buf(&mut self) -> Result<&[u8], Error>

fn consume(&mut self, amt: usize)

fn has_data_left(&mut self) -> Result<bool, Error>

impl<'a, T: 'a> MutBits for BitsBuffer<'a, T>

where BitsWrapper<'a, T>: MutBits,

fn write_u8(&mut self, val: u8) -> Result<(), Error>

Writes a single u8

fn write_some_bytes(&mut self, val: &[u8]) -> usize

Writes some subset of bytes until either the input is exhausted, or the underlying buffer fills up or errors. Returns the total number of bytes written

fn flush(&mut self) -> Result<(), Error>

Flush all bytes out of the cache. Most impl’s won’t need this.

fn write_i8(&mut self, val: i8) -> Result<(), Error>

Writes a single i8

fn write_bool(&mut self, val: bool) -> Result<(), Error>

Writes 1u8 if true, 0u8 if false

fn write_be_utf8_char(&mut self, val: char) -> Result<usize, Error>

Encodes the character as UTF-8, and writes anywhere from 1-4 bytes. The number of bytes written is returned.

fn write_be_u16(&mut self, val: u16) -> Result<(), Error>

Writes a single u16 in big-endian order, 2 bytes, MSB first.

fn write_le_u16(&mut self, val: u16) -> Result<(), Error>

Writes a single u16 in little-endian order, 2 bytes, LSB first.

fn write_be_u32(&mut self, val: u32) -> Result<(), Error>

Writes a single u32 in big-endian order, 4 bytes, MSB first.

fn write_le_u32(&mut self, val: u32) -> Result<(), Error>

Writes a single u32 in little-endian order, 4 bytes, LSB first.

fn write_be_u64(&mut self, val: u64) -> Result<(), Error>

Writes a single u64 in big-endian order, 8 bytes, MSB first.

fn write_le_u64(&mut self, val: u64) -> Result<(), Error>

Writes a single u64 in little-endian order, 8 bytes, LSB first.

fn write_be_u128(&mut self, val: u128) -> Result<(), Error>

Writes a single u128 in big-endian order, 16 bytes, MSB first.

fn write_le_u128(&mut self, val: u128) -> Result<(), Error>

Writes a single u128 in little-endian order, 16 bytes, LSB first.

fn write_be_f32(&mut self, val: f32) -> Result<(), Error>

Writes a single f32 in standard IEEE754 format, 4 bytes

fn write_le_f32(&mut self, val: f32) -> Result<(), Error>

Writes a single f32 in reversed IEEE754 format, 4 bytes

fn write_be_f64(&mut self, val: f64) -> Result<(), Error>

Writes a single u16 in standard IEEE754 format, 8 bytes

fn write_le_f64(&mut self, val: f64) -> Result<(), Error>

Writes a single u16 in reversed IEEE754 format, 8 bytes

fn write_be_i16(&mut self, val: i16) -> Result<(), Error>

Writes a single i16 in big-endian order, 2 bytes, MSB first.

fn write_le_i16(&mut self, val: i16) -> Result<(), Error>

Writes a single i16 in little-endian order, 2 bytes, LSB first.

fn write_be_i32(&mut self, val: i32) -> Result<(), Error>

Writes a single i32 in big-endian order, 4 bytes, MSB first.

fn write_le_i32(&mut self, val: i32) -> Result<(), Error>

Writes a single i32 in little-endian order, 4 bytes, LSB first.

fn write_be_i64(&mut self, val: i64) -> Result<(), Error>

Writes a single i64 in big-endian order, 8 bytes, MSB first.

fn write_le_i64(&mut self, val: i64) -> Result<(), Error>

Writes a single i64 in little-endian order, 8 bytes, LSB first.

fn write_be_i128(&mut self, val: i128) -> Result<(), Error>

Writes a single i128 in big-endian order, 16 bytes, MSB first.

fn write_le_i128(&mut self, val: i128) -> Result<(), Error>

Writes a single i128 in little-endian order, 16 bytes, LSB first.

fn write_u8_blob(&mut self, val: &[u8]) -> Result<(), Error>

Writes a sized blob, a series of bytes preceded by a u8 declaring the size

fn write_be_u16_blob(&mut self, val: &[u8]) -> Result<(), Error>

Writes a sized blob, a series of bytes preceded by a u16 declaring the size

fn write_le_u16_blob(&mut self, val: &[u8]) -> Result<(), Error>

Writes a sized blob, a series of bytes preceded by a u16 declaring the size

fn write_be_u32_blob(&mut self, val: &[u8]) -> Result<(), Error>

Writes a sized blob, a series of bytes preceded by a u32 declaring the size

fn write_le_u32_blob(&mut self, val: &[u8]) -> Result<(), Error>

Writes a sized blob, a series of bytes preceded by a u32 declaring the size

fn write_be_u64_blob(&mut self, val: &[u8]) -> Result<(), Error>

Writes a sized blob, a series of bytes preceded by a u64 declaring the size

fn write_le_u64_blob(&mut self, val: &[u8]) -> Result<(), Error>

Writes a sized blob, a series of bytes preceded by a u64 declaring the size

fn write_all_bytes(&mut self, val: &[u8]) -> Result<(), Error>

Writes all the bytes in order

fn write_fmt_impl(&mut self, args: Arguments<'_>) -> Result<(), Error>

Allows the use of core::format_args macro

fn write_str_u32_blob(&mut self, val: &str) -> Result<usize, Error>

Writes a specific sized string from the stream, a string prefixed by a 4-byte big-endian length.

fn write_exact(&mut self, val: &[u8], len: usize) -> Result<(), Error>

Writes the exact amount of bytes from the input buffer to the output stream Returns an error if the buffer doesn’t have enough values or if the output stream errors.

fn write_all_into_self_from<T: Bits>( &mut self, other: &mut T, ) -> Result<u64, Error>

Copies all data from the other stream into this stream.