Struct DepthAwareReader 

pub struct DepthAwareReader<'data, R: Read<'data>> { /* private fields */ }

Depth-aware wrapper around a Read implementation. If you care about billion-laughs attacks, then you should use it.

Implementations

impl<'data, R: Read<'data>> DepthAwareReader<'data, R>

pub const DEFAULT_LIMIT: usize = 256

Default depth limit

pub fn from_reader(reader: R) -> Self

Initializes a DepthAwareReader using Self::DEFAULT_LIMIT as a depth limit

pub fn from_reader_with_limit(reader: R, limit: usize) -> Self

Initializes a DepthAwareReader using a custom depth limit

pub fn enter(&mut self) -> ReadResult<DepthAwareReaderGuard<'_, 'data, R>>

Increments the current depth, checks if it didn’t exceed the limit and returns a Guard that exits this depth when dropped

Trait Implementations

impl<'data, R: Debug + Read<'data>> Debug for DepthAwareReader<'data, R>

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

Formats the value using the given formatter.

impl<'data, R: Read<'data>> Read<'data> for DepthAwareReader<'data, R>

Delegate reader impl

fn peek_byte(&mut self) -> ReadResult<u8>

Peek a single byte over the data stream, without advancing it.

fn advance(&mut self, n: usize) -> ReadResult<()>

Manually advances the data stream by n bytes. Usually used in tandem with Self::peek_byte

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

Read a single byte from the data stream

fn read_slice<'a>(&'a mut self, len: usize) -> ReadResult<Cow<'data, [u8]>>

Read a byte slice from the data stream of length len Errors out if n is bigger than the remaining data stream

fn read_array<const N: usize>(&mut self) -> ReadResult<Cow<'data, [u8; N]>>

Read a byte array from the data stream of len N Basically behaves the same as Self::read_slice but with a sized slice

fn read_till_eof(&mut self) -> ReadResult<Cow<'data, [u8]>>

Reads the data stream till EOF