gets(3)



NAME

     gets, fgets - get a string from a stream


SYNOPSIS

     #include <stdio.h>

     char *gets(char *s)
     char *fgets(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 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(3), getc(3), scanf(3), fread(3), ferror(3).


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.

     Gets is not present in the Minix-vmd C library for reasons that should be
     obvious.  Use fgets instead.