mbarc-map

Crates.iombarc-map
lib.rsmbarc-map
version0.10.0
sourcesrc
created_at2024-03-10 03:39:40.322085
updated_at2024-10-15 07:21:52.17509
descriptionImplementation of a Minimally-blocking, Atomic Reference Counted Map
homepage
repositoryhttps://github.com/gentlecolts/mbarc-map
max_upload_size
id1168281
size51,289
Jack Phoebus (gentlecolts)

documentation

README

mbarc-map

Minimally-blocking, Atomic Reference Counted Map

Crates.io MIT licensed

API Docs

The motivation of the map implemented in this crate is to provide a map that is better suited towards concurrent use. This crate attempts to solve two problems:

  • Need to be able to refer to map elements without keeping the map itself locked
  • Data stored within the map should be stored in a way that is as cache-friendly as possible for efficient iteration

Individually, these aren't huge asks, but achieving both of these properties while satisfying rust ended up being complex enough to be worth wrapping, thus leading to the creation of MbarcMap. You can kind of think of MbarcMap<T,U> as a shorthand for: Mutex<HashMap<T,Arc<Mutex<U>>>>, however there's more to it than that, especially in regards to pointer safety (stored values are never moved), memory layout (data is stored in continuous blocks), and iterators (safe to alter the map while iterating over it)

Commit count: 18

cargo fmt