Struct AtomicMap 

pub struct AtomicMap<K, V>(/* private fields */);

A lock-free concurrent map optimized for read-heavy access patterns.

Reads are a single atomic pointer load with no contention between readers. Writes clone the inner map, mutate the clone, and atomically swap it in.

Not safe for concurrent writers using load/store: the last store wins and earlier updates are silently lost. Use rcu when multiple writers may race, or restrict writes to a single task.

Wrap in Arc for shared ownership across threads.

Implementations

impl<K, V> AtomicMap<K, V>

pub fn new() -> Self

Creates a new empty atomic map.

pub fn load(&self) -> Guard<Arc<AHashMap<K, V>>>

Returns a snapshot guard for direct access to the inner map.

The guard dereferences to AHashMap<K, V>. Use for operations that need a reference into the map (e.g., load().get(&key)).

pub fn store(&self, map: AHashMap<K, V>)

Atomically replaces the inner map.

impl<K, V> AtomicMap<K, V>

where K: Eq + Hash + Clone, V: Clone,

pub fn rcu<F>(&self, f: F)

where F: FnMut(&mut AHashMap<K, V>),

Atomically applies f to a clone of the inner map.

Retries if another writer swapped the map between the clone and the compare-and-swap, so f may run more than once.

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

Returns true if the map contains the given key.

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

Returns a clone of the value for the given key, if present.

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

Inserts a key-value pair (clone-and-swap).

pub fn remove(&self, key: &K)

Removes a key (clone-and-swap).

pub fn len(&self) -> usize

Returns the number of entries.

pub fn is_empty(&self) -> bool

Returns true if the map is empty.

Trait Implementations

impl<K: Debug + Eq + Hash, V: Debug> Debug for AtomicMap<K, V>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<K, V> Default for AtomicMap<K, V>

fn default() -> Self

Returns the “default value” for a type.

impl<K: Eq + Hash, V> From<AHashMap<K, V>> for AtomicMap<K, V>

fn from(map: AHashMap<K, V>) -> Self

Converts to this type from the input type.