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;
int n;
FILE ∗stream;

DESCRIPTION

Gets reads a string into s from the standard input stream stdin.  The string is terminated by a new-line character, which is replaced in s by a null character.  Gets returns its argument. 

Fgets reads n−1 characters, or up to a new-line character (which is retained), whichever comes first, from the stream into the string s. The last character read into s is followed by a null character.  Fgets returns its first argument. 

SEE ALSO

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

DIAGNOSTICS

Gets and fgets return the constant pointer NULL upon end-of-file or error. 

NOTE

Gets deletes the new-line ending its input, but fgets keeps it. 

May 16, 1980