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::convert::TryFrom;
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 backtrace(&self) -> Option<&Backtrace>

🔬 This is a nightly-only experimental API. (backtrace #53487)

返回发生错误的栈回溯 (如果有)。

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

impl ExitStatusExt for ExitStatusError

This is supported on Unix only.

fn from_raw(raw: i32) -> Self

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

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

如果进程被一个信号终止，则返回该信号。

fn core_dumped(&self) -> bool

🔬 This is a nightly-only experimental API. (unix_process_wait_more #80695)

如果进程被一个信号终止，说明它是否丢弃了 core。

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

🔬 This is a nightly-only experimental API. (unix_process_wait_more #80695)

如果该进程被信号停止，则返回该信号。

fn continued(&self) -> bool

🔬 This is a nightly-only experimental API. (unix_process_wait_more #80695)

进程是否从停止状态继续。

fn into_raw(self) -> i32

🔬 This is a nightly-only experimental API. (unix_process_wait_more #80695)

返回基础的原始 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: &ExitStatusError) -> bool

此方法测试 !=。

impl Copy for ExitStatusError

impl Eq for ExitStatusError

impl StructuralEq for ExitStatusError

impl StructuralPartialEq for ExitStatusError