A safe, strongly typed (generic) atomic pointer abstraction to build
datastructures, and lock-free algorithms on top of. Only uses
libstd.
The standard library contains an AtomicPtr type, which by itself
isn't very ergonomic to use, because it deals with raw pointers. This
library assumes that types can always be heap allocated, wrapping them
in a Box<T>, and provides a nicer (and safe!) abstraction for
std::sync::atomic::AtomicPtr. Using this crate is fairely
self-explanatory:
```rust use atomptr::AtomPtr;
struct MyData { name: String } let data = MyData { name: "Kookie".into() };
let a = AtomPtr::new(data); println!("Name is: {}", a.get_ref().name);
let oldref = a.swap(MyData { name: "Bob".into() }); println!("Name now is: {}, was {}", a.getref().name, old_ref.name); ```
Note that the type that is returned by get_ref and swap is
Ref<T>, which means that the old data is not de-allocated after a
swap, before this last reference goes out of scope. You can of course
always manually call drop() on it.
This micro-library is free software, and licensed under the GNU General Public License, version 3.0 or (at your choice), any later version.
Additional Permissions: For Submission to the Apple App Store: Provided that you are otherwise in compliance with the GPLv3 for each covered work you convey (including without limitation making the Corresponding Source available in compliance with Section 6 of the GPLv3), the qaul.net developers also grant you the additional permission to convey through the Apple App Store non-source executable versions of the Program as incorporated into each applicable covered work as Executable Versions only under the Mozilla Public License version 2.0.
A copy of both the GPL-3.0 and MPL-2.0 license texts are included in this repository.