関数CKfgetc マニュアル

(The documentation of function CKfgetc)

Last Update: 2022/10/28


◆機能・用途(Purpose)

関数fgetc(ファイルからの1文字の読み込み)をエラーチェック付きで実行する。
Call function fgetc (reading a character from a file) with error checks.


◆形式(Format)

#include <functions_with_errcheck.h>
inline char CKfgetc(FILE ∗stream)


◆引数(Arguments)

stream 読み込むファイルのファイルポインタ。
The file pointer of the file to read.


◆戻り値とエラーチェック (Return value and error checks)

下表で桃色のセルがエラー処理を表す。
The pick colored cells in the table below represent error checks.

条件
Condition
戻り値/動作
Return value or behaviour of the function
stream=NULL プログラムをエラー終了する。
The program finishes as an error.
関数fgetcの戻り値がエラー値(EOF)の場合
The return value of function fgetc is an error value (EOF)
プログラムをエラー終了する。
The program finishes as an error.
関数fgetcの戻り値(int型)がchar型の範囲(-128〜127)を外れる場合
The return value of function fgetc (int-type) is out of the range of char-type (from -128 to 127)
プログラムをエラー終了する。
The program finishes as an error.
上記以外の場合
The other cases
関数fgetcの戻り値(int型)をchar型にキャストして返す。
Cast the return value of function fgetc (int-type) to char-type and return.


◆使用例(Example)

FILE ∗fp;
char ch=CKfgetc(fp);