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 RangeBounds<u64>) -> 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 RangeBounds<u64>, ) -> 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 RangeBounds<u64>, ) -> Result<BufferIterator>

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

pub fn into_std_read(self, range: impl RangeBounds<u64>) -> Result<StdReader>

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

pub fn into_bytes_iterator( self, range: impl RangeBounds<u64>, ) -> 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.