fgets---get character string from a file or streamSynopsis
#include <stdio.h> char *fgets(char *buf, int n, FILE *fp);
Description
Reads at most n-1 characters from fp until a newline
is found. The characters including to the newline are stored
in buf. The buffer is terminated with a 0.
Returns
fgets returns the buffer passed to it, with the data
filled in. If end of file occurs with some data already
accumulated, the data is returned with no other indication. If
no data are read, NULL is returned instead.
Portability
fgets should replace all uses of gets. Note however
that fgets returns all of the data, while gets removes
the trailing newline (with no indication that it has done so.)
Supporting OS subroutines required: close, fstat, isatty,
lseek, read, sbrk, write.
Packaging copyright © 1988-2000 OAR Corporation Context copyright by each document's author. See Free Software Foundation for information.