bitburner-src/markdown/bitburner.ns.run.md
omuretsu 06a985bdf8 Revert "Remove markdown from git tracking (#139)"
This reverts commit bbb6e3f309935aebac74ddb1fbeec12dfb7540b1.
2022-10-21 11:16:00 -04:00

71 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!-- Do not edit this file. It is automatically generated by API Documenter. -->
[Home](./index.md) &gt; [bitburner](./bitburner.md) &gt; [NS](./bitburner.ns.md) &gt; [run](./bitburner.ns.run.md)
## NS.run() method
Start another script on the current server.
<b>Signature:</b>
```typescript
run(script: string, numThreads?: number, ...args: (string | number | boolean)[]): number;
```
## Parameters
| Parameter | Type | Description |
| --- | --- | --- |
| 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 | (string \| number \| boolean)\[\] | 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. |
<b>Returns:</b>
number
Returns the PID of a successfully started script, and 0 otherwise.
## Remarks
RAM cost: 1 GB
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). Requires a significant amount of RAM to run this command.
If the script was successfully started, then this functions returns the PID of that script. Otherwise, it returns 0.
PID stands for Process ID. The PID is a unique identifier for each script. The PID will always be a positive integer.
Running this function with a numThreads argument of 0 or less will cause a runtime error.
## Example 1
```ts
// NS1:
//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 string foodnstuff into the script as an argument:
run("foo.script", 1, 'foodnstuff');
```
## Example 2
```ts
// NS2:
//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:
ns.run("foo.script");
//The following example will run foo.script but with 5 threads instead of single-threaded:
ns.run("foo.script", 5);
//This next example will run foo.script single-threaded, and will pass the string foodnstuff into the script as an argument:
ns.run("foo.script", 1, 'foodnstuff');
```