Fwrite

fwriteは、C言語の標準入出力ヘッダー <stdio.h> で宣言されている関数である。
主に、バイナリ形式のファイル出力に使われる。

 形式 
ISO/IEC 9899:1999 では、以下のように定義されているISO/IEC 9899:1999 TC3 | WG14/N1256, Committee Draft | Septermber 7, 2007 | 7.19.8.2  The fwrite function。

 概要
 #include <stdio.h>
size_t fwrite(const void * restrict ptr, size_t size, size_t nmemb, FILE * restrict stream);
 説明
 fwrite関数は、ptrが指す配列から、sizeで指定された大きさを持つ要素を最大nmemb個まで、streamが指すストリームに書き込む。各オブジェクトに対して、オブジェクトの上に正確に重なっているの配列から値を（順に）取得しながら、fputc関数がsize回だけ呼び出される。ストリームのファイル位置指示子（定義されている場合）は、正常に書き込まれた文字数だけ進む。エラーが発生した場合、ストリームのファイル位置指示子の結果は不定である。
 返却値
 fwrite関数は、書き込みに成功した要素の数を返すが、書き込みエラーが発生した場合のみ、nmembよりも小さくなる。sizeまたはnmembがゼロの場合、fwriteはゼロを返し、ストリームの状態は変更されない。

ISO/IEC 9899:2018 でも同様である。

 テキストモード 
streamがテキストモードで開かれていた場合、改行コードLFは書き込みの際にCR+LFで置換される処理系もあるfwrite | Microsoft Docs。詳細は各処理系のリファレンスを参照のこと。

 コード例 
ユーザーの入力を受け取り、バイナリモードで sample.dat に書き込んだ後、読み込んで表示する。
#include <stdio.h>
#include <string.h>

static void printDoubleAsBigEndianHexBytes(double x) {
    unsigned char buf[sizeof(double)];
    size_t i;
    memcpy(buf, &x, sizeof(double));
    printf("0x");
    for (i = 0; i < sizeof(double); ++i) {
        printf("%02x", buf[i]);
    }
    puts("");
}

int main(void) {
    const char* const fileName = "sample.dat";
    FILE* fp;
    double v;
    size_t len;

    puts("Input a real number:");
    if (scanf("%lf", &v) != 1) {
        fprintf(stderr, "Failed to read a number from stdin.\n");
        return -1;
    }
    printDoubleAsBigEndianHexBytes(v);

    /* ファイルへの書き込み */
    fp = fopen(fileName, "wb");
    if (fp == NULL) {
        fprintf(stderr, "Cannot open \"%s\" in write mode.\n", fileName);
        return -1;
    }
    len = fwrite(&v, sizeof(double), 1, fp); 
    if (len != 1) {
        fclose(fp);
        fprintf(stderr, "Failed to write to \"%s\".\n", fileName);
        return -1;
    }
    fclose(fp);

    /* ファイルからの読み込み */
    fp = fopen(fileName, "rb");
    if (fp == NULL) {
        fprintf(stderr, "Cannot open \"%s\" in read mode.\n", fileName);
        return -1;
    }
    len = fread(&v, sizeof(double), 1, fp);
    if (len != 1) {
        fclose(fp);
        fprintf(stderr, "Failed to read from \"%s\".\n", fileName);
        return -1;
    }
    fclose(fp);
    printf("Read value: %f\n", v);
    printDoubleAsBigEndianHexBytes(v);

    return 0;
}

なお、標準Cの言語仕様では、の結果は規定されていない。の値がIEEE 754準拠の倍精度浮動小数点数表現であることも規定されておらず、エンディアンも規定されていない。そのため、上記のコードによって生成されたバイナリファイルが、異なるプラットフォームでも同じように読み込めるとは限らない。

 脚注 
 注釈 

 出典 

 関連項目 
 fread
 fputc
 標準Cライブラリ

 外部リンク 


Category:標準Cライブラリ

en:C file input/output#fwrite