Struct iowrap::ShortRead
[−]
[src]
pub struct ShortRead<R: Read, I: Iterator<Item = usize>> { /* fields omitted */ }
Intentionally return short reads, to test Read
code.
The decider
iterator gets to decide how short a read should be.
Currently, no effort is made to make reads longer, if the underlying
reader naturally returns short reads.
It's expected that the sum of the iterator is longer than the reader: the behaviour otherwise hasn't yet been decided.
Example
let mut naughty = iowrap::ShortRead::new( io::Cursor::new(b"1234567890"), vec![2, 3, 4, 5, 6].into_iter() ); let mut buf = [0u8; 10]; // A `Cursor` would normally return the whole ten bytes here, // but we've limited it to two bytes. assert_eq!(2, naughty.read(&mut buf).unwrap());
Methods
impl<R: Read, I: Iterator<Item = usize>> ShortRead<R, I>
[src]
fn new(inner: R, decider: I) -> Self
[src]
fn into_inner(self) -> R
[src]
Trait Implementations
impl<R: Read, I: Iterator<Item = usize>> Read for ShortRead<R, I>
[src]
fn read(&mut self, buf: &mut [u8]) -> Result<usize>
[src]
Pull some bytes from this source into the specified buffer, returning how many bytes were read. Read more
unsafe fn initializer(&self) -> Initializer
[src]
read_initializer
)Determines if this Read
er can work with buffers of uninitialized memory. Read more
fn read_to_end(&mut self, buf: &mut Vec<u8>) -> Result<usize, Error>
1.0.0[src]
Read all bytes until EOF in this source, placing them into buf
. Read more
fn read_to_string(&mut self, buf: &mut String) -> Result<usize, Error>
1.0.0[src]
Read all bytes until EOF in this source, placing them into buf
. Read more
fn read_exact(&mut self, buf: &mut [u8]) -> Result<(), Error>
1.6.0[src]
Read the exact number of bytes required to fill buf
. Read more
fn by_ref(&mut self) -> &mut Self
1.0.0[src]
Creates a "by reference" adaptor for this instance of Read
. Read more
fn bytes(self) -> Bytes<Self>
1.0.0[src]
Transforms this Read
instance to an [Iterator
] over its bytes. Read more
fn chars(self) -> Chars<Self>
[src]
🔬 This is a nightly-only experimental API. (io
)
the semantics of a partial read/write of where errors happen is currently unclear and may change
Transforms this Read
instance to an [Iterator
] over [char
]s. Read more
fn chain<R>(self, next: R) -> Chain<Self, R> where
R: Read,
1.0.0[src]
R: Read,
Creates an adaptor which will chain this stream with another. Read more
fn take(self, limit: u64) -> Take<Self>
1.0.0[src]
Creates an adaptor which will read at most limit
bytes from it. Read more