Crate shareable

Source
Expand description

This crate allows the sharing of various data objects via atomic memory operations to avoid the overhead of Mutex whenever possible. The SharedF32, SharedI8, SharedI16, SharedI32, SharedIsize, SharedU8, SharedU16, SharedU32, and SharedUsize objects basically just pass the data to the atomic elements.

The SharedF64, SharedI64 and SharedU64 objects are useful when supporting both 32 and 64 bit environments. Under 64 bit environments they will use the faster atomic data objects to share the values, when compiled under 32 bit they will use the slower mutexes since the atomics only handle 32 bit values.

The SharedObject will share a read only object. Internally it uses a very small spin lock to to insure accurate reference counting but should provide faster access than using a Mutex.

§Examples

use std::sync::mpsc;
use std::thread;
use shareable::SharedObject;

let value1 = SharedObject::new(String::from("abc"));
let value2 = value1.clone();

let (tx, rx) = mpsc::channel();

let thread = thread::spawn(move || {
    rx.recv();
    assert_eq!(value2.get().as_str(), "xyz");
});

value1.set(String::from("xyz"));

tx.send(());
thread.join().unwrap();

Structs§

SharedBool
Shareable boolean data element.
SharedF32
Stores a f32 element inside an atomic element so it can be accessed by multiple threads.
SharedF64
Shareable f64 data element.
SharedI8
Shareable i8 data element.
SharedI16
Shareable i16 data element.
SharedI32
Shareable i32 data element.
SharedI64
Shareable i64 data element.
SharedIsize
Shareable isize data element.
SharedObject
Shareable object data element.
SharedU8
Shareable u8 data element.
SharedU16
Shareable u16 data element.
SharedU32
Shareable u32 data element.
SharedU64
Shareable u64 data element.
SharedUsize
Shareable usize data element.