man/man3/gets.3

   1 .\"     @(#)gets.3s     6.1 (Berkeley) 5/15/85
   2 .\"
   3 .TH GETS 3  "May 15, 1985"
   4 .AT 3
   5 .SH NAME
   6 gets, fgets \- get a string from a stream
   7 .SH SYNOPSIS
   8 .nf
   9 .ft B
  10 #include <stdio.h>
  11
  12 char *gets(char *\fIs\fP)
  13 char *fgets(char *\fIs\fP, int \fIn\fP, FILE *\fIstream\fP)
  14 .ft R
  15 .fi
  16 .SH DESCRIPTION
  17 .B Gets
  18 reads a string into
  19 .I s
  20 from the standard input stream
  21 .BR stdin .
  22 The string is terminated by a newline
  23 character, which is replaced in
  24 .I s
  25 by a null character.
  26 .B Gets
  27 returns its argument.
  28 .PP
  29 .B Fgets
  30 reads
  31 .IR n \-1
  32 characters, or up through a newline
  33 character, whichever comes first,
  34 from the
  35 .I stream
  36 into the string
  37 .IR s .
  38 The last character read into
  39 .I s
  40 is followed by a null character.
  41 .B Fgets
  42 returns its first argument.
  43 .SH "SEE ALSO"
  44 .BR puts (3),
  45 .BR getc (3),
  46 .BR scanf (3),
  47 .BR fread (3),
  48 .BR ferror (3).
  49 .SH DIAGNOSTICS
  50 .B Gets
  51 and
  52 .B fgets
  53 return the constant pointer
  54 .SM
  55 .B NULL
  56 upon end of file or error.
  57 .SH BUGS
  58 .B Gets
  59 deletes a newline,
  60 .B fgets
  61 keeps it,
  62 all in the name of backward compatibility.
  63 .PP
  64 .B Gets
  65 is not present in the Minix-vmd C library for reasons that should be obvious.
  66 Use
  67 .B fgets
  68 instead.