# 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://content.gitbook.com/content/zEifS4h8yurLAAwiGNX2/blobs/Arpn9j5cfeyLy3Uzbpqu/0.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://content.gitbook.com/content/zEifS4h8yurLAAwiGNX2/blobs/3XqZdFrRUlrs5aUDaHZ6/1.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://content.gitbook.com/content/zEifS4h8yurLAAwiGNX2/blobs/ruaO1QIJDJxXBK3v4PMD/2.png)