- Qbs Manual
- TextFile Service
- Qbs 2.1.1

# TextFile Service

The `TextFile` service allows you to read from and write into text files.

## Related Declarations

### TextFile.OpenMode

     enum TextFile.OpenMode { ReadOnly, WriteOnly, ReadWrite, Append }

List of modes that a file may be opened in.

The OpenMode values can be combined with the bitwise or operator.

## Available operations

### Constructor

     TextFile(filePath: string, openMode: OpenMode = TextFile.ReadOnly)

Opens the file at `filePath` in the given mode and returns the object representing the file.

Note: The mode influences which of the operations listed below can actually be used on the file.

### atEof

     atEof(): boolean

Returns `true` if no more data can be read from the file, `false` otherwise.

### close

     close(): void

Closes the file. It is recommended to always call this function as soon as you are finished with the file, in order to keep the number of in-flight file descriptors as low as possible.

### filePath

     filePath(): string

The absolute path of the file represented by this object.

### readAll

     readAll(): string

Reads all data from the file and returns it.

### readLine

     readLine(): string

Reads one line of text from the file and returns it. The returned string does not contain the newline characters.

### setCodec

     setCodec(codec: string): void

Sets the text codec to `codec`. The supported codecs are the same as for `QTextCodec`, for example: "UTF-8", "UTF-16", and "ISO 8859-1".

### truncate

     truncate(): void

Truncates the file, that is, gives it the size of zero, removing all content.

### write

     write(data: string): void

Writes `data` into the file at the current position.

### writeLine

     writeLine(data: string): void

Writes `data` into the file at the current position and appends the newline character(s).