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;
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 EOF condition is encountered.  The NEWLINE character is discarded and the string is terminated with a NULL character.  gets() returns its argument. 

fgets() reads characters from the stream into the array pointed to by s, until n−1 characters are read, a NEWLINE character is read and transferred to s, or an EOF condition is encountered.  The string is then terminated with a NULL character.  fgets() returns its first argument. 

SEE ALSO

puts(3S), getc(3S), scanf(3S), fread(3S), ferror(3S)

DIAGNOSTICS

If EOF 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. 

Sun Release 4.0  —  Last change: 6 October 1987