名前

       clearerr, feof, ferror, fileno - ストリームステータスのチェックとリセット

書式

       #include <stdio.h>

       void clearerr(FILE *stream);

       int feof(FILE *stream);

       int ferror(FILE *stream);

       int fileno(FILE *stream);

   glibc 向けの機能検査マクロの要件 (feature_test_macros(7)  参照):

       fileno(): _POSIX_C_SOURCE

説明

       関数 clearerr()  は stream で示されるストリームの EOF(end-of-file) 指示子とエラー指示子をクリアする。

       関数  feof()   は  stream で示されるストリームの EOF 指示子をテストし、 セットされていれば 0 以外の数を返
       す。 EOF 指示子は、関数 clearerr()  によってのみクリアすることができる。

       関数 ferror()  は stream で示されるストリームのエラー指示子をテストし、 セットされていれば 0 以外の数を返
       す。 エラー指示子は、関数 clearerr()  によってのみリセットすることができる。

       The  function  fileno()   examines  the  argument  stream and returns the integer file descriptor used to
       implement this stream.  The file descriptor is still owned by stream and will be  closed  when  fclose(3)
       is called.  Duplicate the file descriptor with dup(2)  before passing it to code that might close it.

       これらの処理を停止せずに行いたいときは、 unlocked_stdio(3)  を参照のこと。

エラー

       これらの関数は失敗すべきではなく、また、外部変数 errno に値をセットしない。 (しかし、 fileno() 関数の場合
       で、引数が有効なストリームでなかった場合、 関数は -1 を返し、 errno に EBADF を設定しなければならない。)

属性

       この節で使用されている用語の説明については、 attributes(7) を参照。

       ┌────────────────────┬───────────────┬─────────┐
       │インターフェース    │ 属性          │ 値      │
       ├────────────────────┼───────────────┼─────────┤
       │clearerr(), feof(), │ Thread safety │ MT-Safe │
       │ferror(), fileno()  │               │         │
       └────────────────────┴───────────────┴─────────┘

準拠

       関数 clearerr(), feof(), ferror()  は C89, C99, POSIX.1-2001, POSIX.1-2008 に準拠している。

       関数 fileno() は POSIX.1-2001 と POSIX.1-2008 に準拠している。

関連項目

       open(2), fdopen(3), stdio(3), unlocked_stdio(3)

この文書について

       この man ページは Linux man-pages プロジェクトのリリース 5.10  の一部である。プロジェクトの説明とバグ報告
       に関する情報は https://www.kernel.org/doc/man-pages/ に書かれている。

                                                   2019-03-06                                          FERROR(3)