_eof

Artikel
02/26/2013

Tests für Dateiende (EOF).

int _eof( 
   int fd 
);

Parameter

fd
Dateideskriptor, der die geöffnete Datei verweist.

Rückgabewert

_eof gibt 1 (null), wenn die aktuelle Position Dateiende ist, oder 0 zurück, wenn dies nicht der Fall ist.Ein Rückgabewert von 1 gibt einen Fehler an. In diesem Fall wird der Ereignishandler aufgerufen, z. B. ungültige Parameter in Parametervalidierungbeschrieben.Wenn die Ausführung zulässig ist, um fortzufahren, wird errno zu EBADFfestgelegt, die einen ungültigen Dateideskriptor angibt.

Hinweise

Die _eof-Funktion bestimmt, ob das Ende der Datei, die fd zugeordnet ist, erreicht wurde.

Anforderungen

Funktion	Erforderlicher Header	Optionaler Header
_eof	<io.h>	<errno.h>

Weitere Informationen finden Sie unter Kompatibilität Kompatibilität in der Einführung.

Beispiel

// 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>
#include <share.h>

int main( void )
{
   int  fh, count, total = 0;
   char buf[10];
   if( _sopen_s( &fh, "crt_eof.txt", _O_RDONLY, _SH_DENYNO, 0 ) )
   {
        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 );
}