run() Netscript Function¶
-
run
(script[, numThreads=1[, args...]])¶ RAM cost: 1 GB
Arguments: - script (string) – Filename of script to run
- numThreads (number) – Optional thread count for new script. Set to 1 by default. Will be rounded to nearest integer.
- args... – Additional arguments to pass into the new script that is being run. Note
that if any arguments are being passed into the new script, then the
second argument
numThreads
must be filled in with a value.
Returns: The process id of the new process or 0 on failure.
Run a script as a separate process. This function can only be used to run scripts located on the current server (the server running the script that calls this function).
Warning
Running this function with a
numThreads
argument of 0 or less will cause a runtime error.The simplest way to use the run command is to call it with just the script name. The following example will run
foo.script
single-threaded with no arguments:run("foo.script");
The following example will run ‘foo.script’ but with 5 threads instead of single-threaded:
run("foo.script", 5);
This next example will run
foo.script
single-threaded, and will pass the stringfoodnstuff
into the script as an argument:run("foo.script", 1, 'foodnstuff');