Struct Decoder

pub struct Decoder<'de> { /* private fields */ }

Available on crate feature dyn-abi only.

The Decoder wraps a byte slice with necessary info to progressively deserialize the bytes into a sequence of tokens.

Usage Note

While the Decoder contains the necessary info, the actual deserialization is done in the crate::SolType trait.

Implementations

impl<'de> Decoder<'de>

pub const fn new(buf: &'de [u8], validate: bool) -> Decoder<'de>

Instantiate a new decoder from a byte slice and a validation flag.

If validate is true, the decoder will check that the bytes conform to expected type limitations, and that the decoded values can be re-encoded to an identical bytestring.

pub const fn offset(&self) -> usize

Returns the current offset in the buffer.

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

Returns the number of bytes in the remaining buffer.

pub const fn remaining_words(&self) -> usize

Returns the number of words in the remaining buffer.

pub fn remaining_buf(&self) -> Option<&'de [u8]>

Returns a reference to the remaining bytes in the buffer.

pub const fn is_empty(&self) -> bool

Returns whether the remaining buffer is empty.

pub const fn validate(&self) -> bool

Returns true if this decoder is validating type correctness.

pub fn set_validate(&mut self, validate: bool)

Set whether to validate type correctness.

pub fn raw_child(&self) -> Result<Decoder<'de>, Error>

Create a child decoder, starting at offset bytes from the current decoder’s offset.

See child.

pub fn child(&self, offset: usize) -> Result<Decoder<'de>, Error>

Create a child decoder, starting at offset bytes from the current decoder’s offset. The child decoder shares the buffer and validation flag.

pub fn peek<I>( &self, index: I, ) -> Result<&'de <I as SliceIndex<[u8]>>::Output, Error>

where I: SliceIndex<[u8]>,

Peek into the buffer.

pub fn peek_len_at(&self, offset: usize, len: usize) -> Result<&'de [u8], Error>

Peek a slice of size len from the buffer at a specific offset, without advancing the offset.

pub fn peek_len(&self, len: usize) -> Result<&'de [u8], Error>

Peek a slice of size len from the buffer without advancing the offset.

pub fn peek_word_at(&self, offset: usize) -> Result<&'de FixedBytes<32>, Error>

Peek a word from the buffer at a specific offset, without advancing the offset.

pub fn peek_word(&self) -> Result<&'de FixedBytes<32>, Error>

Peek the next word from the buffer without advancing the offset.

pub fn peek_offset_at(&self, offset: usize) -> Result<usize, Error>

Peek a usize from the buffer at a specific offset, without advancing the offset.

pub fn peek_offset(&self) -> Result<usize, Error>

Peek a usize from the buffer, without advancing the offset.

pub fn take_word(&mut self) -> Result<&'de FixedBytes<32>, Error>

Take a word from the buffer, advancing the offset.

pub fn take_indirection(&mut self) -> Result<Decoder<'de>, Error>

Return a child decoder by consuming a word, interpreting it as a pointer, and following it.

pub fn take_offset(&mut self) -> Result<usize, Error>

Takes a usize offset from the buffer by consuming a word.

pub fn take_slice(&mut self, len: usize) -> Result<&'de [u8], Error>

Takes a slice of bytes of the given length by consuming up to the next word boundary.

pub fn take_slice_unchecked(&mut self, len: usize) -> Result<&'de [u8], Error>

Takes a slice of bytes of the given length.

pub fn take_offset_from(&mut self, child: &Decoder<'de>)

Takes the offset from the child decoder and sets it as the current offset.

pub fn set_offset(&mut self, offset: usize)

Sets the current offset in the buffer.

pub fn decode<T>(&mut self) -> Result<T, Error>

where T: Token<'de>,

Decodes a single token from the underlying buffer.

pub fn decode_sequence<T>(&mut self) -> Result<T, Error>

where T: Token<'de> + TokenSeq<'de>,

Decodes a sequence of tokens from the underlying buffer.

Trait Implementations

impl<'de> Clone for Decoder<'de>

fn clone(&self) -> Decoder<'de>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Decoder<'_>

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

Formats the value using the given formatter.

impl Display for Decoder<'_>

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

Formats the value using the given formatter.

impl<'de> Copy for Decoder<'de>

Layout

Note: Most layout information is completely unstable and may even differ between compilations. The only exception is types with certain repr(...) attributes. Please see the Rust Reference's “Type Layout” chapter for details on type layout guarantees.

Size: 32 bytes