Struct CaptureSource 

pub struct CaptureSource<'a, S: 'a> { /* private fields */ }

A source that captures what has been advanced over.

A capture source wraps a mutable reference to some other source and provides the usual source access. However, instead of dropping octets that have been advanced over, it keeps them around and allows taking them out as a bytes value.

This type is used by Constructed::capture.

Implementations

impl<'a, S: Source> CaptureSource<'a, S>

pub fn new(source: &'a mut S) -> Self

Creates a new capture source using a reference to some other source.

pub fn into_bytes(self) -> Bytes

Converts the capture source into the captured bytes.

pub fn skip(self)

Drops the captured bytes.

Advances the underlying source to the end of the captured bytes.

Trait Implementations

impl<'a, S: Source + 'a> Source for CaptureSource<'a, S>

type Error = <S as Source>::Error

The error produced when the source failed to read more data.

fn pos(&self) -> Pos

Returns the current logical postion within the sequence of data.

fn request(&mut self, len: usize) -> Result<usize, Self::Error>

Request at least len bytes to be available.

fn slice(&self) -> &[u8]

Returns a bytes slice with the available data.

fn bytes(&self, start: usize, end: usize) -> Bytes

Produces a Bytes value from part of the data.

fn advance(&mut self, len: usize)

Advance the source by len bytes.

fn skip(&mut self, len: usize) -> Result<usize, Self::Error>

Skip over the next len bytes.

fn take_u8(&mut self) -> Result<u8, DecodeError<Self::Error>>

Takes a single octet from the source.

fn take_opt_u8(&mut self) -> Result<Option<u8>, Self::Error>

Takes an optional octet from the source.

fn content_err(&self, err: impl Into<ContentError>) -> DecodeError<Self::Error>

Returns a content error at the current position of the source.