Struct sp_runtime::offchain::storage::StorageValueRef

pub struct StorageValueRef<'a> { /* fields omitted */ }

An abstraction over local storage value.

Implementations

impl<'a> StorageValueRef<'a>

pub fn persistent(key: &'a [u8]) -> Self

Create a new reference to a value in the persistent local storage.

pub fn local(key: &'a [u8]) -> Self

Create a new reference to a value in the fork-aware local storage.

pub fn set(&self, value: &impl Encode)

Set the value of the storage to encoding of given parameter.

Note that the storage may be accessed by workers running concurrently, if you happen to write a get-check-set pattern you should most likely be using mutate instead.

pub fn clear(&mut self)

Remove the associated value from the storage.

pub fn get<T: Decode>(&self) -> Option<Option<T>>

Retrieve & decode the value from storage.

Note that if you want to do some checks based on the value and write changes after that you should rather be using mutate.

The function returns None if the value was not found in storage, otherwise a decoding of the value to requested type.

pub fn mutate<T, E, F>(&self, f: F) -> Result<Result<T, T>, E> where
    T: Codec,
    F: FnOnce(Option<Option<T>>) -> Result<T, E>, 

Retrieve & decode the value and set it to a new one atomically.

Function f should return a new value that we should attempt to write to storage. This function returns:

1. Ok(Ok(T)) in case the value has been successfully set.
2. Ok(Err(T)) in case the value was calculated by the passed closure f, but it could not be stored.
3. Err(_) in case f returns an error.