# WriteTextToFile (String filePath, String text)

| **Name**    | ***WriteTextToFile***                                                                                                 |
| ----------- | --------------------------------------------------------------------------------------------------------------------- |
| Syntax      | WriteTextToFile (String filePath, String text)                                                                        |
| Purpose     | To write a string to a file.                                                                                          |
| Description | Writes string to a file. Creates a new file if it does not exist.                                                     |
| Return Type | Void                                                                                                                  |
| Parameters  | <p>filePath \[System.String] – Full path of the file</p><p>text \[System.String] – Text to be written to the file</p> |

![](https://github.com/astera-software/Astera_Data_Stack_v9/blob/main/.gitbook/assets/0%20\(156\).png)

**Example**

In this example, we are passing the required parameters to the function transformation object using a *Variables* object. We will be writing the string, “HELLO WORLD 123”, into a new, empty ‘TEST\_WRITE’ .txt file.

Where,

*filePath* = C:\Users\Kanwal.Azim\OneDrive - Astera Software\Desktop\TEST\_WRITE.txt

*text* = HELLO WORLD 123

![](https://github.com/astera-software/Astera_Data_Stack_v9/blob/main/.gitbook/assets/1%20\(157\).png)

Right-click on the function transformation object and select *Preview Output.* While the *Data Preview* will not generate an output, a new file with the specfied name will be created in the specified loaction, and the provided *text* will be written to this file.

![](https://github.com/astera-software/Astera_Data_Stack_v9/blob/main/.gitbook/assets/2%20\(157\).png)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.astera.com/astera-data-stack-v8/functions/files/writetexttofile-string-filepath-string-text.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.