[automerger skipped] Merge Android 14 QPR3 to AOSP main am: 29340a3b13 -s ours

am skip reason: Merged-In I817e75522d896e5c5b01bac5b5d174b0654dbac1 with SHA-1 7962cffe92 is already in history

Original change: https://android-review.googlesource.com/c/platform/external/rust/crates/fragile/+/3131403

Change-Id: I40c4b46611aeff71366e4ad6fe2db303cdb1f598
Signed-off-by: Automerger Merge Worker <[email protected]>
tree: 287a55864b4a330c7c3895ad87af3d92203d629f
  1. .github/
  2. .vscode/
  3. examples/
  4. src/
  5. .cargo_vcs_info.json
  6. .gitignore
  7. Android.bp
  8. Cargo.toml
  9. cargo_embargo.json
  10. CHANGELOG.md
  11. LICENSE
  12. Makefile
  13. METADATA
  14. MODULE_LICENSE_APACHE2
  15. OWNERS
  16. README.md
README.md

Fragile

Build Status Crates.io License rustc 1.42.0 Documentation

This library provides wrapper types that permit sending non Send types to other threads and use runtime checks to ensure safety.

It provides the Fragile<T>, Sticky<T> and SemiSticky<T> types which are similar in nature but have different behaviors with regards to how destructors are executed. The Fragile<T> will panic if the destructor is called in another thread, Sticky<T> will temporarily leak the object until the thread shuts down. SemiSticky<T> is a compromise of the two. It behaves like Sticky<T> but it avoids the use of thread local storage if the type does not need Drop.

Example

use std::thread;

// creating and using a fragile object in the same thread works
let val = Fragile::new(true);
assert_eq!(*val.get(), true);
assert!(val.try_get().is_ok());

// once send to another thread it stops working
thread::spawn(move || {
    assert!(val.try_get().is_err());
}).join()
    .unwrap();

License and Links