2.11BSD/man/cat3/fgets.0
GETS(3S) UNIX Programmer's Manual GETS(3S)
NAME
gets, fgets - get a string from a stream
SYNOPSIS
#include <stdio.h>
char *gets(s)
char *s;
char *fgets(s, n, stream)
char *s;
FILE *stream;
DESCRIPTION
_G_e_t_s reads a string into _s from the standard input stream
stdin. The string is terminated by a newline character,
which is replaced in _s by a null character. _G_e_t_s returns
its argument.
_F_g_e_t_s reads _n-1 characters, or up through a newline charac-
ter, whichever comes first, from the _s_t_r_e_a_m into the string
_s. The last character read into _s is followed by a null
character. _F_g_e_t_s returns its first argument.
SEE ALSO
puts(3S), getc(3S), scanf(3S), fread(3S), ferror(3S)
DIAGNOSTICS
_G_e_t_s and _f_g_e_t_s return the constant pointer NULL upon end of
file or error.
BUGS
_G_e_t_s deletes a newline, _f_g_e_t_s keeps it, all in the name of
backward compatibility.
Printed 11/26/99 May 15, 1985 1