4.3BSD-Tahoe/usr/man/cat3/gets.0

Compare this file to the similar file:
Show the results in this format:



GETS(3S)	    UNIX Programmer's Manual		 GETS(3S)



NNAAMMEE
     gets, fgets - get a string from a stream

SSYYNNOOPPSSIISS
     ##iinncclluuddee <<ssttddiioo..hh>>

     cchhaarr **ggeettss((ss))
     cchhaarr **ss;;

     cchhaarr **ffggeettss((ss,, nn,, ssttrreeaamm))
     cchhaarr **ss;;
     FFIILLEE **ssttrreeaamm;;

DDEESSCCRRIIPPTTIIOONN
     _G_e_t_s reads a string into _s from the standard input stream
     ssttddiinn.  The string is terminated by a newline character,
     which is replaced in _s by a null character.  _G_e_t_s returns
     its argument.

     _F_g_e_t_s reads _n-1 characters, or up through a newline charac-
     ter, whichever comes first, from the _s_t_r_e_a_m into the string
     _s.  The last character read into _s is followed by a null
     character.  _F_g_e_t_s returns its first argument.

SSEEEE AALLSSOO
     puts(3S), getc(3S), scanf(3S), fread(3S), ferror(3S)

DDIIAAGGNNOOSSTTIICCSS
     _G_e_t_s and _f_g_e_t_s return the constant pointer NNUULLLL upon end of
     file or error.

BBUUGGSS
     _G_e_t_s deletes a newline, _f_g_e_t_s keeps it, all in the name of
     backward compatibility.





















Printed 7/9/88		  May 15, 1985				1