Struct std::process::ExitStatusError

pub struct ExitStatusError(_);

🔬This is a nightly-only experimental API. (exit_status_error #84908)

描述进程失败后的结果

通过 ExitStatus 上的 .exit_ok 方法生成。

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();

Implementations

impl ExitStatusError

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

🔬This is a nightly-only experimental API. (exit_status_error #84908)

从 ExitStatusError 报告退出代码 (如果适用)。

用 Unix 的术语来说，返回值是退出状态：如果进程通过调用 exit 完成，则传递给 exit 的值。 请注意，在 Unix 上，退出状态被截断为 8 位，并且不是来自程序调用到 exit 的值可能是由运行时系统发明的 (通常，例如，255、254、127 或 126)。

在 Unix 上，如果进程被信号终止，它将返回 None。 如果您想专门处理这种情况，请考虑使用 ExitStatusExt 中的方法。

如果进程通过使用非零值调用 exit 完成，这将返回该退出状态。

如果错误是其他原因，它将返回 None。

如果进程成功退出 (即通过调用 exit(0))，则没有 ExitStatusError。所以 ExitStatusError::code() 的返回值总是非零。

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

pub fn code_nonzero(&self) -> Option<NonZeroI32>

🔬This is a nightly-only experimental API. (exit_status_error #84908)

将 ExitStatusError 的退出代码 (如果适用) 报告为 NonZero

这与 code() 完全一样，只是它返回一个 NonZeroI32。

提供普通 code，返回一个普通整数，因为它通常更方便。 code() 的返回值确实也是非零的； 当您想要非零的类型级别保证时，请使用 code_nonzero()。

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());

pub fn into_status(&self) -> ExitStatus

🔬This is a nightly-only experimental API. (exit_status_error #84908)

将 ExitStatusError (back) 转换为 ExitStatus。

Trait Implementations

impl Clone for ExitStatusError

fn clone(&self) -> ExitStatusError

返回值的副本。

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

从 source 执行复制分配。

impl Debug for ExitStatusError

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

使用给定的格式化程序格式化该值。

impl Display for ExitStatusError

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

使用给定的格式化程序格式化该值。

impl Error for ExitStatusError

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

此错误的下级来源 (如果有)。

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, demand: &mut Demand<'a>)

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

提供对用于错误报告的上下文的基于类型的访问。

impl ExitStatusExt for ExitStatusError

Available on Unix only.

fn from_raw(raw: i32) -> Self

从 wait 的原始底层整数状态值创建一个新的 ExitStatus 或 ExitStatusError

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

返回底层的原始 wait 状态。

impl Into<ExitStatus> for ExitStatusError

fn into(self) -> ExitStatus

将此类型转换为 (通常是推断的) 输入类型。

impl PartialEq<ExitStatusError> for ExitStatusError

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

此方法测试 self 和 other 值是否相等，并由 == 使用。

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

此方法测试 !=。 默认实现几乎总是足够的，并且不应在没有充分理由的情况下被覆盖。

impl Copy for ExitStatusError

impl Eq for ExitStatusError

impl StructuralEq for ExitStatusError

impl StructuralPartialEq for ExitStatusError