/
ColdC/Functions/
ColdC/Structure/
<head><title>ColdC: Function/Method Reference: execute()</title></head>

<body>

<h1 align=center><a href="/ColdC/">ColdC</a>: <a href="/ColdC/Functions/">Function/Method Reference</a>: execute()</h1>

<hr>

<p>
<font size=+1><i>INTEGER</i> <b>execute</b>(<i>STRING <b>program</b>, LIST <b>arguments</b>[, INTEGER <b>non_blocking</b>]</i>)</font>

<p>This function executes the executable program named by <var>program</var>
with the arguments given in the list <var>arguments</var>.  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.

<p>This function looks for the script in the executable directory specified
upon startup by the driver.  This usually defaults to <code>bin</code>.

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

<p><hr size=4><p align=center><i>Last Modified on Mar 2 1996</i>
<br><i>Copyright &copy; 1995, 1996, Brandon Gillespie</i>
</body>