gets(3s)

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;
FILE *stream;

DESCRIPTION

The gets routine reads a string into s from the standard input stream stdin. The string is terminated by a newline character, which is replaced in s by a null character. The gets routine returns its argument.

The fgets routine reads n−1 characters, or up to a newline character, whichever comes first, from the stream into the string s. The last character read into s is followed by a null character. The fgets routine returns its first argument.

RESTRICTIONS

The gets routine deletes a newline, while fgets keeps it.

DIAGNOSTICS

The gets and fgets routines return the constant pointer NULL upon end of file or error.

Museum