Enum BitsWrapper 

pub enum BitsWrapper<'a, T> {
    Owned(T),
    Borrowed(&'a mut T),
}

Wraps a borrowed value and provides implementations of [Bits] and [MutBits] where applicable.

Variants

Owned(T)

Borrowed(&'a mut T)

Trait Implementations

impl<T> Bits for BitsWrapper<'_, T>

where T: Read,

Available on crate feature std only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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

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

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

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>

Available on crate feature alloc only.

Reads from the input stream until:

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

Available on crate feature alloc only.

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

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

Available on crate feature alloc only.

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

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

Available on crate feature alloc only.

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

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

Available on crate feature alloc only.

Consumes data from the input stream until:

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

Available on crate feature alloc only.

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<B> Deref for BitsWrapper<'_, B>

type Target = B

The resulting type after dereferencing.

fn deref(&self) -> &Self::Target

Dereferences the value.

impl<B> DerefMut for BitsWrapper<'_, B>

fn deref_mut(&mut self) -> &mut Self::Target

Mutably dereferences the value.

impl<T> MutBits for BitsWrapper<'_, T>

where T: Write,

Available on crate feature std only.

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

Writes a single u8

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

Writes all the bytes in order

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_fmt_impl(&mut self, args: Arguments<'_>) -> Result<(), Error>

Available on crate feature alloc only.

Allows the use of core::format_args macro

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 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.

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

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

impl<T> Read for BitsWrapper<'_, T>

where T: Bits,

Available on crate feature std only.

fn read(&mut self, buf: &mut [u8]) -> Result<usize>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>

Like read, except that it reads into a slice of buffers.

fn is_read_vectored(&self) -> bool

🔬This is a nightly-only experimental API. (can_vector)

Determines if this Reader has an efficient read_vectored implementation.

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

Reads all bytes until EOF in this source, placing them into buf.

fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>

Reads all bytes until EOF in this source, appending them to buf.

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

Reads the exact number of bytes required to fill buf.

fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>

🔬This is a nightly-only experimental API. (read_buf)

Pull some bytes from this source into the specified buffer.

fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>

🔬This is a nightly-only experimental API. (read_buf)

Reads the exact number of bytes required to fill cursor.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Read.

fn bytes(self) -> Bytes<Self>

where Self: Sized,

Transforms this Read instance to an Iterator over its bytes.

fn chain<R>(self, next: R) -> Chain<Self, R>

where R: Read, Self: Sized,

Creates an adapter which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

where Self: Sized,

Creates an adapter which will read at most limit bytes from it.

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

where Self: Sized,

🔬This is a nightly-only experimental API. (read_array)

Read and return a fixed array of bytes from this source.