Struct std::process::ExitStatus

pub struct ExitStatus(_);

Describes the result of a process after it has terminated.

This struct is used to represent the exit status 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.

Methods

impl ExitStatus

pub fn success(&self) -> bool

Was termination successful? Signal termination is not considered a success, and success is defined as a zero exit status.

Examples

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");
}

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

Returns the exit code of the process, if any.

On Unix, this will return None if the process was terminated by a signal; std::os::unix provides an extension trait for extracting the signal and other details from the ExitStatus.

Examples

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 ExitStatusExt for ExitStatus

fn from_raw(raw: u32) -> Self

This is supported on Windows only.

Creates a new ExitStatus from the raw underlying u32 return value of a process.

impl ExitStatusExt for ExitStatus

fn from_raw(raw: i32) -> Self

This is supported on Unix only.

Creates a new ExitStatus from the raw underlying i32 return value of a process.

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

This is supported on Unix only.

If the process was terminated by a signal, returns that signal.

impl PartialEq<ExitStatus> for ExitStatus

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Eq for ExitStatus

impl Debug for ExitStatus

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

Formats the value using the given formatter.

impl Display for ExitStatus

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

Formats the value using the given formatter.

impl Copy for ExitStatus

impl Clone for ExitStatus

fn clone(&self) -> ExitStatus

Returns a copy of the value.

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

Performs copy-assignment from source.