Trait StorageRead

pub trait StorageRead<Type: Mappable>: StorageInspect<Type> + StorageSize<Type> {
    // Required methods
    fn read(
        &self,
        key: &Type::Key,
        buf: &mut [u8],
    ) -> Result<Option<usize>, 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, buf: &mut [u8], ) -> Result<Option<usize>, Self::Error>

Read the value stored at the given key into the provided buffer if the value exists.

Does not perform any deserialization.

Returns None if the value does not exist. Otherwise, returns the number of bytes read.

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<'a, T: StorageRead<Type> + StorageSize<Type> + ?Sized, Type: Mappable> StorageRead<Type> for &'a T

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

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

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

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

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

Implementors