Struct std::thread::ScopedJoinHandle

pub struct ScopedJoinHandle<'scope, T>(_);

在作用域线程上加入的拥有权限 (在其终止时阻塞)。

有关详细信息，请参见 Scope::spawn。

Implementations

impl<'scope, T> ScopedJoinHandle<'scope, T>

pub fn thread(&self) -> &Thread

提取底层线程的句柄。

Examples

use std::thread;

thread::scope(|s| {
    let t = s.spawn(|| {
        println!("hello");
    });
    println!("thread id: {:?}", t.thread().id());
});

pub fn join(self) -> Result<T>

等待关联的线程完成。

如果关联的线程已经完成，这个函数将立即返回。

在 原子内存排序 方面，相关线程的完成与这个函数的返回同步。

换句话说，该线程执行的所有操作 happen before 所有在join返回后发生的操作。

如果关联的线程出现 panic，将返回一个带有 panic 载荷的 Err。

Examples

use std::thread;

thread::scope(|s| {
    let t = s.spawn(|| {
        panic!("oh no");
    });
    assert!(t.join().is_err());
});

pub fn is_finished(&self) -> bool

检查关联线程是否已完成其 main 函数的运行。

is_finished 支持实现非阻塞连接操作，通过检查 is_finished，如果返回 false 则调用 join。 该函数不会阻止。 要在等待线程完成时阻塞，请使用 join。

这可能在线程的 main 函数返回之后，但在线程本身停止运行之前短暂返回 true。 但是，一旦返回 true，可以预期 join 会快速返回，而不会被阻塞很长时间。

Trait Implementations

impl<'scope, T> Debug for ScopedJoinHandle<'scope, T>

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

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