feof

 

C

Language

Standard Library

Type support

Dynamic memory management

Error handling

Program utilities

Date and time utilities

Strings library

Algorithms

Numerics

Input/output support

Localization support

Thread support (C11)

Atomic operations (C11)

 

File input/output

Functions
File access
fopen freopen fclose fflush	fwide setbuf setvbuf
Direct input/output
fread
fwrite
Unformatted input/output
fgetc fgets fputc fputs getchar gets putchar puts ungetc	fgetwc fgetws fputwc fputws getwchar putwchar ungetwc
Formatted input/output
scanffscanfsscanf vscanfvfscanfvsscanf (C99)(C99)(C99) printffprintfsprintfsnprintf (C99) vprintfvfprintfvsprintfvsnprintf (C99)	wscanffwscanfswscanf vwscanfvfwscanfvswscanf (C99)(C99)(C99) wprintffwprintfswprintf vwprintfvfwprintfvswprintf
File positioning
ftell
fgetpos
fseek
fsetpos
rewind
Error handling
clearerr
feof
ferror
perror
Operations on files
remove
rename
tmpfile
tmpnam

 

Defined in header <stdio.h>
int feof( FILE *stream );

Checks if the end of the given file stream has been reached.

Parameters

stream

-

the file stream to check

Return value

nonzero value if the end of the stream has been reached, otherwise ​0​

Notes

This function only reports the stream state as reported by the most recent I/O operation, it does not examine the associated data source. For example, if the most recent I/O was a fgetc, which returned the last byte of a file, feof returns zero. The next fgetc fails and changes the stream state to end-of-file. Only then feof returns non-zero.

In typical usage, input stream processing stops on any error; feof and ferror are then used to distinguish between different error conditions.

Example

Run this code

#include <stdio.h>
#include <stdlib.h>
 
int main(void)
{
    FILE* fp = fopen("test.txt", "r");
    if(!fp) {
        perror("File opening failed");
        return EXIT_FAILURE;
    }
 
    int c; // note: int, not char, required to handle EOF
    while ((c = fgetc(fp)) != EOF) { // typical file reading loop
       putchar(c);
    }
 
    if (ferror(fp))
        puts("I/O error when reading");
    else if (feof(fp))
        puts("End of file reached successfully");
}

See also

clearerr	clears errors (function)
perror	displays a character string corresponding of the current error to stderr (function)
ferror	checks for a file error (function)
C++ documentation for feof