GETS(3S)							      GETS(3S)

NAME    [Toc]    [Back]

     gets, fgets - get a string	from a stream

SYNOPSIS    [Toc]    [Back]

     #include <stdio.h>

     char *gets	(char *s);

     char *fgets (char *s, int n, FILE *stream);

DESCRIPTION    [Toc]    [Back]

     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-offile
 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    [Toc]    [Back]

     lseek(2), read(2),	ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S),
     stdio(3S),	ungetc(3S).

NOTES    [Toc]    [Back]

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

DIAGNOSTICS    [Toc]    [Back]

     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.


									PPPPaaaaggggeeee 1111