Struct SliceReader

pub struct SliceReader<'a> { /* private fields */ }

Reader which consumes an input byte slice.

Implementations

impl<'a> SliceReader<'a>

pub fn new(bytes: &'a [u8]) -> Result<Self>

Create a new slice reader for the given byte slice.

pub fn error(&mut self, kind: ErrorKind) -> Error

Return an error with the given ErrorKind, annotating it with context about where the error occurred.

pub fn value_error(&mut self, tag: Tag) -> Error

Return an error for an invalid value with the given tag.

pub fn is_failed(&self) -> bool

Did the decoding operation fail due to an error?

Trait Implementations

impl<'a> Clone for SliceReader<'a>

fn clone(&self) -> SliceReader<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for SliceReader<'a>

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

Formats the value using the given formatter.

impl<'a> Reader<'a> for SliceReader<'a>

fn input_len(&self) -> Length

Get the length of the input.

fn peek_byte(&self) -> Option<u8>

Peek at the next byte of input without modifying the cursor.

fn peek_header(&self) -> Result<Header>

Peek forward in the input data, attempting to decode a Header from the data at the current position in the decoder.

fn position(&self) -> Length

Get the position within the buffer.

fn read_slice(&mut self, len: Length) -> Result<&'a [u8]>

Attempt to read data borrowed directly from the input as a slice, updating the internal cursor position.

fn decode<T: Decode<'a>>(&mut self) -> Result<T>

Decode a value which impls the Decode trait.

fn error(&mut self, kind: ErrorKind) -> Error

Return an error with the given ErrorKind, annotating it with context about where the error occurred.

fn finish<T>(self, value: T) -> Result<T>

Finish decoding, returning the given value if there is no remaining data, or an error otherwise

fn remaining_len(&self) -> Length

Get the number of bytes still remaining in the buffer.

fn context_specific<T>( &mut self, tag_number: TagNumber, tag_mode: TagMode, ) -> Result<Option<T>>

where T: DecodeValue<'r> + FixedTag,

Attempt to decode an ASN.1 CONTEXT-SPECIFIC field with the provided TagNumber.

fn is_finished(&self) -> bool

Have we read all of the input data?

fn offset(&self) -> Length

Offset within the original input stream.

fn peek_tag(&self) -> Result<Tag>

Peek at the next byte in the decoder and attempt to decode it as a Tag value.

fn read_byte(&mut self) -> Result<u8>

Read a single byte.

fn read_into<'o>(&mut self, buf: &'o mut [u8]) -> Result<&'o [u8]>

Attempt to read input data, writing it into the provided buffer, and returning a slice on success.

fn read_nested<'n, T, F>(&'n mut self, len: Length, f: F) -> Result<T>

where F: FnOnce(&mut NestedReader<'n, Self>) -> Result<T>,

Read nested data of the given length.

fn read_vec(&mut self, len: Length) -> Result<Vec<u8>>

Read a byte vector of the given length.

fn sequence<'n, F, T>(&'n mut self, f: F) -> Result<T>

where F: FnOnce(&mut NestedReader<'n, Self>) -> Result<T>,

Read an ASN.1 SEQUENCE, creating a nested Reader for the body and calling the provided closure with it.

fn tlv_bytes(&mut self) -> Result<&'r [u8]>

Obtain a slice of bytes contain a complete TLV production suitable for parsing later.