ColdC: Function/Method Reference: execute()

INTEGER execute(STRING program, LIST arguments[, INTEGER non_blocking])

This function executes the executable program named by program with the arguments given in the list arguments. Each argument must be a string. By default, calling this function will block execution of genesis until the called program returns. If the optional third argument is specified as a true value, the program is forked and executed in a non-blocking manner. The return value is the return value of the program, or, in the case of a non-blocking execution it is zero.

This function looks for the script in the executable directory specified upon startup by the driver. This usually defaults to bin.

In the future input and output for the program may be handled as if it were a file.