Struct std::sync::PoisonError

pub struct PoisonError<T> { /* private fields */ }

一种错误类型，每当获取锁时都可以返回该错误。

每当持有锁的线程发生故障时，Mutex 和 RwLock 都会中毒。 锁中毒的确切语义记录在每个锁上，但是一旦锁中毒，则所有 future 获取都将返回此错误。

Examples

use std::sync::{Arc, Mutex};
use std::thread;

let mutex = Arc::new(Mutex::new(1));

// 互斥锁中毒
let c_mutex = Arc::clone(&mutex);
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}");
    }
};

Implementations

impl<T> PoisonError<T>

pub fn new(guard: T) -> PoisonError<T>

创建一个 PoisonError。

这通常是由 Mutex::lock 或 RwLock::read 之类的方法创建的。

pub fn into_inner(self) -> T

消耗这个错误指示锁已中毒，无论如何都将返回底层防护以允许访问。

Examples

use std::collections::HashSet;
use std::sync::{Arc, Mutex};
use std::thread;

let mutex = Arc::new(Mutex::new(HashSet::new()));

// 互斥锁中毒
let c_mutex = Arc::clone(&mutex);
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());

pub fn get_ref(&self) -> &T

到达此错误时就表示锁已中毒，返回对底层保护的引用以允许访问。

pub fn get_mut(&mut self) -> &mut T

到达此错误时就表示锁已中毒，返回对底层保护的可变引用以允许访问。

Trait Implementations

impl<T> Debug for PoisonError<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

使用给定的格式化程序格式化该值。

impl<T> Display for PoisonError<T>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

使用给定的格式化程序格式化该值。

impl<T> Error for PoisonError<T>

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn source(&self) -> Option<&(dyn Error + 'static)>

此错误的下级来源 (如果有)。

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, demand: &mut Demand<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access #99301)

提供对用于错误报告的上下文的基于类型的访问。

impl<T> From<PoisonError<T>> for TryLockError<T>

fn from(err: PoisonError<T>) -> TryLockError<T>

从输入类型转换为此类型。