fgetln (3) - Linux Man Pages
fgetln: get a line from a stream
fgetln - get a line from a stream
SYNOPSISIn bsd/stdio.h Ft char * Fn fgetln FILE *stream size_t *len
DESCRIPTIONThe Fn fgetln function returns a pointer to the next line from the stream referenced by Fa stream . This line is not a C string as it does not end with a terminating NUL character. The length of the line, including the final newline, is stored in the memory location to which Fa len points and is guaranteed to be greater than 0 upon successful completion. (Note, however, that if the line is the last in a file that does not end in a newline, the returned text will not contain a newline.)
RETURN VALUESUpon successful completion a pointer is returned; this pointer becomes invalid after the next I/O operation on Fa stream (whether successful or not) or as soon as the stream is closed. Otherwise, NULL is returned. The Fn fgetln function does not distinguish between end-of-file and error; the routines feof(3) and ferror(3) must be used to determine which occurred. If an error occurs, the global variable errno is set to indicate the error. The end-of-file condition is remembered, even on a terminal, and all subsequent attempts to read will return NULL until the condition is cleared with clearerr(3).
- Bq Er EBADF
- The argument Fa stream is not a stream open for reading.
HISTORYThe Fn fgetln function first appeared in BSD 4.4