Settings help

CL Name Style:

1Purpose

x04bbc reads a single line from an external file.

2Specification

 #include
 void x04bbc (Nag_FileID fileid, char *line, Integer linelen, NagError *fail)
The function may be called by the names: x04bbc, nag_file_line_read or nag_read_line.

3Description

x04bbc may be used to read from files opened with x04acc.

None.

5Arguments

1: $\mathbf{fileid}$Nag_FileID Input
On entry: the identifier of the file to be read from. This must have been returned by a call of x04acc.
2: $\mathbf{line}$char * 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: $\mathbf{linelen}$Integer Input
On entry: the size of the character buffer line. If ${\mathbf{linelen}}\le 0$, no characters are read and line is unchanged.
4: $\mathbf{fail}$NagError * Input/Output
The NAG error argument (see Section 7 in the Introduction to the NAG Library CL Interface).

6Error Indicators and Warnings

Error occurred when reading from FileID $⟨\mathit{\text{value}}⟩$.

Not applicable.

8Parallelism and Performance

x04bbc is not threaded in any implementation.