gets(3S)                                                 gets(3S)



NAME
     gets, fgets - get a string from a stream

SYNOPSIS
     #include <stdio.h>

     char *gets (s)
     char *s;

     char *fgets (s, n, stream)
     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, or a new-
     line character is read and transferred to s, or an end-of-
     file condition is encountered.  The string is then ter-
     minated with a null character.

SEE ALSO
     ferror(3S), fopen(3S), fread(3S), getc(3S), scanf(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 read-
     ing, a NULL pointer is returned.  Otherwise s is returned.

BUGS
     gets deletes a newline, fgets keeps it.
















Page 1                        CX/UX Programmer's Reference Manual