bitburner-src/doc/source/netscript/netscriptscriptarguments.rst
2023-01-07 11:03:43 +02:00

36 lines
1.1 KiB
ReStructuredText

.. _netscript_script_arguments:
Netscript Script Arguments
==========================
Arguments passed into a script can be accessed in Netscript using a
special array called ``args``. The arguments can be accessed using a
normal array using the ``[]`` operator (``args[0]``, ``args[1]``, etc...).
These arguments can be string, number, or boolean.
For example, let's say we want to make a generic script
``generic-run.script`` and we plan to pass two arguments into that script.
The first argument will be the name of another script, and the second
argument will be a number. This generic script will run the
script specified in the first argument with the amount of threads
specified in the second argument. The code would look like:
.. code:: javascript
run(args[0], args[1]);
And it could be ran from the terminal like:
``run generic-run.script myscript.script 7``
In .js / ns2, the above script would look like:
.. code:: javascript
export async function main(ns) {
ns.run(ns.args[0], ns.args[1]);
}
It is also possible to get the number of arguments that were passed
into a script using ``args.length``.