_eof
Visual Studio .NET 2003
Tests for end-of-file.
int _eof( int fd );
Parameter
- fd
- File descriptor referring to open file.
Return Value
_eof returns 1 if the current position is end of file, or 0 if it is not. A return value of –1 indicates an error; in this case, errno is set to EBADF, which indicates an invalid file descriptor.
Remarks
The _eof function determines whether the end of the file associated with fd has been reached.
Requirements
| Function | Required header | Optional headers | Compatibility |
|---|---|---|---|
| _eof | <io.h> | <errno.h> | Win 98, Win Me, Win NT, Win 2000, Win XP |
For additional compatibility information, see Compatibility in the Introduction.
Libraries
All versions of the C run-time libraries.
Example
// crt_eof.c
/* This program reads data from a file
* ten bytes at a time until the end of the
* file is reached or an error is encountered.
*/
#include <io.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
int main( void )
{
int fh, count, total = 0;
char buf[10];
if( (fh = _open( "crt_eof.txt", _O_RDONLY )) == - 1 )
{
perror( "Open failed");
exit( 1 );
}
/* Cycle until end of file reached: */
while( !_eof( fh ) )
{
/* Attempt to read in 10 bytes: */
if( (count = _read( fh, buf, 10 )) == -1 )
{
perror( "Read error" );
break;
}
/* Total actual bytes read */
total += count;
}
printf( "Number of bytes read = %d\n", total );
_close( fh );
}
Input: crt_eof.txt
This file contains some text.
Output
Number of bytes read = 29
See Also
Error Handling Routines, Low-level I/O Routines | clearerr | feof | ferror | perror | Run-Time Routines and .NET Framework Equivalents
