Struct throttled_reader::ThrottledReader
source · pub struct ThrottledReader<R> { /* private fields */ }
Expand description
ThrottleReader
proxies an io::Read
, but enforces a budget on how many read
calls can be
made to the underlying reader.
Implementations
sourceimpl<R> ThrottledReader<R>
impl<R> ThrottledReader<R>
sourcepub fn new(reader: R) -> Self
pub fn new(reader: R) -> Self
Construct a new throttler that wraps the given reader.
The new ThrottledReader
initially has no limit.
sourcepub fn set_limit(&mut self, limit: usize)
pub fn set_limit(&mut self, limit: usize)
Set the number of read
calls allowed to the underlying reader.
sourcepub fn unthrottle(&mut self)
pub fn unthrottle(&mut self)
Remove the limit on how many read
calls can be issued to the underlying reader.
sourcepub fn remaining(&self) -> Option<usize>
pub fn remaining(&self) -> Option<usize>
Check how many more read
calls may be issued to the underlying reader.
Returns None
if the reader is not currently throttled.
sourcepub fn into_inner(self) -> R
pub fn into_inner(self) -> R
Extract the underlying reader.
Trait Implementations
sourceimpl<R: Debug> Debug for ThrottledReader<R>
impl<R: Debug> Debug for ThrottledReader<R>
sourceimpl<R> Default for ThrottledReader<R>where
R: Default,
impl<R> Default for ThrottledReader<R>where
R: Default,
sourceimpl<R> Deref for ThrottledReader<R>
impl<R> Deref for ThrottledReader<R>
sourceimpl<R> DerefMut for ThrottledReader<R>
impl<R> DerefMut for ThrottledReader<R>
sourceimpl<R> From<R> for ThrottledReader<R>
impl<R> From<R> for ThrottledReader<R>
sourceimpl<R: Hash> Hash for ThrottledReader<R>
impl<R: Hash> Hash for ThrottledReader<R>
sourceimpl<R: Ord> Ord for ThrottledReader<R>
impl<R: Ord> Ord for ThrottledReader<R>
sourcefn cmp(&self, other: &ThrottledReader<R>) -> Ordering
fn cmp(&self, other: &ThrottledReader<R>) -> Ordering
1.21.0 · sourcefn max(self, other: Self) -> Selfwhere
Self: Sized,
fn max(self, other: Self) -> Selfwhere
Self: Sized,
Compares and returns the maximum of two values. Read more
1.21.0 · sourcefn min(self, other: Self) -> Selfwhere
Self: Sized,
fn min(self, other: Self) -> Selfwhere
Self: Sized,
Compares and returns the minimum of two values. Read more
1.50.0 · sourcefn clamp(self, min: Self, max: Self) -> Selfwhere
Self: Sized + PartialOrd<Self>,
fn clamp(self, min: Self, max: Self) -> Selfwhere
Self: Sized + PartialOrd<Self>,
Restrict a value to a certain interval. Read more
sourceimpl<R: PartialEq> PartialEq<ThrottledReader<R>> for ThrottledReader<R>
impl<R: PartialEq> PartialEq<ThrottledReader<R>> for ThrottledReader<R>
sourcefn eq(&self, other: &ThrottledReader<R>) -> bool
fn eq(&self, other: &ThrottledReader<R>) -> bool
sourceimpl<R: PartialOrd> PartialOrd<ThrottledReader<R>> for ThrottledReader<R>
impl<R: PartialOrd> PartialOrd<ThrottledReader<R>> for ThrottledReader<R>
sourcefn partial_cmp(&self, other: &ThrottledReader<R>) -> Option<Ordering>
fn partial_cmp(&self, other: &ThrottledReader<R>) -> Option<Ordering>
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for
self
and other
) and is used by the <=
operator. Read moresourceimpl<R> Read for ThrottledReader<R>where
R: Read,
impl<R> Read for ThrottledReader<R>where
R: Read,
sourcefn read(&mut self, buf: &mut [u8]) -> Result<usize>
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. Read more
1.36.0 · sourcefn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>
fn read_vectored(&mut self, bufs: &mut [IoSliceMut<'_>]) -> Result<usize, Error>
Like
read
, except that it reads into a slice of buffers. Read moresourcefn is_read_vectored(&self) -> bool
fn is_read_vectored(&self) -> bool
🔬This is a nightly-only experimental API. (
can_vector
)1.0.0 · sourcefn read_to_end(&mut self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>
fn read_to_end(&mut self, buf: &mut Vec<u8, Global>) -> Result<usize, Error>
Read all bytes until EOF in this source, placing them into
buf
. Read more1.0.0 · sourcefn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
Read all bytes until EOF in this source, appending them to
buf
. Read more1.6.0 · sourcefn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
Read the exact number of bytes required to fill
buf
. Read moresourcefn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>
fn read_buf(&mut self, buf: BorrowedCursor<'_>) -> Result<(), Error>
🔬This is a nightly-only experimental API. (
read_buf
)Pull some bytes from this source into the specified buffer. Read more
sourcefn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>
fn read_buf_exact(&mut self, cursor: BorrowedCursor<'_>) -> Result<(), Error>
🔬This is a nightly-only experimental API. (
read_buf
)Read the exact number of bytes required to fill
cursor
. Read more1.0.0 · sourcefn by_ref(&mut self) -> &mut Selfwhere
Self: Sized,
fn by_ref(&mut self) -> &mut Selfwhere
Self: Sized,
Creates a “by reference” adaptor for this instance of
Read
. Read moreimpl<R: Eq> Eq for ThrottledReader<R>
impl<R> StructuralEq for ThrottledReader<R>
impl<R> StructuralPartialEq for ThrottledReader<R>
Auto Trait Implementations
impl<R> RefUnwindSafe for ThrottledReader<R>where
R: RefUnwindSafe,
impl<R> Send for ThrottledReader<R>where
R: Send,
impl<R> Sync for ThrottledReader<R>where
R: Sync,
impl<R> Unpin for ThrottledReader<R>where
R: Unpin,
impl<R> UnwindSafe for ThrottledReader<R>where
R: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more