Struct cw_storage_plus::SnapshotMap
source · [−]pub struct SnapshotMap<'a, K, T> { /* private fields */ }
Expand description
Map that maintains a snapshots of one or more checkpoints. We can query historical data as well as current state. What data is snapshotted depends on the Strategy.
Implementations
sourceimpl<'a, K, T> SnapshotMap<'a, K, T>
impl<'a, K, T> SnapshotMap<'a, K, T>
sourceimpl<'a, K, T> SnapshotMap<'a, K, T> where
T: Serialize + DeserializeOwned + Clone,
K: PrimaryKey<'a> + Prefixer<'a>,
impl<'a, K, T> SnapshotMap<'a, K, T> where
T: Serialize + DeserializeOwned + Clone,
K: PrimaryKey<'a> + Prefixer<'a>,
sourceimpl<'a, K, T> SnapshotMap<'a, K, T> where
T: Serialize + DeserializeOwned + Clone,
K: PrimaryKey<'a> + Prefixer<'a>,
impl<'a, K, T> SnapshotMap<'a, K, T> where
T: Serialize + DeserializeOwned + Clone,
K: PrimaryKey<'a> + Prefixer<'a>,
pub fn key(&self, k: K) -> Path<T>
pub fn prefix(&self, p: K::Prefix) -> Prefix<T>
pub fn sub_prefix(&self, p: K::SubPrefix) -> Prefix<T>
pub fn save(
&self,
store: &mut dyn Storage,
k: K,
data: &T,
height: u64
) -> StdResult<()>
pub fn remove(
&self,
store: &mut dyn Storage,
k: K,
height: u64
) -> StdResult<()>
sourcepub fn load(&self, store: &dyn Storage, k: K) -> StdResult<T>
pub fn load(&self, store: &dyn Storage, k: K) -> StdResult<T>
load will return an error if no data is set at the given key, or on parse error
sourcepub fn may_load(&self, store: &dyn Storage, k: K) -> StdResult<Option<T>>
pub fn may_load(&self, store: &dyn Storage, k: K) -> 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 may_load_at_height(
&self,
store: &dyn Storage,
k: K,
height: u64
) -> StdResult<Option<T>>
pub fn assert_checkpointed(
&self,
store: &dyn Storage,
height: u64
) -> StdResult<()>
sourcepub fn update<A, E>(
&self,
store: &mut dyn Storage,
k: K,
height: u64,
action: A
) -> Result<T, E> where
A: FnOnce(Option<T>) -> Result<T, E>,
E: From<StdError>,
pub fn update<A, E>(
&self,
store: &mut dyn Storage,
k: K,
height: u64,
action: A
) -> Result<T, E> where
A: FnOnce(Option<T>) -> Result<T, E>,
E: From<StdError>,
Loads the data, perform the specified action, and store the result in the database. This is shorthand for some common sequences, which may be useful.
If the data exists, action(Some(value))
is called. Otherwise action(None)
is called.
This is a bit more customized than needed to only read “old” value 1 time, not 2 per naive approach
sourceimpl<'a, K, T> SnapshotMap<'a, K, T> where
T: Serialize + DeserializeOwned + Clone,
K: PrimaryKey<'a> + Prefixer<'a>,
K::SubPrefix: EmptyPrefix,
impl<'a, K, T> SnapshotMap<'a, K, T> where
T: Serialize + DeserializeOwned + Clone,
K: PrimaryKey<'a> + Prefixer<'a>,
K::SubPrefix: EmptyPrefix,
Auto Trait Implementations
impl<'a, K, T> RefUnwindSafe for SnapshotMap<'a, K, T> where
K: RefUnwindSafe,
T: RefUnwindSafe,
impl<'a, K, T> Send for SnapshotMap<'a, K, T> where
K: Send,
T: Send,
impl<'a, K, T> Sync for SnapshotMap<'a, K, T> where
K: Sync,
T: Sync,
impl<'a, K, T> Unpin for SnapshotMap<'a, K, T> where
K: Unpin,
T: Unpin,
impl<'a, K, T> UnwindSafe for SnapshotMap<'a, K, T> where
K: UnwindSafe,
T: UnwindSafe,
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more