fgetc | Programming Place Plus C言語編 標準ライブラリのリファレンス

トップページC言語編標準ライブラリのリファレンス(名前順)

トップページC言語編標準ライブラリのリファレンス(ヘッダ別)


fgetc関数

概要

入力ストリームから1文字受け取る。

ヘッダ

stdio.h

形式

int fgetc(FILE* stream);

引数

stream

入力ストリーム。

戻り値

成功時は入力された文字が返される。読み取りエラーの発生時や、ファイル終了指示子がセットされていた場合は EOF が返される。

詳細

文字は unsigned char型として読み取られ、int型にキャストした状態で返される。

ファイルの終わりに達していた場合、ファイル終了指示子がセットされる(あるいはすでにセットされているだろう)。読み取りエラーが発生した場合、エラー指示子がセットされる。

引数にstdinを指定することで、標準入力から受け取ることも可能である。

注意

戻り値が EOF になるケースが複数あるので、その切り分けに注意が必要である。

まず、ファイルの終わりに達したことを feof関数 で確認できる。また、エラーの発生を ferror関数 で確認できる。この2つの関数がともに 0 を返す可能性があり、その場合は、EOF の置換結果と、読み取った文字の値がたまたま一致している。これはごく限られた環境下でしか起こり得ないが、可能性として考慮しておくべきである。

使用例

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

int main(void)
{
    FILE* fp = fopen("test.txt", "r");
    if (fp == NULL) {
        fputs("ファイルオープンに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }
    
    int c = fgetc(fp);
    if (c == EOF) {
        if (feof(fp)) {
            // ファイルの終わり
        }
        else if (ferror(fp)) {
            // エラー
        }
        else {
            // EOF と同じ値をもった有効な文字
        }
    }
    printf("%c\n", c);
    
    if (fclose(fp) == EOF) {
        fputs("ファイルクローズに失敗しました。\n", stderr);
        exit(EXIT_FAILURE);
    }
}

入力ファイル(test.txt)

123
456
789

実行結果:

1

関連

文字列の入力を受け取るには fgets関数を用いる。
この関数と等価な getc関数がある。ただし、getc関数はマクロとして実装されているかもしれない。
ワイド文字バージョンの fgetwc関数がある。

解説章

第40章


参考リンク


更新履歴

’2018/4/22 解説中で C95 を(C89 に対して)特別扱いしないように修正。そもそもC言語編は C95ベースなので、余計な説明は省く。

’2018/4/9 getc関数について追記。

’2018/4/7 全体的に文章を見直し修正。

’2018/1/22 新規作成。



標準ライブラリのリファレンス(名前順)のトップページへ

標準ライブラリのリファレンス(ヘッダ別)のトップページへ

C言語編のトップページへ

Programming Place Plus のトップページへ



はてなブックマーク に保存 Pocket に保存 Facebook でシェア
X で ポストフォロー LINE で送る noteで書く
rss1.0 取得ボタン RSS 管理者情報 プライバシーポリシー
先頭へ戻る