Struct ContextJoinHandle

pub struct ContextJoinHandle<'scope, T> { /* private fields */ }

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

This struct is created by the Context::spawn method and the [ContextJoinHandle::spawn] method.

Implementations

impl<T> ContextJoinHandle<'_, T>

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.

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 ctx_thread::scope;

scope(|ctx| {
    let handle1 = ctx.spawn(|_| println!("I'm a happy thread :)"));
    let handle2 = ctx.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();

pub fn thread(&self) -> &Thread

Returns a handle to the underlying thread.

Trait Implementations

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

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

Formats the value using the given formatter.

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

fn as_pthread_t(&self) -> RawPthread

Extracts the raw pthread_t without taking ownership

fn into_pthread_t(self) -> RawPthread

Consumes the thread, returning the raw pthread_t

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

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