# WriteLine

int WriteLine (int fileHandle, char *lineBuffer, int numberOfBytes);

## Purpose

Writes numberOfBytes bytes from lineBuffer to a file and then writes a linefeed (LF) to the file.

## Parameters

Input
Name | Type | Description
fileHandle | integer | Specifies the file to which the line is to be written. Call OpenFile to obtain a fileHandle. Open the file in ASCII mode so that WriteLine writes a carriage return (CR) before each LF. If fileHandle is 1, WriteLine writes the line to the Standard Output.
lineBuffer | string | Specifies the buffer from which the line is to be written.
numberOfBytes | integer | Number of bytes to write from the buffer to the file. If numberOfBytes is –1, WriteLine writes only the bytes in lineBuffer before the first ASCII NUL, followed by an LF.
| Note This value does not include the LF.

## Return Value

Name | Type | Description
n | integer | Number of bytes written to the file, excluding the LF. A value of –1 indicates that an error occurred during the write operation, possibly because of a bad file handle or because the file was opened in read only mode. You can use GetFmtIOError to get more information about the type of error that occurred.