Struct std::process::ExitStatus

pub struct ExitStatus(_);

描述进程终止后的结果。

struct 用于表示子进程的退出状态或其他终止。 子进程是通过 Command 结构体创建的，其退出状态通过 status 方法或 Child 进程的 wait 方法公开。

ExitStatus 表示进程的每一种可能的配置。在 Unix 上，这是等待状态。 不是 仅仅是 exit 状态(传递给 exit 的值)。

为了正确报告失败进程的错误，请使用 Display 的实现打印 ExitStatus 或 ExitStatusError 的值。

Implementations

impl ExitStatus

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

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

终止成功了吗？ 返回 Result。

Examples

#![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

终止成功了吗？ 信号终止不被视为成功，并且成功被定义为零退出状态。

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: {}", status);
}

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

返回进程的退出代码 (如果有)。

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

在 Unix 上，如果进程被信号终止，它将返回 None。 ExitStatusExt 是 trait 的扩展，用于从 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 Clone for ExitStatus

fn clone(&self) -> ExitStatus

返回值的副本。

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

从 source 执行复制分配。

impl Debug for ExitStatus

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

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

impl Display for ExitStatus

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

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

impl ExitStatusExt for ExitStatus

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

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

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

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

fn continued(&self) -> bool

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

fn into_raw(self) -> i32

返回底层的原始 wait 状态。

impl ExitStatusExt for ExitStatus

This is supported on Windows only.

fn from_raw(raw: u32) -> Self

根据进程的原始底层 u32 返回值创建新的 ExitStatus。

impl Into<ExitStatus> for ExitStatusError

fn into(self) -> ExitStatus

执行转换。

impl PartialEq<ExitStatus> for ExitStatus

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

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

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

此方法测试 !=。

impl Copy for ExitStatus

impl Eq for ExitStatus

impl StructuralEq for ExitStatus

impl StructuralPartialEq for ExitStatus