Click above to get retro games delivered to your door ever month!

 fgets()                 Read a String from Stream

 #include   <stdio.h>

 char       *fgets(string,n,stream);
 char       *string;                     Storage location
 int        n;                           Number of characters stored
 FILE       *stream;                     Pointer to FILE structure


    fgets() reads characters from 'stream' and stores them in 'string'.
    fgets() stops reading at the first new-line character (in which case
    the new-line itself will be stored in 'stream'); at the end of the
    stream; or when 'n'-1 characters have been read, whichever comes
    first. A null character ('\0') is appended at the end of 'stream'.


    Returns:    The resultant string.  A NULL value is returned if
                there's an error or end-of-file condition.  Because EOF
                is a legitimate value that may be read from 'stream', use
                ferror() or feof() to determine whether an error or
                end-of-file condition exists.


      Notes:    fgets() is similar to gets(), but gets() substitutes the
                null character for the new-line character.

   -------------------------------- Example ---------------------------------

    This example gets a line of input from 'stream'.

           #include <stdio.h>

           char string[50], *newstring;
           FILE *stream;

           main()
           {
                if ((stream = fopen("new.dta","r+")) != NULL)  {
                    newstring = fgets(string,50,stream);
                }
           }