eof()
Test if the end-of-file has been reached
Synopsis:
#include <unistd.h>
int eof( int filedes );
Arguments:
- filedes
- A file descriptor for the file that you want to check.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The eof() function is a low-level function that determines if the end of the file specified by filedes has been reached.
Input operations set the current file position; you can call the eof() function to detect the end of the file before more input operations to prevent attempts at reading beyond the end of the file.
Returns:
- 1
- The end-of-file has been reached.
- 0
- The end-of-file hasn't been reached.
- -1
- An error occurred (errno is set).
Errors:
- EBADF
- The file descriptor, filedes, isn't valid.
Examples:
#include <stdio.h>
#include <fcntl.h>
#include <unistd.h>
#include <stdlib.h>
int main( void )
{
int filedes, len;
char buffer[100];
filedes = open( "file", O_RDONLY );
if( filedes != -1 ) {
while( ! eof( filedes ) ) {
len = read( filedes, buffer, sizeof(buffer) - 1 );
buffer[ len ] = '\0';
printf( "%s", buffer );
}
close( filedes );
return EXIT_SUCCESS;
}
return EXIT_FAILURE;
}