# File_GetLineString

> Reads a numbered line from a text file and returns its contents in gsValue.

Source: https://docs.capaone.com/capainstaller/vb-scripting-library/file-functions/file-getlinestring/  
Product: CapaInstaller — a separate CapaSystems product; do not apply this page to any other.

### Description

Read a line in a file

### Syntax

File_GetLineString(sFile, iLineNumber, bMustExist) As Boolean

### Parameters

#### sFile (String)

Filename

#### iLineNumber (String)

Line number

#### bMustExist (Boolean)

Line must exist

### Return value

Result will be stored in gsValue

### Example

**VBScript**

```vb
If bStatus Then bStatus = File_GetLineString("C:\CapaInstaller.txt", 1, True)
bStatus = Job_Writelog("Custom", "First line in win.ini: " & gsValue, bStatus, True)
```

[Scripting Guidelines](/capainstaller/vb-scripting-library/scripting-guidelines/)

### Related functions

[File_AppendToFile](/capainstaller/vb-scripting-library/file-functions/file-appendtofile/) [File_FindInFile](/capainstaller/vb-scripting-library/file-functions/file-findinfile/) [File_InsertInFile](/capainstaller/vb-scripting-library/file-functions/file-insertinfile/) [Constants](/capainstaller/vb-scripting-library/addendum/constants/) [Package Property](/capainstaller/vb-scripting-library/addendum/package-property/) [Variables](/capainstaller/vb-scripting-library/addendum/variables/)