_eof

發行項
02/28/2013

檔案結尾 (EOF) 的測試。

int _eof( 
   int fd 
);

參數

fd
指的開啟的檔案的檔案描述項。

傳回值

_eof如果目前的位置是檔案結尾，則為 0，如果沒有，則傳回 1。傳回值為-1 表示錯誤。在此情況下，不正確的參數處理常式會叫用，如所述參數驗證。如果要繼續，請允許執行errno設定為 [ EBADF，這表示無效的檔案描述項。

備註

_eof函式會判斷檔案的結尾是否相關聯fd已經到達。

需求

Function	所需的標頭	選擇性標頭
_eof	<io.h>	<errno.h>

如需相容性資訊，請參閱相容性在簡介中。

範例

// 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 );
}