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

DESCRIPTION

The gets subroutine 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 subroutine returns its argument.

The fgets subroutine 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 subroutine returns its first argument.

RESTRICTIONS

The gets subroutine deletes a newline, the fgets subroutine keeps it, for backward compatibility.

DIAGNOSTICS

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

Museum