Trait random_access_storage::RandomAccess

pub trait RandomAccess {
    type Error;

    fn write(&mut self, offset: usize, data: &[u8]) -> Result<(), Self::Error>;
    fn read(
        &mut self,
        offset: usize,
        length: usize
    ) -> Result<Vec<u8>, Self::Error>;
    fn read_to_writer(
        &mut self,
        offset: usize,
        length: usize,
        buf: &mut impl Write
    ) -> Result<(), Self::Error>;
    fn del(&mut self, offset: usize, length: usize) -> Result<(), Self::Error>;
    fn truncate(&mut self, length: usize) -> Result<(), Self::Error>;
    fn len(&mut self) -> Result<usize, Self::Error>;
    fn is_empty(&mut self) -> Result<bool, Self::Error>;
}

The RandomAccess trait allows for reading from and writing to a randomly accessible storage of bytes.

Required Associated Types

type Error

An error.

Required Methods

fn write(&mut self, offset: usize, data: &[u8]) -> Result<(), Self::Error>

Write bytes at an offset to the backend.

fn read(&mut self, offset: usize, length: usize) -> Result<Vec<u8>, Self::Error>

Read a sequence of bytes at an offset from the backend.

fn read_to_writer(
    &mut self,
    offset: usize,
    length: usize,
    buf: &mut impl Write
) -> Result<(), Self::Error>

Read a sequence of bytes at an offset from the backend.

fn del(&mut self, offset: usize, length: usize) -> Result<(), Self::Error>

Delete a sequence of bytes at an offset from the backend.

fn truncate(&mut self, length: usize) -> Result<(), Self::Error>

Resize the sequence of bytes, possibly discarding or zero-padding bytes from the end.

fn len(&mut self) -> Result<usize, Self::Error>

Get the size of the storage in bytes.

fn is_empty(&mut self) -> Result<bool, Self::Error>

Whether the storage is empty. For some storage backends it may be cheaper to calculate whether the storage is empty than to calculate the length.

Implementors