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 feor() to determine whether an error or
                end-of-file condition exists.


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

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

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

         #include <stdio.h>

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

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