HPUX gets[3s]

 gets(3S)                                                           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, stdin,
                     into the array pointed to by s, until a new-line
                     character is read or an end-of-file condition is
                     encountered.  The new-line 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, a new-line
                     character is read and transferred to s, or an end-of-
                     file condition is encountered.  The string is then
                     terminated with a null character.

 RETURN VALUE
      Upon sucessful completion, fgets() and gets() return s.  If the stream
      is at end-of-file, the end-of-file indicator for the stream is set and
      a null pointer is returned.  If a read error occurs, the error
      indicator for the stream is set, errno is set to indicate the error,
      and a null pointer is returned.

      ferror() and feof() can be used to distinguish between an error
      condition and an end-of-file condition.

 ERRORS
      fgets() and gets() fail if data needs to be read into the stream's
      buffer, and:

           [EAGAIN]       The O_NONBLOCK flag is set for the file descriptor
                          underlying stream and the process would be delayed
                          in the read operation.

           [EBADF]        The file descriptor underlying stream is not a
                          valid file descriptor open for reading.

           [EINTR]        The read operation was terminated due to the
                          receipt of a signal, and either no data was
                          transferred or the implementation does not report
                          partial transfer for this file.

           [EIO]          The process is a member of a background process
                          and is attempting to read from its controlling



 Hewlett-Packard Company            - 1 -     HP-UX Release 9.0: August 1992






 gets(3S)                                                           gets(3S)





                          terminal, and either the process is ignoring or
                          blocking the SIGTTIN signal or the process group
                          of the process is orphaned.

                          Additional errno values can be set by the
                          underlying read() function (see read(2)).

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

 STANDARDS CONFORMANCE
      gets(): AES, SVID2, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C

      fgets(): AES, SVID2, XPG2, XPG3, XPG4, FIPS 151-2, POSIX.1, ANSI C








































 Hewlett-Packard Company            - 2 -     HP-UX Release 9.0: August 1992