bitburner-src/markdown/bitburner.ns.write.md
Olivier Gagnon 8b69fd7faa doc
2022-01-15 18:39:37 -05:00

35 lines
1.3 KiB
Markdown

<!-- 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; [write](./bitburner.ns.write.md)
## NS.write() method
Write data to a file.
<b>Signature:</b>
```typescript
write(handle: string, data?: string[] | number | string, mode?: "w" | "a"): Promise<void>;
```
## Parameters
| Parameter | Type | Description |
| --- | --- | --- |
| handle | string | Filename of the text file that will be written to. |
| data | string\[\] \| number \| string | Data to write. |
| mode | "w" \| "a" | Defines the write mode. Only valid when writing to text files. |
<b>Returns:</b>
Promise&lt;void&gt;
## Remarks
RAM cost: 0 GB
This function can be used to write data to a text file (.txt).
This function will write data to that text file. If the specified text file does not exist, then it will be created. The third argument mode, defines how the data will be written to the text file. If \*mode is set to “w”, then the data is written in “write” mode which means that it will overwrite all existing data on the text file. If mode is set to any other value then the data will be written in “append” mode which means that the data will be added at the end of the text file.