NAME
     gets, fgets - get a string	from a stream

SYNOPSIS
     #include <stdio.h>

     char *gets	(char *s);

     char *fgets (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 new-line character is read or an end-of-
     file condition is encountered.  The new-line 
     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 new-line 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
     lseek(2), read(2),	ferror(3S), fopen(3S),
     fread(3S), getc(3S), scanf(3S), stdio(3S),
     ungetc(3S).

NOTES
     When using	gets, if the length of an input line 
     exceeds the size of s, indeterminate behavior may	
     result.

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.