4.3BSD-Reno/share/man/cat3/gets.0
GETS(3) 1990 GETS(3)
NNAAMMEE
gets - get a line from stdin
SSYYNNOOPPSSIISS
##iinncclluuddee <<ssttddiioo..hh>>
cchhaarr **ggeettss((ss))
cchhaarr **ss;;
DDEESSCCRRIIPPTTIIOONN
TThhiiss iinntteerrffaaccee iiss oobbssoolleetteedd bbyy ffggeettss((33)).. AAss iitt mmaakkeess nnoo
eeffffoorrtt ttoo aavvooiidd oovveerrwwrriittiinngg iittss bbuuffffeerr,, iitt''ss aa cclleeaarr sseeccuu--
rriittyy pprroobblleemm..
IItt iiss aavvaaiillaabbllee ffrroomm tthhee ccoommppaattiibbiilliittyy lliibbrraarryy,, lliibbccoommppaatt..
The _g_e_t_s function reads characters from the input stream
pointed to by _s_t_d_i_n, into the array pointed to by _s, until
end-of-file is encountered or a new-line character is read.
Any newline character is discarded, and a null character is
written immediately after the last character read into the
array.
The _g_e_t_s function returns _s if successful. If end-of-file
is encountered and no characters have been read into the
array, the contents of the array remain unchanged and a null
pointer is returned. If a read error occurrs during the
operation, the array contents are indeterminate and a null
pointer is returned.
SSEEEE AALLSSOO
getc(3), ferror(3) fread(3), scanf(3)
SSTTAANNDDAARRDDSS
The _g_e_t_s function is ANSI C compatible.
Printed 7/27/90 June 1