Struct BufReader 

pub struct BufReader<T> { /* private fields */ }

Wraps an AsyncRead with an internal buffer, amortizing many small .read() calls into fewer, larger reads on the underlying stream.

Implementations

impl<T> BufReader<T>

pub fn new(inner: T) -> Self

Wrap inner with an 8 KiB internal buffer.

pub fn with_capacity(capacity: usize, inner: T) -> Self

Wrap inner with a capacity-byte internal buffer.

pub const fn get_ref(&self) -> &T

Borrow the wrapped stream.

pub fn into_inner(self) -> T

Unwrap back to the underlying stream. Any bytes already buffered but not yet consumed via Self::read are discarded.

impl<T: AsyncRead> BufReader<T>

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

Read into buf, drawing from the internal buffer first and only refilling it (via one .read() on the wrapped stream) once it’s fully drained.

Errors

Returns whatever the wrapped stream’s read returns.