Struct SpawnError

pub struct SpawnError { /* private fields */ }

Encapsulates errors of the procspawn crate.

In particular it gives access to remotely captured panics.

Implementations

impl SpawnError

pub fn panic_info(&self) -> Option<&PanicInfo>

If a panic ocurred this returns the captured panic info.

Examples found in repository

examples/panic.rs (line 13)

fn main() {
    procspawn::init();

    let handle = spawn((), |()| {
        panic!("Whatever!");
    });

    match handle.join() {
        Ok(()) => unreachable!(),
        Err(err) => {
            let panic = err.panic_info().expect("got a non panic error");
            println!("process panicked with {}", panic.message());
            println!("{:#?}", panic);
        }
    }
}

examples/pool.rs (line 22)

fn main() {
    procspawn::init();

    let pool = Pool::new(4).unwrap();
    let mut handles = vec![];

    for counter in 0..8 {
        handles.push(procspawn::spawn!(in pool, (counter) || {
            thread::sleep(Duration::from_millis(500));
            counter
        }));
    }

    for handle in handles {
        match handle.join() {
            Ok(val) => println!("got result: {}", val),
            Err(err) => {
                let panic = err.panic_info().expect("got a non panic error");
                println!("process panicked with {}", panic.message());
                println!("{:#?}", panic);
            }
        }
    }

    pool.shutdown();
}

pub fn is_panic(&self) -> bool

True if this error comes from a panic.

pub fn is_cancellation(&self) -> bool

True if this error indicates a cancellation.

pub fn is_timeout(&self) -> bool

True if this error indicates a timeout.

pub fn is_remote_close(&self) -> bool

True if this means the remote side closed.

Trait Implementations

impl Debug for SpawnError

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

Formats the value using the given formatter.

impl Display for SpawnError

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

Formats the value using the given formatter.

impl Error for SpawnError

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

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

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

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

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

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl From<Box<ErrorKind>> for SpawnError

fn from(err: BincodeError) -> SpawnError

Converts to this type from the input type.

impl From<Error> for SpawnError

fn from(err: Error) -> SpawnError

Converts to this type from the input type.

impl From<IpcError> for SpawnError

fn from(err: IpcError) -> SpawnError

Converts to this type from the input type.

impl From<PanicInfo> for SpawnError

fn from(panic: PanicInfo) -> SpawnError

Converts to this type from the input type.

impl From<TryRecvError> for SpawnError

fn from(err: TryRecvError) -> SpawnError

Converts to this type from the input type.