std::sync::PoisonError - Rust (original) (raw)
Struct std::sync::PoisonError1.0.0 [−] [src]
pub struct PoisonError { /* fields omitted */ }
A type of error which can be returned whenever a lock is acquired.
Both Mutexes and RwLocks are poisoned whenever a thread fails while the lock is held. The precise semantics for when a lock is poisoned is documented on each lock, but once a lock is poisoned then all future acquisitions will return this error.
use std::sync::{Arc, Mutex}; use std::thread;
let mutex = Arc::new(Mutex::new(1));
let c_mutex = mutex.clone(); let _ = thread::spawn(move || { let mut data = c_mutex.lock().unwrap(); *data = 2; panic!(); }).join();
match mutex.lock() { Ok(_) => unreachable!(), Err(p_err) => { let data = p_err.get_ref(); println!("recovered: {}", data); } };Run
impl<T> [PoisonError](../../std/sync/struct.PoisonError.html "struct std::sync::PoisonError")<T>[src]
pub fn [new](#method.new)(guard: T) -> [PoisonError](../../std/sync/struct.PoisonError.html "struct std::sync::PoisonError")<T>
1.2.0
pub fn [into_inner](#method.into%5Finner)(self) -> T
1.2.0
Consumes this error indicating that a lock is poisoned, returning the underlying guard to allow access regardless.
use std::collections::HashSet; use std::sync::{Arc, Mutex}; use std::thread;
let mutex = Arc::new(Mutex::new(HashSet::new()));
let c_mutex = mutex.clone(); let _ = thread::spawn(move || { let mut data = c_mutex.lock().unwrap(); data.insert(10); panic!(); }).join();
let p_err = mutex.lock().unwrap_err(); let data = p_err.into_inner(); println!("recovered {} items", data.len());Run
pub fn [get_ref](#method.get%5Fref)(&self) -> [&](../primitive.reference.html)T
1.2.0
Reaches into this error indicating that a lock is poisoned, returning a reference to the underlying guard to allow access regardless.
pub fn [get_mut](#method.get%5Fmut)(&mut self) -> [&mut ](../primitive.reference.html)T
1.2.0
Reaches into this error indicating that a lock is poisoned, returning a mutable reference to the underlying guard to allow access regardless.