# dashmap
Blazingly fast concurrent map in Rust.
DashMap is an implementation of a concurrent associative array/hashmap in Rust.
DashMap tries to implement an easy to use API similar to `std::collections::HashMap`
with some slight changes to handle concurrency.
DashMap tries to be very simple to use and to be a direct replacement for `RwLock<HashMap<K, V>>`.
To accomplish these all methods take `&self` instead modifying methods taking `&mut self`.
This allows you to put a DashMap in an `Arc<T>` and share it between threads while being able to modify it.
DashMap puts great effort into performance and aims to be as fast as possible.
If you have any suggestions or tips do not hesitate to open an issue or a PR.
[Documentation](https://docs.rs/dashmap)
[](https://crates.io/crates/dashmap)
[](https://crates.io/crates/dashmap)
## Cargo features
- `no_std` - Enable no_std + alloc support.
- `serde` - Enables serde support.
- `raw-api` - Enables the unstable raw-shard api.
## Support
[](https://patreon.com/acrimon)
Creating and testing open-source software like DashMap takes up a large portion of my time
and comes with costs such as test hardware. Please consider supporting me and everything I make for the public
to enable me to continue doing this.
If you want to support me please head over and take a look at my [patreon](https://www.patreon.com/acrimon).
## Contributing
DashMap is gladly accepts contributions!
Do not hesitate to open issues or PR's.
I will take a look as soon as I have time for it.
## Performance
Benchmarks are currently not fantastic and can be improved and more can be created.
Help is welcomed with open arms.
**NOTE:** Benchmarks are currently being revamped for v4; hopefully a bit more scientific this time, stay tuned.
Also, to be brutally honest, do your own benchmarking with your setup.
This is one of infinite possible configations. It doesn't speak for how it will work for you.
### Notes
- cht is very broken and has inconsistency and memory safety issues making it a non-option.
<img src="https://raw.githubusercontent.com/xacrimon/dashmap/master/assets/bench-insert.svg?sanitize=true" alt="Insert Benchmark">
<img src="https://raw.githubusercontent.com/xacrimon/dashmap/master/assets/bench-get.svg?sanitize=true" alt="Get Benchmark">
[Google Doc](https://docs.google.com/spreadsheets/d/1q2VR_rMZRzG7YO0ef6V0jMA6hAdkafh_wI8xvY_51fk/edit?usp=sharing)
## Special thanks
- [Jon Gjengset](https://github.com/jonhoo)
- [Krishna Sannasi](https://github.com/KrishnaSannasi)
- [Karl Bergström](https://github.com/kabergstrom)
- [Dylan DPC](https://github.com/Dylan-DPC)
- [Lokathor](https://github.com/Lokathor)
- [namibj](https://github.com/namibj)
## License
This project is licensed under MIT.