x04 Chapter Contents
x04 Chapter Introduction
NAG C Library Manual

# NAG Library Function Documentnag_read_line (x04bbc)

## 2  Specification

 #include #include
 void nag_read_line (Nag_FileID fileid, char *line, Integer linelen, NagError *fail)

## 3  Description

nag_read_line (x04bbc) may be used to read from files opened with nag_open_file (x04acc).

None.

## 5  Arguments

1:     fileidNag_FileIDInput
On entry: the identifier of the file to be read from. This must have been returned by a call of nag_open_file (x04acc).
2:     linechar *Output
A character buffer of length linelen.
On exit: contains a null-terminated character-string read from the file associated with the FileID. If line is too small to hold the entire string, excess characters are discarded.
3:     linelenIntegerInput
On entry: the size of the character buffer line. If ${\mathbf{linelen}}\le 0$, no characters are read and line is unchanged.
4:     failNagError *Input/Output
The NAG error argument (see Section 3.6 in the Essential Introduction).

## 6  Error Indicators and Warnings

Error occurred when reading from FileID $〈\mathit{\text{value}}〉$.

Not applicable.