unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-4.1.3)
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 characters from the standard input stream, stdin, into the
       array pointed to by s, until a NEWLINE character is read or an EOF con-
       dition  is  encountered.   The  NEWLINE  character is discarded and the
       string is terminated with a null character.  gets() returns  its  argu-
       ment.

       fgets()  reads  characters from the stream into the array pointed to by
       s, until n-1 characters are read,  a  NEWLINE  character  is  read  and
       transferred  to  s,  or an EOF condition is encountered.  The string is
       then terminated with a null character.  fgets() returns its first argu-
       ment.

SEE ALSO
       puts(3S), getc(3V), scanf(3V), fread(3S), ferror(3V)

BUGS
       If the input to gets () or fgets () contains a null character, the null
       terminates the input, and all subsequent data will be lost.

DIAGNOSTICS
       If EOF is encountered and no characters have been read,  no  characters
       are  transferred  to s and a NULL pointer is returned.  If a read error
       occurs, such as trying to use these functions on a file  that  has  not
       been  opened  for  reading, a NULL pointer is returned.  Otherwise s is
       returned.



                                 1 August 1988                        GETS(3S)