unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (4.2BSD)
Page:
Section:
Apropos / Subsearch:
optional field

GETS(3S)                                                              GETS(3S)



NAME
       gets, fgets - get a string from a stream

SYNOPSIS
       #include <&lt;stdio.h>&gt;

       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 to 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.



                                19 January 1983                       GETS(3S)