putc

ストリーム (stream) に指定した文字を書き込みます.

#include <stdio.h>
int putc(
    int c,
    FILE *stream
);

putc 関数は基本的には fputc と同じで,stream が指すストリームに c で指定された文字を書き込みます.(文字は unsigned char 型に変換されて書き込まれます.)

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

引数

戻り値

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

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

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

/* main */
int main(void) {
    int i;
    FILE *fp;
    char *filename = "sample.txt";
    char writeline[] = "ABCDEFG12345あいうえお";

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

    /* ファイルの終端まで文字を書き込む */
    for ( i = 0; i < sizeof(writeline) - 1; i++ ) {
        putc(writeline[i], fp);
    }

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

    return EXIT_SUCCESS;
}

実行例

サンプルプログラムを実行すると sample.txt に以下が書き込まれます.

ABCDEFG12345あいうえお