Struct DecBinary 

pub struct DecBinary<R> { /* private fields */ }

A decoding atlv stream in the process of decoding a binary value.

This implements Read, and additionally supplies DecBinary::read_vec, to quickly pull out a new byte vector of a particular size.

When all the bytes have been consumed, use DecBinary::done to return.

This will not allow you to read beyond the end of the buffer, and will error if you attempt to do so. Attempting to end early will likewise error.

Implementations

impl<R: Read> DecBinary<R>

pub fn read_vec(&mut self, n: usize) -> Result<Vec<u8>, Error>

Read some number of bytes into a new byte vector.

impl<R> DecBinary<R>

pub fn remaining(&self) -> usize

Get the number of bytes remaining in the binary.

This is mostly useful at the beginning, to read the full binary at once.

pub fn done<A>(self, res: A) -> Result<Decoded<R, A>, Error>

Finish up working with the binary.

This is usually the return value of the decoding function.

Note that this will fail unless all the data has been read.

Trait Implementations

impl<R: Read> Read for DecBinary<R>

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.