Struct Empty 

#[non_exhaustive]
pub struct Empty;

Empty ignores any data written via Write, and will always be empty (returning zero bytes) when read via Read.

This struct is generally created by calling empty(). Please see the documentation of empty() for more details.

Trait Implementations

impl BufRead for Empty

fn fill_buf(&mut self) -> Result<&[u8]>

Returns the contents of the internal buffer, filling it with more data, via Read methods, if empty.

fn consume(&mut self, _n: usize)

Marks the given amount of additional bytes from the internal buffer as having been read. Subsequent calls to read only return bytes that have not been marked as read.

fn has_data_left(&mut self) -> Result<bool>

Checks if there is any data left to be read.

fn skip_until(&mut self, _byte: u8) -> Result<usize>

Skips all bytes until the delimiter byte or EOF is reached.

impl Clone for Empty

fn clone(&self) -> Empty

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Empty

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

Formats the value using the given formatter.

impl Default for Empty

fn default() -> Empty

Returns the “default value” for a type.

impl IoBuf for Empty

fn remaining(&self) -> usize

Returns the number of bytes between the current position and the end of the buffer.

fn is_empty(&self) -> bool

Returns true if there are no remaining bytes in the buffer.

impl IoBufMut for Empty

fn remaining_mut(&self) -> usize

Returns the number of bytes that can be written from the current position until the end of the buffer is reached.

fn is_full(&self) -> bool

Returns true if there is no remaining space in the buffer.

impl Read for Empty

fn read(&mut self, _buf: &mut [u8]) -> Result<usize>

Pull some bytes from this source into the specified buffer, returning how many bytes were read.

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

Read the exact number of bytes required to fill buf.

fn read_buf(&mut self, _cursor: BorrowedCursor<'_>) -> Result<()>

Pull some bytes from this source into the specified buffer.

fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<()>

Reads the exact number of bytes required to fill cursor.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Read.

fn chain<R: Read>(self, next: R) -> Chain<Self, R>

where Self: Sized,

Creates an adapter which will chain this stream with another.

fn take(self, limit: u64) -> Take<Self>

where Self: Sized,

Creates an adapter which will read at most limit bytes from it.

impl Seek for Empty

fn seek(&mut self, _pos: SeekFrom) -> Result<u64>

Seek to an offset, in bytes, in a stream.

fn stream_len(&mut self) -> Result<u64>

Returns the length of this stream (in bytes).

fn stream_position(&mut self) -> Result<u64>

Returns the current seek position from the start of the stream.

fn rewind(&mut self) -> Result<()>

Rewind to the beginning of a stream.

fn seek_relative(&mut self, offset: i64) -> Result<()>

Seeks relative to the current position.

impl Write for &Empty

fn write(&mut self, buf: &[u8]) -> Result<usize>

Write a buffer into this writer, returning how many bytes were written.

fn write_all(&mut self, _buf: &[u8]) -> Result<()>

Attempts to write an entire buffer into this writer.

fn write_fmt(&mut self, _args: Arguments<'_>) -> Result<()>

Writes a formatted string into this writer, returning any error encountered.

fn flush(&mut self) -> Result<()>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.

impl Write for Empty

fn write(&mut self, buf: &[u8]) -> Result<usize>

Write a buffer into this writer, returning how many bytes were written.

fn write_all(&mut self, _buf: &[u8]) -> Result<()>

Attempts to write an entire buffer into this writer.

fn write_fmt(&mut self, _args: Arguments<'_>) -> Result<()>

Writes a formatted string into this writer, returning any error encountered.

fn flush(&mut self) -> Result<()>

Flush this output stream, ensuring that all intermediately buffered contents reach their destination.

fn by_ref(&mut self) -> &mut Self

where Self: Sized,

Creates a “by reference” adapter for this instance of Write.

impl Copy for Empty