type

Process

src class Process : Obj

Process manages spawning external OS processes.

constructors

make

Construct a Process instance used to launch an external OS process with the specified command arguments.

fields

command

Command argument list used to launch process.

dir

Working directory of process.

err

The output stream used to sink the process stderr.

in

The input stream used to source the process stdin.

mergeErr

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

out

The output stream used to sink the process stdout.

methods

env

Environment variables to pass to new process as a mutable map of string key/value pairs.

join

Wait for this process to exit and return the exit code.

kill

Kill this process.

run

Spawn this process.

Slot Details

command

src Str[] command

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

dir

src File? dir

Working directory of process.

env

src 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

src 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

src 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

src Int join()

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

kill

src This kill()

Kill this process. Returns this.

make

src new make(Str[] cmd := Str[,], File? dir := null)

Construct a Process instance 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

src 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

src 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.

run

src This run()

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