Struct secret_cosmwasm_storage::Bucket

pub struct Bucket<'a, S: Storage, T> where
    T: Serialize + DeserializeOwned,  { /* private fields */ }

Implementations

impl<'a, S: Storage, T> Bucket<'a, S, T> where
    T: Serialize + DeserializeOwned, 

pub fn new(namespace: &[u8], storage: &'a mut S) -> Self

pub fn multilevel(namespaces: &[&[u8]], storage: &'a mut S) -> Self

pub fn save(&mut self, key: &[u8], data: &T) -> StdResult<()>

save will serialize the model and store, returns an error on serialization issues

pub fn remove(&mut self, key: &[u8])

pub fn load(&self, key: &[u8]) -> StdResult<T>

load will return an error if no data is set at the given key, or on parse error

pub fn may_load(&self, key: &[u8]) -> StdResult<Option<T>>

may_load will parse the data stored at the key if present, returns Ok(None) if no data there. returns an error on issues parsing

pub fn range<'b>(
    &'b self,
    start: Option<&[u8]>,
    end: Option<&[u8]>,
    order: Order
) -> Box<dyn Iterator<Item = StdResult<KV<T>>> + 'b>

pub fn update<A>(&mut self, key: &[u8], action: A) -> StdResult<T> where
    A: FnOnce(Option<T>) -> StdResult<T>, 

update will load the data, perform the specified action, and store the result in the database. This is shorthand for some common sequences, which may be useful. Note that this only updates pre-existing values. If you want to modify possibly non-existent values, please use may_update

This is the least stable of the APIs, and definitely needs some usage