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

Synopsis:
    #include <stdio.h>
    int fgetc( FILE *fp );
    #include <stdio.h>
    #include <wchar.h>
    wint_t fgetwc( FILE *fp );

Description:
    The fgetc function gets the next character from the file designated by
    fp.  The character is signed.

    The fgetwc function is identical to fgetc except that it gets the next
    multibyte character (if present) from the input stream pointed to by fp
    and converts it to a wide character.

Returns:
    The fgetc function returns the next character from the input stream
    pointed to by fp.  If the stream is at end-of-file, the end-of-file
    indicator is set and fgetc returns  EOF.  If a read error occurs, the
    error indicator is set and fgetc returns  EOF.

    The fgetwc function returns the next wide character from the input
    stream pointed to by fp.  If the stream is at end-of-file, the
    end-of-file indicator is set and fgetc returns  WEOF.  If a read error
    occurs, the error indicator is set and fgetc returns  WEOF.  If an
    encoding error occurs,  errno is set to  EILSEQ and fgetc returns  WEOF.

    When an error has occurred,  errno contains a value indicating the type
    of error that has been detected.

Example:
    #include <stdio.h>

    void main()
      {
        FILE *fp;
        int c;

        fp = fopen( "file", "r" );
        if( fp != NULL ) {
          while( (c = fgetc( fp )) != EOF )
            fputc( c, stdout );
          fclose( fp );
        }
      }

Classification:
    fgetc is ANSI, fgetwc is ANSI

Systems:
     fgetc - All, Netware

    fgetwc - All

See Also:
    fgetchar, fgets, fopen, getc, getchar, gets, ungetc