feof

發行項
02/28/2013

測試串流的檔案結尾。

int feof( 
   FILE *stream 
);

參數

stream
指向 FILE 結構的指標。

傳回值

feof 函式在讀入運算嘗試在檔案結尾後讀入時回傳一非零值，否則回傳零。如果串流指標是 NULL ，函式叫用無效參數處理常式，如參數驗證中所述。如果允許繼續執行， errno 會被設置為 EINVAL 且 feof 會回傳零。

如需更多關於這些和其他回傳碼的資訊，請參閱 _doserrno 、 errno 、 _sys_errlist 和 _sys_nerr (_doserrno, errno, _sys_errlist, and _sys_nerr) 。

備註

feof 常式 (會實作為函式和巨集) 判斷是否已經過 stream 結尾。已經過檔案結尾時，讀取作業將回傳檔案結尾指示，直到關閉串流或呼叫 rewind 、 fsetpos 、 fseek 或 clearerr 為止。

例如，一個當案包含 10 個位元組，而您從它讀取了 10 個位元組， feof 會回傳 0 ，因為即使檔案指標已經位於檔案的結尾，但是你並沒有再次嘗試去讀取它。只有在您嘗試讀取第 11 個位元組時， feof 才會傳回非零的值。

需求

Function	必要的標頭檔
feof	<stdio.h>

如需其他相容性資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

// crt_feof.c
// This program uses feof to indicate when
// it reaches the end of the file CRT_FEOF.TXT. It also
// checks for errors with ferror.
//

#include <stdio.h>
#include <stdlib.h>

int main( void )
{
   int  count, total = 0;
   char buffer[100];
   FILE *stream;

   fopen_s( &stream, "crt_feof.txt", "r" );
   if( stream == NULL )
      exit( 1 );

   // Cycle until end of file reached:
   while( !feof( stream ) )
   {
      // Attempt to read in 100 bytes:
      count = fread( buffer, sizeof( char ), 100, stream );
      if( ferror( stream ) )      {
         perror( "Read error" );
         break;
      }

      // Total up actual bytes read
      total += count;
   }
   printf( "Number of bytes read = %d\n", total );
   fclose( stream );
}