Struct std::process::ExitStatusError
source · pub struct ExitStatusError(/* private fields */);exit_status_error #84908)Expand description
Describes the result of a process after it has failed
Produced by the .exit_ok method on ExitStatus.
§Examples
#![feature(exit_status_error)]
use std::process::{Command, ExitStatusError};
fn run(cmd: &str) -> Result<(),ExitStatusError> {
Command::new(cmd).status().unwrap().exit_ok()?;
Ok(())
}
run("true").unwrap();
run("false").unwrap_err();RunImplementations§
source§impl ExitStatusError
impl ExitStatusError
sourcepub fn code(&self) -> Option<i32>
🔬This is a nightly-only experimental API. (exit_status_error #84908)
pub fn code(&self) -> Option<i32>
exit_status_error #84908)Reports the exit code, if applicable, from an ExitStatusError.
In Unix terms the return value is the exit status: the value passed to exit, if the
process finished by calling exit. Note that on Unix the exit status is truncated to 8
bits, and that values that didn’t come from a program’s call to exit may be invented by the
runtime system (often, for example, 255, 254, 127 or 126).
On Unix, this will return None if the process was terminated by a signal. If you want to
handle such situations specially, consider using methods from
ExitStatusExt.
If the process finished by calling exit with a nonzero value, this will return
that exit status.
If the error was something else, it will return None.
If the process exited successfully (ie, by calling exit(0)), there is no
ExitStatusError. So the return value from ExitStatusError::code() is always nonzero.
§Examples
#![feature(exit_status_error)]
use std::process::Command;
let bad = Command::new("false").status().unwrap().exit_ok().unwrap_err();
assert_eq!(bad.code(), Some(1));Runsourcepub fn code_nonzero(&self) -> Option<NonZeroI32>
🔬This is a nightly-only experimental API. (exit_status_error #84908)
pub fn code_nonzero(&self) -> Option<NonZeroI32>
exit_status_error #84908)Reports the exit code, if applicable, from an ExitStatusError, as a NonZero
This is exactly like code(), except that it returns a NonZeroI32.
Plain code, returning a plain integer, is provided because it is often more convenient.
The returned value from code() is indeed also nonzero; use code_nonzero() when you want
a type-level guarantee of nonzeroness.
§Examples
#![feature(exit_status_error)]
use std::num::NonZeroI32;
use std::process::Command;
let bad = Command::new("false").status().unwrap().exit_ok().unwrap_err();
assert_eq!(bad.code_nonzero().unwrap(), NonZeroI32::try_from(1).unwrap());Runsourcepub fn into_status(&self) -> ExitStatus
🔬This is a nightly-only experimental API. (exit_status_error #84908)
pub fn into_status(&self) -> ExitStatus
exit_status_error #84908)Converts an ExitStatusError (back) to an ExitStatus.
Trait Implementations§
source§impl Clone for ExitStatusError
impl Clone for ExitStatusError
source§fn clone(&self) -> ExitStatusError
fn clone(&self) -> ExitStatusError
1.0.0 · source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
source. Read moresource§impl Debug for ExitStatusError
impl Debug for ExitStatusError
source§impl Display for ExitStatusError
impl Display for ExitStatusError
source§impl Error for ExitStatusError
impl Error for ExitStatusError
1.30.0 · source§fn source(&self) -> Option<&(dyn Error + 'static)>
fn source(&self) -> Option<&(dyn Error + 'static)>
1.0.0 · source§fn description(&self) -> &str
fn description(&self) -> &str
source§impl ExitStatusExt for ExitStatusError
Available on Unix only.
impl ExitStatusExt for ExitStatusError
source§fn from_raw(raw: i32) -> Self
fn from_raw(raw: i32) -> Self
ExitStatus or ExitStatusError from the raw underlying integer status
value from wait Read moresource§fn signal(&self) -> Option<i32>
fn signal(&self) -> Option<i32>
source§fn core_dumped(&self) -> bool
fn core_dumped(&self) -> bool
source§fn stopped_signal(&self) -> Option<i32>
fn stopped_signal(&self) -> Option<i32>
source§impl From<ExitStatusError> for ExitStatus
impl From<ExitStatusError> for ExitStatus
source§fn from(error: ExitStatusError) -> Self
fn from(error: ExitStatusError) -> Self
source§impl PartialEq for ExitStatusError
impl PartialEq for ExitStatusError
source§fn eq(&self, other: &ExitStatusError) -> bool
fn eq(&self, other: &ExitStatusError) -> bool
self and other values to be equal, and is used
by ==.