Struct cornerstore::CornerStore

pub struct CornerStore(_);

A thread-safe store for perishable items.

Keys and values are untyped byte-streams of arbitrary length

Implementations

impl CornerStore

pub fn new() -> Self

pub fn with_capacity(cap: usize) -> Self

pub fn get(&self, key: &[u8]) -> Result<Option<Vec<u8>>, Box<dyn Error>>

Get an item, but only if it has not expired

pub fn get_key_value(
    &self,
    key: &[u8]
) -> Result<Option<(Vec<u8>, Vec<u8>)>, Box<dyn Error>>

Retrieve a key/value paid, but only if they have not expired

pub fn get_unchecked(
    &self,
    key: &[u8]
) -> Result<Option<Vec<u8>>, Box<dyn Error>>

Retrieve a value, even if it is stale

pub fn get_key_value_unchecked(
    &self,
    key: &[u8]
) -> Result<Option<(Vec<u8>, Vec<u8>)>, Box<dyn Error>>

Retrieve a key/value pair, even if the pair is stale.

pub fn set(
    &mut self,
    key: &[u8],
    val: &[u8],
    expiry: Option<Instant>
) -> Result<(), Box<dyn Error>>

Sets key to value, overwriting any previous value. Providing an optional expiry time treats the key/value pair as perishable.

pub fn update(
    &mut self,
    key: &[u8],
    val: &[u8],
    expiry: Option<Instant>
) -> Result<(), Box<dyn Error>>

pub fn remove(&mut self, key: &[u8]) -> Result<(), Box<dyn Error>>

Removes the key/value pair from the store.

pub fn evict(&mut self) -> Result<(), Box<dyn Error>>

Remove any expired perishable items from the store