feof
ストリームの EOF のテスト。
int feof(
FILE *stream
);
パラメーター
- stream
FILE 構造体へのポインター。
戻り値
読み取り操作はファイルの末尾を超えて読み取ろうとすると feof 関数の戻り値 0 以外の値; 長さが 0 以外の場合は false を返します。 ストリーム ポインターが NULLの場合、関数は パラメーターの検証"に説明されているように、無効なパラメーター ハンドラーを呼び出します。 実行の継続 errno は EINVAL と feof は 0 に設定されます。
エラー コードの詳細については、「_doserrno、errno、_sys_errlist、および _sys_nerr」を参照してください。
解説
feof ルーチン (関数とマクロとして実装される) stream の最後に渡されているかどうかを判定します。 ファイルの終端に達した場合が渡された場合、読み取り操作は、ストリームを閉じるか、rewindまで、fsetpos、fseek、または clearerr がそれに対して呼び出されるまで EOF を返します。
たとえば、ファイルが 10 バイトが含まれているファイルの 10 バイトを読み取ると、feof は、ファイル ポインターをファイルの末尾にあるが、端を超えて読み取ろうとしていないため、0 を返します。 読み取ろうとした後にのみ、第 11 バイトは feof の戻り 0 以外の値。
必要条件
関数 |
必須ヘッダー |
|---|---|
feof |
<stdio.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// 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 );
}
入力: crt_feof.txt
Line one.
Line two.
出力
Number of bytes read = 19
同等の .NET Framework 関数
使用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。