2 unstable releases
0.1.0 | Jun 2, 2022 |
---|---|
0.0.1 | Jun 2, 2022 |
#892 in Concurrency
8KB
154 lines
syncell
Just a Sync
alternative to std::cell::RefCell
. Useful when you have a value to share between tasks/closures,
and you already know or guarantee that the access to the value is safe (for example, via choir task dependencies).
The cost of borrowing is a single atomic operation, and it's riguriously checked by both Loom and Miri.
Motivation
Rust already has tools for sharing values between threads, but it strikes me that they are all rather involved and complicated:
Shareable mutable containers exist to permit mutability in a controlled manner, even in the presence of aliasing. Both
Cell<T>
andRefCell<T>
allow doing this in a single-threaded way. However, neitherCell<T>
norRefCell<T>
are thread safe (they do not implementSync
). If you need to do aliasing and mutation between multiple threads it is possible to useMutex<T>
,RwLock<T>
or atomic types.
This paragraph from std::cell documentation proposes to use lock-based primitives as an alternative in Sync
world. But what if you just need sharing without locking, and still want safety? SynCell
comes to help.
Dependencies
~0–26MB
~328K SLoC