gets(3S)               UNIX System V(C Development Set)                gets(3S)


NAME
      gets, fgets - get a string from a stream

SYNOPSIS
      #include <stdio.h>

      char *gets (char *s);

      char *fgets (char *s, int n, FILE *stream);

DESCRIPTION
      gets reads characters from the standard input stream [see intro(3)],
      stdin, into the array pointed to by s, until a newline character is read
      or an end-of-file condition is encountered.  The newline character is
      discarded and the string is terminated with a null character.

      fgets reads characters from the stream into the array pointed to by s,
      until n-1 characters are read, or a newline character is read and
      transferred to s, or an end-of-file condition is encountered.  The string
      is then terminated with a null character.

      When using gets, if the length of an input line exceeds the size of s,
      indeterminate behavior may result.  For this reason, it is strongly
      recommended that gets be avoided in favor of fgets.

SEE ALSO
      lseek(2), read(2), ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(3S),
      stdio(3S), ungetc(3S).

DIAGNOSTICS
      If end-of-file 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 and the error
      indicator for the stream is set.  If end-of-file is encountered, the EOF
      indicator for the stream is set.  Otherwise s is returned.


















10/89                                                                    Page 1