Trait StorageRead

pub trait StorageRead<Type>: StorageInspect<Type> + StorageSize<Type>
where
    Type: Mappable,
{
    // Required methods
    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>;
}

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 as Mappable>::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 as Mappable>::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 StorageRead<BlobData> for EmptyStorage

fn read( &self, _: &BlobId, _: &mut [u8], ) -> Result<Option<usize>, <EmptyStorage as StorageInspect<BlobData>>::Error>

fn read_alloc( &self, _: &BlobId, ) -> Result<Option<Vec<u8>>, <EmptyStorage as StorageInspect<BlobData>>::Error>

impl<'a, T, Type> StorageRead<Type> for &'a T

where T: StorageRead<Type> + StorageSize<Type> + ?Sized, Type: Mappable,

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

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

impl<'a, T, Type> StorageRead<Type> for &'a mut T

where T: StorageRead<Type> + StorageSize<Type> + ?Sized, Type: Mappable,

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

fn read_alloc( &self, key: &<Type as Mappable>::Key, ) -> Result<Option<Vec<u8>>, <&'a mut T as StorageInspect<Type>>::Error>

impl<D> StorageRead<BlobData> for PredicateStorage<D>

where D: PredicateStorageRequirements,

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

fn read_alloc( &self, key: &<BlobData as Mappable>::Key, ) -> Result<Option<Vec<u8>>, <PredicateStorage<D> as StorageInspect<BlobData>>::Error>

impl<D> StorageRead<ContractsRawCode> for PredicateStorage<D>

fn read( &self, _key: &<ContractsRawCode as Mappable>::Key, _buf: &mut [u8], ) -> Result<Option<usize>, <PredicateStorage<D> as StorageInspect<ContractsRawCode>>::Error>

fn read_alloc( &self, _key: &<ContractsRawCode as Mappable>::Key, ) -> Result<Option<Vec<u8>>, <PredicateStorage<D> as StorageInspect<ContractsRawCode>>::Error>

impl<D> StorageRead<ContractsState> for PredicateStorage<D>

fn read( &self, _key: &<ContractsState as Mappable>::Key, _buf: &mut [u8], ) -> Result<Option<usize>, <PredicateStorage<D> as StorageInspect<ContractsState>>::Error>

fn read_alloc( &self, _key: &<ContractsState as Mappable>::Key, ) -> Result<Option<Vec<u8>>, <PredicateStorage<D> as StorageInspect<ContractsState>>::Error>

Implementors

impl<Column, S, M> StorageRead<M> for StructuredStorage<S>

where S: KeyValueInspect<Column = Column>, M: Mappable + TableWithBlueprint<Column = Column, Value = [u8]>, M::Blueprint: BlueprintInspect<M, StructuredStorage<S>, ValueCodec = Raw>,

impl<D, M: Mappable> StorageRead<M> for VmStorage<D>

where D: StorageRead<M, Error = Error>,