Struct ccl::dhashmap::DHashMap

pub struct DHashMap<K, V> where
    K: Hash + Eq,  { /* fields omitted */ }

DHashMap is a threadsafe concurrent hashmap with good allround performance and is tuned for both reads and writes.

The API mostly matches that of the standard library hashmap but there are some differences to due to the design of the hashmap.

Due to design limitations you cannot iterate over the map normally. Please use one of the below iterator functions to iterate over contained submaps and then iterate over those.

map.tables_read().for_each(|s| s.iter().for_each(|(k, v)| myfn(k, v)));

Methods

impl<'a, K: 'a, V: 'a> DHashMap<K, V> where
    K: Hash + Eq, 

pub fn new() -> Self

Create a new DHashMap. Doesn't allocate space for elements until it starts filling up.

pub fn with_nonce(hash_nonce: u64) -> Self

Create a new DHashMap with a specified nonce. Not recommended.

pub fn insert(&self, key: K, value: V)

Insert an element into the map.

pub fn contains_key(&self, key: &K) -> bool

Check if the map contains the specified key.

pub fn get(&'a self, key: &'a K) -> Option<DHashMapRef<'a, K, V>>

Get a shared reference to an element contained within the map.

pub fn get_mut(&'a self, key: &'a K) -> Option<DHashMapRefMut<'a, K, V>>

Get a unique reference to an element contained within the map.

pub fn remove(&self, key: &K) -> Option<(K, V)>

Remove an element from the map if it exists. Will return the K, V pair.

pub fn retain<F: Clone + FnMut(&K, &mut V) -> bool>(&self, f: F)

Retain all elements that the specified function returns true for.

pub fn clear(&self)

Clear all elements from the map.

pub fn tables_read(&self) -> impl Iterator<Item = SMRInterface<K, V>>

Iterate over submaps in a read only fashion.

pub fn tables_write(&self) -> impl Iterator<Item = SMRWInterface<K, V>>

Iterate over submaps in a read-write fashion.

pub fn determine_map(&self, key: &K) -> usize

Trait Implementations

impl<K: Default, V: Default> Default for DHashMap<K, V> where
    K: Hash + Eq, 

fn default() -> DHashMap<K, V>

Returns the "default value" for a type.