class std::Process

sys::Obj
  std::Process

Process manages spawning external OS processes.

command

List<Str> command

Command argument list used to launch process. The first item is the executable itself, then rest are the parameters.

dir

File? dir

Working directory of process.

env

Map<Str,Str> env()

Environment variables to pass to new process as a mutable map of string key/value pairs. This map is initialized with the current process environment.

err

OutStream? err := Env.cur().err

The output stream used to sink the process stderr. Default is to send to Env.err. If set to null, then output is silently consumed like /dev/null. Note this field is ignored if mergeErr is set true, in which case stderr goes to the stream configured via out.

in

InStream? in := null

The input stream used to source the process stdin. If null, then the new process will block if it attempts to read stdin. Default is null.

join

Int join()

Wait for this process to exit and return the exit code. This method may only be called once after run.

kill

This kill()

Kill this process. Returns this.

make

new make(List<Str> cmd := Str[,], File? dir := null)

Construct a Process instanced used to launch an external OS process with the specified command arguments. The first item in the cmd list is the executable itself, then rest are the parameters.

mergeErr

Bool mergeErr := true

If true, then stderr is redirected to the output stream configured via the out field, and the err field is ignored. The default is true.

out

OutStream? out := Env.cur().out

The output stream used to sink the process stdout. Default is to send to Env.out. If set to null, then output is silently consumed like /dev/null.

outToIn

OutStream outToIn()

Returns the output stream connected to the normal input of the subprocess

run

This run()

Spawn this process. See join to wait until the process finished and to get the exit code. Return this.