Trait Read

pub trait Read: Stream {
    // Required method
    fn read(&mut self, buf: &mut [u8]) -> Result<usize>;

    // Provided methods
    fn chain<R>(self, next: R) -> Chain<Self, R> 
       where Self: Sized,
             R: Read { ... }
    fn buffer(self) -> BufReader<Self>
       where Self: Sized { ... }
    fn repeat(self) -> Repeat<Self> 
       where Self: Sized { ... }
}

Alternative to std::io::Read

This trait is automatically implemented for all types that implement std::io::Read.

Diffrerences to std::io::Read

Methods that are just wrappers around the equivalent methods of std::io::Read:

• read
• chain

New methods that have no counterpart in std::io::Read:

• buffer
• repeat

Functions that were removed or moved to a different place, because they cannot be implemented with providing all desired guarantees:

• read_to_end → BufRead::read_to_end
• read_to_string → Utf8Reader::read_to_string
• read_exact → BufRead::read_exact
• bytes → BufRead::bytes
• chars → Utf8Reader::chars

Required Methods

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.

This methode is equivalent to std::io::Read::read.

Provided Methods

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

where Self: Sized, R: Read,

Creates an adaptor which will chain this stream with another.

This method is equivalent to std::io::Read::chain.

fn buffer(self) -> BufReader<Self>

where Self: Sized,

Creates a buffered reader with default capacity and default strategies

Please see the documentation of BufReader for more details

fn repeat(self) -> Repeat<Self>

where Self: Sized,

Transforms this reader into a reader that automatically restarts from the beginning after EOF is reached

Implementations on Foreign Types

impl Read for File

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

impl Read for Stdin

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

impl Read for Empty

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

impl Read for Repeat

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

impl Read for TcpStream

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

impl Read for UnixStream

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

impl Read for ChildStderr

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

impl Read for ChildStdout

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

impl<'a> Read for &'a File

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

impl<'a> Read for &'a TcpStream

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

impl<'a> Read for &'a UnixStream

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

impl<'a> Read for &'a [u8]

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

impl<'a> Read for StdinLock<'a>

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

impl<'a, R: Read + ?Sized> Read for &'a mut R

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

impl<R, Rs, Ms> Read for BufReader<R, Rs, Ms>

where R: Read, Rs: ReadStrategy, Ms: MoveStrategy,

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

impl<R: Read> Read for BufReader<R>

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

impl<R: Read + ?Sized> Read for Box<R>

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

impl<T> Read for Cursor<T>

where T: AsRef<[u8]>,

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

impl<T: Read> Read for Take<T>

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

impl<T: Read, U: Read> Read for Chain<T, U>

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

Implementors

impl<I: Read + Seek> Read for netio::Repeat<I>

impl<I: Read> Read for Retry<I>

impl<R: Read> Read for Compat<R>

impl<R: Read> Read for Throttled<R>

impl<R: Read> Read for Collect<R>

impl<T: Read> Read for Limited<T>

impl<T: Read> Read for netio::Take<T>

impl<T: Read, U: Read> Read for netio::Chain<T, U>