GETS(3S)                             SysV                             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;
     int n;
     FILE *stream;

DESCRIPTION
     gets reads characters from the standard input stream, stdin, into the
     array pointed to by s, until a newline character is read or an end-of-
     file condition is encountered.  The newline character is discarded and
     the string is terminated with a null character.

     fgets reads characters from the stream into the array pointed to by s,
     until n-1 characters are read, or a newline character is read and
     transferred to s, or an end-of-file condition is encountered.  The string
     is then terminated with a null character.

SEE ALSO
     ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S), stdio(3S).

DIAGNOSTICS
     If end-of-file is encountered and no characters have been read, no
     characters are transferred to s and a NULL pointer is returned.  If a
     read error occurs, such as trying to use these functions on a file that
     has not been opened for reading, a NULL pointer is returned.  Otherwise s
     is returned.