jorendorff / atomicbox

Safe atomic Box types for Rust

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

atomicbox

Safe atomic boxes.

Documentation Build Status

This crate provides AtomicBox<T> and AtomicOptionBox<T> types: safe, owning versions of the standard library's AtomicPtr.

Unfortunately, the only operations you can perform on an atomic box are swaps and stores: you can't just use the box without taking ownership of it. Imagine a Box without Deref or DerefMut implementations, and you'll get the idea. Still, this is sufficient for some lock-free data structures, so here it is!

Why no Deref?

It wouldn't be safe. The point of an AtomicBox is that other threads can obtain the boxed value, take ownership of it, even drop it, all without taking a lock. So there is no safe way to borrow that value—except to swap it out of the AtomicBox yourself.

This is pretty much the same reason you can't borrow a reference to the contents of any other atomic type. It would invite data races. The only difference here is that those contents happen to be on the heap.

License: MIT/Apache-2.0

About

Safe atomic Box types for Rust

License:Other


Languages

Language:Rust 100.0%