Struct std::process::ExitCode

pub struct ExitCode(_);

该类型表示当前进程在正常终止下可以返回其父进程的状态码。

ExitCode 旨在仅由标准库 (通过 Termination::report()) 使用，并且有意不提供 PartialEq、Eq 或 Hash 等访问器。 相反，标准库提供了规范的 SUCCESS 和 FAILURE 退出代码以及用于构造其他任意退出代码的 From<u8> for ExitCode。

Portability

此类型中使用的数字值没有可移植的含义，并且不同的平台可能会掩盖不同数量的含义。

有关平台的规范成功和失败代码，请参见 SUCCESS 和 FAILURE 关联项。

与 ExitStatus 的区别

ExitCode 旨在通过 Termination trait 终止当前正在运行的进程，而 ExitStatus 则表示终止子进程。 由于平台兼容性差异及其预期用途，这些 API 是分开的; 事后通常不可能从子节点那里准确地复制当前进程的 ExitStatus。

Examples

ExitCode 可以从 crate 的 main 函数返回，因为它实现了 Termination:

use std::process::ExitCode;

fn main() -> ExitCode {
    if !check_foo() {
        return ExitCode::from(42);
    }

    ExitCode::SUCCESS
}

Implementations

impl ExitCode

pub const SUCCESS: ExitCode = _

在此平台上成功终止的规范 ExitCode。

请注意，返回 main 的 () 隐式导致成功终止，因此除非您还返回了其他可能的代码，否则无需从 main 返回此值。

pub const FAILURE: ExitCode = _

此平台上未成功终止的规范 ExitCode。

如果仅从 main 返回此代码和 SUCCESS，则考虑分别返回 Err(_) 和 Ok(())，这将返回相同的代码 (但也会返回 eprintln! 错误)。

pub fn exit_process(self) -> !

🔬This is a nightly-only experimental API. (exitcode_exit_method #97100)

使用给定的 ExitCode 退出当前进程。

请注意，这与 process::exit() 具有相同的注意事项，即此函数立即终止进程，因此当前栈或任何其他线程栈上的析构函数都不会运行。 如果需要彻底关闭，建议简单地从 main 函数返回此 ExitCode，如 类型文档 中所示。

与 process::exit() 的区别

process::exit() 接受任何 i32 值作为进程的退出代码; 但是，有些平台只使用该值的一个子集 (参见 process::exit platform-specific behavior)。

ExitCode 就是因为这个而存在的; 只能创建我们大多数平台支持的 ExitCode，因此使用此方法不存在 (尽可能多) 这些问题。

Examples

#![feature(exitcode_exit_method)]
// 没有办法优雅地从 UhOhError 中恢复，所以我们只打印一条消息并退出
fn handle_unrecoverable_error(err: UhOhError) -> ! {
    eprintln!("UH OH! {err}");
    let code = match err {
        UhOhError::GenericProblem => ExitCode::FAILURE,
        UhOhError::Specific => ExitCode::from(3),
        UhOhError::WithCode { exit_code, .. } => exit_code,
    };
    code.exit_process()
}

Trait Implementations

impl Clone for ExitCode

fn clone(&self) -> ExitCode

返回值的副本。

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

从 source 执行复制分配。

impl Debug for ExitCode

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

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

impl ExitCodeExt for ExitCode

Available on Windows only.

fn from_raw(raw: u32) -> Self

🔬This is a nightly-only experimental API. (windows_process_exit_code_from)

从进程的原始，底层 u32 返回值创建一个新的 ExitCode。

impl From<u8> for ExitCode

fn from(code: u8) -> Self

从任意 u8 值构造 ExitCode。

impl Termination for ExitCode

fn report(self) -> ExitCode

被调用以获取值的表示形式作为状态码。 此状态代码返回到操作系统。

impl Copy for ExitCode