# ReadFileFirstLine (String filePath)

| **Name**    | ***ReadFileFirstLine***                                                  |
| ----------- | ------------------------------------------------------------------------ |
| Syntax      | ReadFileFirstLine (String filePath)                                      |
| Purpose     | To read and return contents of the file up until the first line.         |
| Description | Reads the first line of text of the specified file and returns the text. |
| Return Type | String                                                                   |
| Parameter   | filePath \[System.String] – Full path of the file                        |

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FTwpQCwakYpPeebcsBi0c%2F0.png?alt=media)

**Example**

In this example, we are passing the required parameter to the function transformation object using a *Variables* object.

Where,

*filePath* = C:\Users\Kanwal.Azim\OneDrive - Astera Software\Desktop\Functions Documentation\Files\ReadFileFirstLine\Test.txt

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2FBs1Bjhlooca2GudnoP7H%2F1.png?alt=media)

Right-click on the function transformation object and select *Preview Output.* You can see that Astera Data Stack has returned the first line of the specified file.

![](https://3083465318-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FsR50Wa7EwZGlmPSAMkkf%2Fuploads%2F9f5uWm9x7LMjzh8G1zhL%2F2.png?alt=media)