GETS(S) UNIX System V GETS(S)
Name
gets, fgets - get a string from a stream
Syntax
#include <stdio.h>
char *gets (s)
char *s;
char *fgets (s, n, stream)
char *s;
int n;
FILE *stream;
Description
The gets function 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.
The fgets function 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
ferror(S), fopen(S), fread(S), getc(S), scanf(S), stdio(S)
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.
Standards Conformance
fgets and gets are conformant with:
AT&T SVID Issue 2, Select Code 307-127;
The X/Open Portability Guide II of January 1987;
ANSI X3.159-198X C Language Draft Standard, May 13,
1988;
IEEE POSIX Std 1003.1-1988 with C Standard Language-
Dependent System Support;
and NIST FIPS 151-1.
(printed 6/20/89)