GETS(3S)                             BSD                              GETS(3S)



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

     fgets reads n-1 characters, or up through 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.  fgets returns its first
     argument.

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

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

BUGS
     gets deletes a newline, fgets keeps it, all in the name of backward
     compatibility.