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.