Struct io::ByteReaderWrapper

pub struct ByteReaderWrapper<R: BlockReader>(_);

A wrapper struct that implements a byte-wise reader atop a block-based reader.

This ideally should be realized via automatic trait implementations, in which all types that implement BlockReader also implement ByteReader, but we can’t do that because Rust currently does not support specialization.

Example

Use the From implementation around a BlockReader instance, such as:

// Assume `storage_dev` implements `BlockReader`
let bytes_read = ByteReaderWrapper::from(storage_dev).read_at(...);

Trait Implementations

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

fn block_size(&self) -> usize

Returns the size in bytes of a single block (i.e., sector), the minimum granularity of I/O transfers.

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

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.

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

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

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

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

fn from(block_reader: R) -> Self

Converts to this type from the input type.

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

fn len(&self) -> usize

Returns the length (size in bytes) of this I/O stream or device.