Struct DecoderBuffer

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

DecoderBuffer is a panic-free byte buffer for look-ahead decoding untrusted input

Implementations

impl<'a> DecoderBuffer<'a>

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

Create a new DecoderBuffer from a byte slice

pub fn into_less_safe_slice(self) -> &'a [u8]

Move out the buffer’s slice. This should be used with caution, as it removes any panic protection this struct provides.

impl<'a> DecoderBuffer<'a>

pub fn decode_slice( self, count: usize, ) -> DecoderBufferResult<'a, DecoderBuffer<'a>>

Decode a slice of bytes by count, removing the slice from the current buffer

let mut data = [0, 1, 2, 3, 4];
let buffer = DecoderBuffer::new(&mut data);

let (slice, buffer) = buffer.decode_slice(5).unwrap();
assert_eq!(slice, [0u8, 1, 2, 3, 4][..]);

assert!(buffer.is_empty());

pub fn decode<T: DecoderValue<'a>>(self) -> DecoderBufferResult<'a, T>

Decode a value of type T, splitting the data from the current buffer

let mut data = [0, 1, 2, 3, 4, 5, 6];
let buffer = DecoderBuffer::new(&mut data);

let (value, buffer) = buffer.decode::<u8>().unwrap();
assert_eq!(value, 0);

let (value, buffer) = buffer.decode::<u16>().unwrap();
assert_eq!(value, 258);

let (value, buffer) = buffer.decode::<u32>().unwrap();
assert_eq!(value, 50_595_078);

assert!(buffer.is_empty());

pub fn decode_slice_with_len_prefix<Length: DecoderValue<'a> + TryInto<usize>>( self, ) -> DecoderBufferResult<'a, Self>

Decode a slice prefixed by type Length, splitting the data from the current buffer. With a Length as encoded u8:

let mut data = [5, 0, 1, 2, 3, 4];
let buffer = DecoderBuffer::new(&mut data);
let (slice, buffer) = buffer.decode_slice_with_len_prefix::<u8>().unwrap();
assert_eq!(slice, [0u8, 1, 2, 3, 4][..]);
assert!(buffer.is_empty())

With a Length as encoded u16:

let mut data = [0, 5, 0, 1, 2, 3, 4];
let buffer = DecoderBuffer::new(&mut data);
let (slice, buffer) = buffer.decode_slice_with_len_prefix::<u16>().unwrap();
assert_eq!(slice, [0u8, 1, 2, 3, 4][..]);
assert!(buffer.is_empty())

pub fn decode_with_len_prefix<Length: DecoderValue<'a> + TryInto<usize>, T: DecoderValue<'a>>( self, ) -> DecoderBufferResult<'a, T>

Decode a value of type T prefixed by type Length, splitting the data from the current buffer. With a Length as encoded u8 and T as u16:

let mut data = [2, 0, 1, 2, 3];
let buffer = DecoderBuffer::new(&mut data);
let (value, buffer) = buffer.decode_with_len_prefix::<u8, u16>().unwrap();
assert_eq!(value, 1);
assert_eq!(buffer, [2, 3][..])

The DecoderValue implementation of T must consume the entire subslice otherwise an error will be returned.

let mut data = [3, 0, 1, 2];
let buffer = DecoderBuffer::new(&mut data);
let result = buffer.decode_with_len_prefix::<u8, u16>();
assert!(result.is_err())

pub fn decode_parameterized<T: DecoderParameterizedValue<'a>>( self, parameter: T::Parameter, ) -> DecoderBufferResult<'a, T>

Decode a parameterized value of type T implementing DecoderParameterizedValue

pub fn skip(self, count: usize) -> Result<DecoderBuffer<'a>, DecoderError>

Skip a count of bytes, discarding the bytes

let mut data = [0, 1, 2, 3, 4];
let buffer = DecoderBuffer::new(&mut data);
let buffer = buffer.skip(3).unwrap();
assert_eq!(buffer, [3, 4][..]);

pub fn skip_with_len_prefix<Length: DecoderValue<'a> + TryInto<usize>>( self, ) -> Result<DecoderBuffer<'a>, DecoderError>

Skip a number of bytes encoded as a length prefix of type Length With a Length encoded as u8:

let mut data = [5, 0, 1, 2, 3, 4];
let buffer = DecoderBuffer::new(&mut data);
let buffer = buffer.skip_with_len_prefix::<u8>().unwrap();
assert!(buffer.is_empty());

pub fn skip_into_range( self, count: usize, original_buffer: &DecoderBufferMut<'_>, ) -> DecoderBufferResult<'a, CheckedRange>

Skip a count of bytes, returning a CheckedRange for later access

pub fn skip_into_range_with_len_prefix<Length: DecoderValue<'a> + TryInto<usize>>( self, original_buffer: &DecoderBufferMut<'_>, ) -> DecoderBufferResult<'a, CheckedRange>

Skip a number of bytes encoded as a length prefix of type Length into a CheckedRange for later access

pub fn get_checked_range(&self, range: &CheckedRange) -> DecoderBuffer<'_>

Reads data from a CheckedRange

