Struct Reader 

pub struct Reader { /* private fields */ }

Available on crate feature blocking only.

BlockingReader is designed to read data from given path in an blocking manner.

Implementations

impl Reader

pub fn read(&self, range: impl Into<BytesRange>) -> Result<Buffer>

Read give range from reader into Buffer.

This operation is zero-copy, which means it keeps the bytes::Bytes returned by underlying storage services without any extra copy or intensive memory allocations.

Notes

• Buffer length smaller than range means we have reached the end of file.

pub fn read_into( &self, buf: &mut impl BufMut, range: impl Into<BytesRange>, ) -> Result<usize>

This operation will copy and write bytes into given BufMut. Allocation happens while BufMut doesn’t have enough space.

Notes

• Returning length smaller than range means we have reached the end of file.

pub fn into_iterator( self, range: impl Into<BytesRange>, ) -> Result<BufferIterator>

Create a buffer iterator to read specific range from given reader.

pub fn into_std_read(self, range: impl Into<BytesRange>) -> Result<StdReader>

Convert reader into StdReader which implements futures::AsyncRead, futures::AsyncSeek and futures::AsyncBufRead.

pub fn into_bytes_iterator( self, range: impl Into<BytesRange>, ) -> Result<StdBytesIterator>

Convert reader into StdBytesIterator which implements Iterator.

Trait Implementations

impl Clone for Reader

fn clone(&self) -> Reader

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Drop for Reader

Make sure the inner reader is dropped in async context.

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.