bitburner-src/markdown/bitburner.ns.args.md

36 lines
971 B
Markdown
Raw Normal View History

<!-- 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; [args](./bitburner.ns.args.md)
## NS.args property
Arguments passed into the script.
**Signature:**
```typescript
readonly args: (string | number | boolean)[];
```
## Remarks
RAM cost: 0 GB
2022-11-24 14:19:51 +01:00
Arguments passed into a script can be accessed as a normal array by using the `[]` operator (`args[0]`<!-- -->, `args[1]`<!-- -->, etc...). Arguments can be string, number, or boolean. Use `args.length` to get the number of arguments that were passed into a script.
## Example
2022-11-24 14:19:51 +01:00
`run example.js 7 text true`
```js
// example.js
2022-11-24 14:19:51 +01:00
export async function main(ns) {
ns.tprint(ns.args.length) // 3
ns.tprint(ns.args[0]); // 7 (number)
ns.tprint(ns.args[1]); // "text" (string)
ns.tprint(ns.args[2]); // true (boolean)
ns.tprint(ns.args[3]); // undefined, because only 3 arguments were provided
}
```