Thread-safe clone-on-write container for fast concurrent writing and reading.
SyncCow is a container for concurrent writing and reading of data. It's intended to be a
faster alternative to std::sync::RwLock. Especially scenarios with many concurrent readers
heavily benefit from SyncCow. Reading is guaranteed to
be lock-less and return immediately. Writing is only blocked by other write-accesses, never by
any read-access. A SyncCow with only one writer and arbitrary readers will never block.
As SyncCow stores two copies of it's contained value and read values are handed out as
std::sync::Arc, a program using SyncCow might have a higher memory-footprint compared to
std::sync::RwLock.
Note that readers might read outdated data when using the SyncCow,
as writing and reading concurrently is possible.
If that is indesireable consider std::sync::RwLock.
Please use cargo-edit to always add the latest version of this library:
cargo add sync_cowSee the following examples:
- Simple Read/Write - Simple showcase of
SyncCowfunctions - Thread Read/Write - Sharing a
SyncCowbetween threads usingstd::sync::Arcfor concurrent access
Licensed under the
- MIT license (LICENSE or http://opensource.org/licenses/MIT)
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you shall be licensed as above, without any additional terms or conditions.
sync_cow strictly follows Semantic Versioning 2.0.0
This includes the Rust version requirement specified above.
Earlier Rust versions may be compatible, but this can change with minor or patch releases.
Which versions are affected by features and patches can be determined from the respective headings in CHANGELOG.md.
mooo