Trait io::BlockReader

pub trait BlockReader: BlockIo {
    fn read_blocks(
        &mut self,
        buffer: &mut [u8],
        block_offset: usize
    ) -> Result<usize, IoError>;
}

A trait that represents an I/O stream (e.g., an I/O device) that can be read from in blocks. The block size specifies the minimum granularity of each transfer, as given by the BlockIo::block_size() function.

A BlockReader is not aware of the current block offset into the stream; thus, each read operation requires a starting offset: the number of blocks from the beginning of the I/O stream at which the read should start.

Required Methods

fn read_blocks(
    &mut self,
    buffer: &mut [u8],
    block_offset: usize
) -> Result<usize, IoError>

Reads blocks of data from this reader into the given buffer.

The number of blocks read is dictated by the length of the given buffer.

Arguments

• buffer: the buffer into which data will be read. The length of this buffer must be a multiple of the block size.
• block_offset: the offset in number of blocks from the beginning of this reader.

Return

If successful, returns the number of blocks read into the given buffer. Otherwise, returns an error.

Implementations on Foreign Types

impl<R> BlockReader for Box<R>where
    R: BlockReader + ?Sized,

fn read_blocks(
    &mut self,
    buffer: &mut [u8],
    block_offset: usize
) -> Result<usize, IoError>

impl<R> BlockReader for &mut Rwhere
    R: BlockReader + ?Sized,

fn read_blocks(
    &mut self,
    buffer: &mut [u8],
    block_offset: usize
) -> Result<usize, IoError>

Implementors

impl<'io, IO, L, B> BlockReader for &LockableIo<'io, IO, L, B>where
    IO: BlockReader + 'io + ?Sized,
    L: for<'a> Lockable<'a, IO> + ?Sized,
    B: Borrow<L>,

impl<'io, IO, L, B> BlockReader for LockableIo<'io, IO, L, B>where
    IO: BlockReader + 'io + ?Sized,
    L: for<'a> Lockable<'a, IO> + ?Sized,
    B: Borrow<L>,

impl<IO> BlockReader for Reader<IO>where
    IO: BlockReader,

impl<IO> BlockReader for ReaderWriter<IO>where
    IO: BlockReader,

impl<R> BlockReader for ByteReaderWrapper<R>where
    R: BlockReader,

impl<RW> BlockReader for ByteReaderWriterWrapper<RW>where
    RW: BlockReader + BlockWriter,