getc

ストリーム (stream) から 1 文字単位で文字を読み取ります.

#include <stdio.h>
int getc(
    FILE *stream
);

getc 関数は基本的には fgetc と同じで,stream が指すストリームから 1 文字分文字を読み取ります.(文字は unsigned char 型として取り込まれ,int 型に変換されて戻り値になります.)

ただし,getc は fgetc とは違い,マクロとして実装してもよいことになっています.getc がマクロとして実装されている場合は stream を 2 回以上評価することがあります.したがって,stream に副作用 (side effect) を伴う式は使えません.

引数

戻り値

C言語サンプルプログラム

getc 関数を使用してファイルに文字を書き込むサンプルプログラムを以下に示します.

/* header files */
#include <stdio.h>
#include <stdlib.h>

/* main */
int main(void) {
    FILE *fp;
    char *filename = "sample.txt";
    int ch;

    /* ファイルのオープン */
    if ((fp = fopen(filename, "r")) == NULL) {
        fprintf(stderr, "%sのオープンに失敗しました.\n", filename);
        return EXIT_FAILURE;
    }

    /* ファイルの終端まで文字を読み取り表示する */
    while (( ch = getc(fp)) != EOF ) {
        putchar(ch);
    }

    /* ファイルのクローズ */
    fclose(fp);

    return EXIT_SUCCESS;
}

実行例

サンプルプログラム内で使用する sample.txt の内容は以下のように用意したとします.

I don't want to march as much as possible.
I love SNOOPY.

サンプルプログラムの実行結果は以下のようになります.

I don't want to march as much as possible.
I love SNOOPY.