Struct std::io::BufReaderUnstable
[-] [+]
[src]
pub struct BufReader<R> { // some fields omitted }
Wraps a Read
and buffers input from it
It can be excessively inefficient to work directly with a Read
instance.
For example, every call to read
on TcpStream
results in a system call.
A BufReader
performs large, infrequent reads on the underlying Read
and maintains an in-memory buffer of the results.
Methods
impl<R: Read> BufReader<R>
fn new(inner: R) -> BufReader<R>
Creates a new BufReader
with a default buffer capacity
fn with_capacity(cap: usize, inner: R) -> BufReader<R>
Creates a new BufReader
with the specified buffer capacity
fn get_ref<'a>(&self) -> &R
Gets a reference to the underlying reader.
fn get_mut(&mut self) -> &mut R
Gets a mutable reference to the underlying reader.
Warning
It is inadvisable to directly read from the underlying reader.
fn into_inner(self) -> R
Unwraps this BufReader
, returning the underlying reader.
Note that any leftover data in the internal buffer is lost.