f78
fgets
[get character string from a file or
stream]
SYNOPSIS
#include
<stdio.h>
char *fgets(char
*buf, int
n, FILE
*fp);
DESCRIPTION
fgets
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.
COMPLIANCE
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.
0