BT编程语言文档

process 进程库

功能

process(program) 创建命令构建器，支持参数、环境变量、工作目录、stdio 配置、同步执行和子进程句柄操作。

API 列表

API说明
process.arg追加一个命令行参数。
process.args批量追加命令行参数。
process.env设置一个子进程环境变量。
process.envs批量设置子进程环境变量。
process.current_dir设置子进程工作目录。
process.stdin设置要写入子进程标准输入的文本。
process.stdin_write设置要写入子进程标准输入的文本。
process.inherit_stdio让子进程继承当前进程 stdio。
process.null_stdio丢弃子进程 stdio。
process.env_clear启动子进程前清空继承环境变量。
process.env_remove从已配置环境变量中删除一个键。
process.get_args读取当前构建器已配置的参数数组。
process.get_current_dir读取当前构建器工作目录配置。
process.get_envs读取当前构建器环境变量配置。
process.get_program读取当前构建器程序路径。
process.status同步执行命令并返回退出码。
process.exit_status同步执行命令并返回退出码。
process.output同步执行命令并返回输出对象。
process.child启动子进程并把句柄保存在当前 Process 对象中。
process.pid读取已启动子进程 PID。
process.kill终止已启动子进程。
process.wait等待已启动子进程退出。
process.try_wait非阻塞检查已启动子进程是否退出。
process.stdout预留的标准输出读取方法。
process.stdout_read预留的标准输出读取方法。
process.stdout_read_lines预留的标准输出按行读取方法。
process.stderr_read预留的标准错误读取方法。
process.stderr_read_lines预留的标准错误按行读取方法。
process.child_running判断当前 Process 对象是否保存子进程句柄。

示例

注意事项

  • 示例以 Windows cmd 为例；Linux/macOS 可使用 sh -c。
  • status、output、wait 会阻塞当前流程，常驻服务中应谨慎使用。