crossbeam_utils::thread

Struct ScopedJoinHandle

source
pub struct ScopedJoinHandle<'scope, T> { /* private fields */ }
Expand description

A handle that can be used to join its scoped thread.

This struct is created by the Scope::spawn method and the ScopedThreadBuilder::spawn method.

Implementations§

source§

impl<T> ScopedJoinHandle<'_, T>

source

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

Waits for the thread to finish and returns its result.

If the child thread panics, an error is returned. Note that if panics are implemented by aborting the process, no error is returned; see the notes of std::panic::catch_unwind.

§Panics

This function may panic on some platforms if a thread attempts to join itself or otherwise may create a deadlock with joining threads.

§Examples
use crossbeam_utils::thread;

thread::scope(|s| {
    let handle1 = s.spawn(|_| println!("I'm a happy thread :)"));
    let handle2 = s.spawn(|_| panic!("I'm a sad thread :("));

    // Join the first thread and verify that it succeeded.
    let res = handle1.join();
    assert!(res.is_ok());

    // Join the second thread and verify that it panicked.
    let res = handle2.join();
    assert!(res.is_err());
}).unwrap();
source

pub fn thread(&self) -> &Thread

Returns a handle to the underlying thread.

§Examples
use crossbeam_utils::thread;

thread::scope(|s| {
    let handle = s.spawn(|_| println!("A child thread is running"));
    println!("The child thread ID: {:?}", handle.thread().id());
}).unwrap();

Trait Implementations§

source§

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

source§

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

Formats the value using the given formatter. Read more
source§

impl<T> JoinHandleExt for ScopedJoinHandle<'_, T>

source§

fn as_pthread_t(&self) -> RawPthread

Extracts the raw pthread_t without taking ownership
source§

fn into_pthread_t(self) -> RawPthread

Consumes the thread, returning the raw pthread_t Read more
source§

impl<T> Send for ScopedJoinHandle<'_, T>

source§

impl<T> Sync for ScopedJoinHandle<'_, T>

Auto Trait Implementations§

§

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

§

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

§

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

§

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

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

source§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.