Struct ExitStatus

pub struct ExitStatus(/* private fields */);

Describes the result of a process after it has terminated.

This struct is used to represent the exit status or other termination of a child process. Child processes are created via the Command struct and their exit status is exposed through the status method, or the wait method of a Child process.

An ExitStatus represents every possible disposition of a process. On Unix this is the wait status. It is not simply an exit status (a value passed to exit).

For proper error reporting of failed processes, print the value of ExitStatus or ExitStatusError using their implementations of Display.

Differences from ExitCode

ExitCode is intended for terminating the currently running process, via the Termination trait, in contrast to ExitStatus, which represents the termination of a child process. These APIs are separate due to platform compatibility differences and their expected usage; it is not generally possible to exactly reproduce an ExitStatus from a child for the current process after the fact.

Implementations

impl ExitStatus

pub fn exit_ok(&self) -> Result<(), ExitStatusError>

#![feature(exit_status_error)]
use std::process::Command;

let status = Command::new("ls")
    .arg("/dev/nonexistent")
    .status()
    .expect("ls could not be executed");

println!("ls: {status}");
status.exit_ok().expect_err("/dev/nonexistent could be listed!");

pub fn success(&self) -> bool

use std::process::Command;

let status = Command::new("mkdir")
    .arg("projects")
    .status()
    .expect("failed to execute mkdir");

if status.success() {
    println!("'projects/' directory created");
} else {
    println!("failed to create 'projects/' directory: {status}");
}

pub fn code(&self) -> Option<i32>

use std::process::Command;

let status = Command::new("mkdir")
    .arg("projects")
    .status()
    .expect("failed to execute mkdir");

match status.code() {
    Some(code) => println!("Exited with status code: {code}"),
    None => println!("Process terminated by signal")
}

Trait Implementations

impl Clone for ExitStatus

fn clone(&self) -> ExitStatus

fn clone_from(&mut self, source: &Self)

impl Debug for ExitStatus

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

impl Default for ExitStatusThe default value is one which indicates successful completion.

fn default() -> Self

impl Display for ExitStatus

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

impl ExitStatusExt for ExitStatusAvailable on Unix only.

fn from_raw(raw: i32) -> Self

fn signal(&self) -> Option<i32>

fn core_dumped(&self) -> bool

fn stopped_signal(&self) -> Option<i32>

fn continued(&self) -> bool

fn into_raw(self) -> i32

impl ExitStatusExt for ExitStatusAvailable on Windows only.

fn from_raw(raw: u32) -> Self

impl From<ExitStatusError> for ExitStatus

fn from(error: ExitStatusError) -> Self

impl PartialEq for ExitStatus

fn eq(&self, other: &ExitStatus) -> bool

fn ne(&self, other: &Rhs) -> bool

impl Copy for ExitStatus

impl Eq for ExitStatus

impl StructuralPartialEq for ExitStatus

Auto Trait Implementations

impl Freeze for ExitStatus

impl RefUnwindSafe for ExitStatus

impl Send for ExitStatus

impl Sync for ExitStatus

impl Unpin for ExitStatus

impl UnwindSafe for ExitStatus

Blanket Implementations

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

fn type_id(&self) -> TypeId

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

fn borrow(&self) -> &T

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

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

impl<T> CloneToUninit for Twhere
    T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

impl<T> From<T> for T

fn from(t: T) -> T

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

fn into(self) -> U

impl<T> ToOwned for Twhere
    T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T> ToString for Twhere
    T: Display + ?Sized,

fn to_string(&self) -> String

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

type Error = Infallible

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

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

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

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