Manpages

名 前

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 >= 1 || _XOPEN_SOURCE || _POSIX_SOURCE

説 明

関 数 clearerr() は stream で 示 さ れ る ス ト リ ー ム の EOF(end−of−file) 指 示 子 と エ ラ ー 指 示 子 を ク リ ア す る 。 関 数 feof() は stream で 示 さ れ る ス ト リ ー ム の EOF 指 示 子 を テ ス ト し 、 セ ッ ト さ れ て い れ ば 0 以 外 の 数 を 返 す 。 EOF 指 示 子 は 、 関 数 clearerr() に よ っ て の み ク リ ア す る こ と が で き る 。 関 数 ferror() は stream で 示 さ れ る ス ト リ ー ム の エ ラ ー 指 示 子 を テ ス ト し 、 セ ッ ト さ れ て い れ ば 0 以 外 の 数 を 返 す 。 エ ラ ー 指 示 子 は 、 関 数 clearerr() に よ っ て の み リ セ ッ ト す る こ と が で き る 。 関 数 fileno() は 、 引 数 stream を 調 べ 、 そ の 整 数 の デ ィ ス ク リ プ タ ー を 返 す 。 こ れ ら の 処 理 を 停 止 せ ず に 行 い た い と き は 、 unlocked_stdio(3) を 参 照 の こ と 。

エ ラ ー

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

属 性

マ ル チ ス レ ッ デ ィ ン グ (pthreads(7) 参 照 ) 関 数 clearerr(), feof(), 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 プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。