pub fn peek(&'a self) -> DecoderBuffer<'a>

Create a peeking DecoderBuffer from the current buffer view

let mut data = [0, 1];
let buffer = DecoderBuffer::new(&mut data);

let peek = buffer.peek();
let (value, peek) = peek.decode::<u16>().unwrap();
assert_eq!(value, 1);
assert!(peek.is_empty());

// `buffer` still contains the previous view
assert_eq!(buffer, [0, 1][..]);

pub fn peek_byte(&self, index: usize) -> Result<u8, DecoderError>

Returns a single byte at index

let mut data = [0, 1, 2];
let buffer = DecoderBuffer::new(&mut data);

assert_eq!(buffer.peek_byte(0).unwrap(), 0);
assert_eq!(buffer.peek_byte(1).unwrap(), 1);
assert_eq!(buffer.peek_byte(2).unwrap(), 2);

// `buffer` has not changed
assert_eq!(buffer, [0, 1, 2][..]);

pub fn peek_range( &self, range: Range<usize>, ) -> Result<DecoderBuffer<'_>, DecoderError>

Returns a PeekBuffer by range

pub fn ensure_empty(&self) -> Result<(), DecoderError>

Returns an error if the buffer is not empty.

let mut data = [1];
let buffer = DecoderBuffer::new(&mut data);

assert!(buffer.ensure_empty().is_err());
let (_, buffer) = buffer.decode::<u8>().unwrap();
assert!(buffer.ensure_empty().is_ok());

pub fn ensure_len(&self, len: usize) -> Result<(), DecoderError>

Returns an error if the buffer does not have at least len bytes.

let mut data = [0, 1, 2];
let buffer = DecoderBuffer::new(&mut data);

assert!(buffer.ensure_len(2).is_ok());
assert!(buffer.ensure_len(5).is_err());

pub fn len(&self) -> usize

Returns the number of bytes in the buffer.

let mut data = [0, 1, 2];
let buffer = DecoderBuffer::new(&mut data);

assert_eq!(buffer.len(), 3);
let (_, buffer) = buffer.decode::<u8>().unwrap();
assert_eq!(buffer.len(), 2);

pub fn is_empty(&self) -> bool

Returns true if the buffer has a length of 0.

let mut data = [1];
let buffer = DecoderBuffer::new(&mut data);

assert!(!buffer.is_empty());
let (_, buffer) = buffer.decode::<u8>().unwrap();
assert!(buffer.is_empty());

pub fn as_less_safe_slice(&'a self) -> &'a [u8]

Borrows the buffer’s slice. This should be used with caution, as it removes any panic protection this struct provides.

Trait Implementations

impl<'a> Clone for DecoderBuffer<'a>

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

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for DecoderBuffer<'a>

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

Formats the value using the given formatter.

impl<'a> DecoderValue<'a> for DecoderBuffer<'a>

fn decode(buffer: DecoderBuffer<'a>) -> DecoderBufferResult<'a, Self>

impl<'a> DecoderValueMut<'a> for DecoderBuffer<'a>

fn decode_mut(buffer: DecoderBufferMut<'a>) -> DecoderBufferMutResult<'a, Self>

impl EncoderValue for DecoderBuffer<'_>

fn encode<E: Encoder>(&self, encoder: &mut E)

Encodes the value into the encoder

fn encoding_size(&self) -> usize

Returns the encoding size with no buffer constrains

fn encoding_size_for_encoder<E: Encoder>(&self, _encoder: &E) -> usize

Returns the encoding size for the given encoder’s capacity

fn encode_mut<E: Encoder>(&mut self, encoder: &mut E)

Encodes the value into the encoder, while potentially mutating the value itself

fn encode_with_len_prefix<Len: TryFrom<usize> + EncoderValue, E: Encoder>( &self, encoder: &mut E, )

where Self: Sized, Len::Error: Debug,

Encodes the value into the encoder with a prefix of Len

fn encode_to_vec(&self) -> Vec<u8>

impl<'a> From<&'a [u8]> for DecoderBuffer<'a>

fn from(bytes: &'a [u8]) -> Self

Converts to this type from the input type.

impl<'a> From<&'a mut [u8]> for DecoderBuffer<'a>

fn from(bytes: &'a mut [u8]) -> Self

Converts to this type from the input type.

impl<'a> From<DecoderBufferMut<'a>> for DecoderBuffer<'a>

fn from(b: DecoderBufferMut<'a>) -> Self

Converts to this type from the input type.

impl<'a> Hash for DecoderBuffer<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> Ord for DecoderBuffer<'a>

fn cmp(&self, other: &DecoderBuffer<'a>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl<'a> PartialEq<[u8]> for DecoderBuffer<'a>

fn eq(&self, rhs: &[u8]) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialEq for DecoderBuffer<'a>

fn eq(&self, other: &DecoderBuffer<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

const fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> PartialOrd for DecoderBuffer<'a>

fn partial_cmp(&self, other: &DecoderBuffer<'a>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'a> Copy for DecoderBuffer<'a>

impl<'a> Eq for DecoderBuffer<'a>

impl<'a> StructuralPartialEq for DecoderBuffer<'a>