Trait StorageRead

pub trait StorageRead<Type: Mappable>: StorageInspect<Type> + StorageSize<Type> {
    // Required methods
    fn read(
        &self,
        key: &Type::Key,
        offset: usize,
        buf: &mut [u8],
    ) -> Result<bool, Self::Error>;
    fn read_alloc(
        &self,
        key: &Type::Key,
    ) -> Result<Option<Vec<u8>>, Self::Error>;
}

Base storage trait for Fuel infrastructure.

Allows reading the raw bytes of the value stored at a given key into a provided buffer.

This trait should skip any deserialization and simply copy the raw bytes.

Required Methods

fn read( &self, key: &Type::Key, offset: usize, buf: &mut [u8], ) -> Result<bool, Self::Error>

Read the value stored at the given key into the provided buffer if the value exists. Errors if the buffer cannot be filled completely, or if attempting to read past the end of the value.

Does not perform any deserialization.

Returns Ok(true) if the value does exist, and Ok(false) otherwise.

fn read_alloc(&self, key: &Type::Key) -> Result<Option<Vec<u8>>, Self::Error>

Same as read but allocates a new buffer and returns it.

Checks the size of the value and allocates a buffer of that size.

Implementations on Foreign Types

impl<T: StorageRead<Type> + StorageSize<Type> + ?Sized, Type: Mappable> StorageRead<Type> for &T

fn read( &self, key: &<Type as Mappable>::Key, offset: usize, buf: &mut [u8], ) -> Result<bool, Self::Error>

fn read_alloc( &self, key: &<Type as Mappable>::Key, ) -> Result<Option<Vec<u8>>, Self::Error>

impl<T: StorageRead<Type> + StorageSize<Type> + ?Sized, Type: Mappable> StorageRead<Type> for &mut T

fn read( &self, key: &<Type as Mappable>::Key, offset: usize, buf: &mut [u8], ) -> Result<bool, Self::Error>

fn read_alloc( &self, key: &<Type as Mappable>::Key, ) -> Result<Option<Vec<u8>>, Self::Error>

Implementors