GETS(3S)GETS(3S)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 ALSOlseek(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.
Page 1
