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

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

Description:
    The getc function gets the next character from the file designated by
    fp.  The character is returned as an int value.  The getc function is
    equivalent to  fgetc, except that it may be implemented as a macro.

    The getwc function is identical to getc 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 getc 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 getc returns  EOF.  If a read error occurs, the
    error indicator is set and getc returns  EOF.

    The getwc 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 getc returns  WEOF.  If a read error occurs, the
    error indicator is set and getc returns  WEOF.  If an encoding error
    occurs,  errno is set to  EILSEQ and getc 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 = getc( fp )) != EOF )
            putchar(c);
          fclose( fp );
        }
      }

Classification:
    getc is ANSI, getwc is ANSI

Systems:
     getc - All, Netware

    getwc - All

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