Crates.io | diplomatic-bag |
lib.rs | diplomatic-bag |
version | 0.3.1 |
source | src |
created_at | 2021-02-13 16:56:06.318693 |
updated_at | 2022-05-17 18:56:25.486809 |
description | A wrapper type that allows you to send `!Send` types to different threads. |
homepage | |
repository | https://github.com/Skepfyr/DiplomaticBag |
max_upload_size | |
id | 354781 |
size | 45,726 |
Hide !Send
and !Sync
types inside a DiplomaticBag
which can be sent between thread freely.
let one = DiplomaticBag::new(|| Rc::new(RefCell::new(1)));
let two = DiplomaticBag::new(|| Rc::new(RefCell::new(2)));
let three: u8 = std::thread::spawn(|| {
one.as_ref()
.zip(two.as_ref())
.map(|(one, two)| *one.borrow() + *two.borrow())
.into_inner()
}).join()?;
(I don't know why you'd want to do this ^, but I promise this comes in handy for !Send
types not in std, for example, cpal's Stream
type.)
All the operations on values inside DiplomaticBags
are sent to a worker thread (the home country 😉).
This means the values are only ever read on one thread, allowing the DiplomaticBag
to be Send
even if the type it contains is not.
This model does have some drawbacks, see the docs for more information.
Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.