std.process

功能介绍

process 包主要提供 Process 进程操作接口，主要包括进程创建，标准流获取，进程等待，进程信息查询等。

本包提供多平台统一操控能力，目前支持 Linux 平台，macOS 平台与 Windows 平台。

API 列表

函数

函数名	功能
execute	根据输入参数创建并运行一个子进程，等待该子进程运行完毕并返回子进程退出状态。
executeWithOutput	根据输入参数创建并运行一个子进程，等待该子进程运行完毕并返回子进程退出状态、标准输出和标准错误。
findProcess	根据输入进程 id 绑定一个进程实例。
launch	根据输入参数创建并运行一个子进程，并返回一个子进程实例。

类

类名	功能
CurrentProcess ^(deprecated)	此类为当前进程类，继承 `Process` 类，提供对当前进程操作相关功能。
Process	此类为进程类，提供进程操作相关功能。
SubProcess	此类为子进程类，继承 `Process` 类，提供对子进程操作相关功能。

枚举

枚举名	功能
ProcessRedirect	用于在创建进程时设置子进程标准流的重定向模式。

异常类

异常类名	功能
ProcessException	`process` 包的异常类。

兼容性说明

class Process

成员	支持平台
current ^(deprecated)	`Linux` `Windows` `macOS`
pid	`Linux` `Windows` `macOS`
name	`Linux` `Windows` `macOS`
command	`Linux` `Windows` `macOS`
arguments ^(deprecated)	`Linux` `macOS`
commandLine ^(deprecated)	`Linux` `macOS`
environment ^(deprecated)	`Linux`
workingDirectory ^(deprecated)	`Linux` `macOS`
of(Int64) ^(deprecated)	`Linux` `Windows` `macOS`
start(String, Array<String>, Path, Map<String, String>, ProcessRedirect, ProcessRedirect, ProcessRedirect) ^(deprecated)	`Linux` `Windows` `macOS`
run(String, Array<String>, Path, Map<String, String>, ProcessRedirect, ProcessRedirect, ProcessRedirect, Duration) ^(deprecated)	`Linux` `Windows` `macOS`
runOutput(String, Array<String>, Path, Map<String, String>, ProcessRedirect, ProcessRedirect, ProcessRedirect) ^(deprecated)	`Linux` `Windows` `macOS`
terminate(Bool)	`Linux` `Windows` `macOS`

class CurrentProcss ^(deprecated)

注意：

未来版本即将废弃，可在 std.env 中找到代替功能。

成员	支持平台
arguments	`Linux` `Windows` `macOS`
homeDirectory	`Linux` `Windows` `macOS`
tempDirectory	`Linux` `Windows` `macOS`
stdIn	`Linux` `Windows` `macOS`
stdOut	`Linux` `Windows` `macOS`
stdErr	`Linux` `Windows` `macOS`
atExit(() -> Unit)	`Linux` `Windows` `macOS`
exit(Int64)	`Linux` `Windows` `macOS`
getEnv(String)	`Linux` `Windows` `macOS`
removeEnv(String)	`Linux` `Windows` `macOS`
setEnv(String, String)	`Linux` `Windows` `macOS`

class SubProcess

成员	支持平台
stdIn ^(deprecated)	`Linux` `Windows` `macOS`
stdInPipe	`Linux` `Windows` `macOS`
stdOut ^(deprecated)	`Linux` `Windows` `macOS`
stdOutPipe	`Linux` `Windows` `macOS`
stdErr ^(deprecated)	`Linux` `Windows` `macOS`
stdErrPipe	`Linux` `Windows` `macOS`
wait(Duration)	`Linux` `Windows` `macOS`
waitOutput()	`Linux` `Windows` `macOS`