fwrite
ja.cppreference.net から
| ヘッダで定義 <stdio.h>
|
||
size_t fwrite( const void* buffer, size_t size, size_t count,
FILE* stream );
|
(C99 まで) | |
size_t fwrite( const void* restrict buffer, size_t size, size_t count,
FILE* restrict stream );
|
(C99 以降) | |
書き込むcount のオブジェクトを指定された配列buffer から出力ストリームstream へ。オブジェクトは、各オブジェクトをunsigned char の配列として解釈し、呼び出しfputc size 回を各オブジェクトに対して行い、それらのunsigned char をstream に順に書き込むことによって書き込まれます。ストリームのファイル位置指示子は、書き込まれた文字数だけ進められます。
エラーが発生した場合、ストリームのファイル位置指示子の結果の値は不定です。
引数
| buffer | - | 書き込まれる配列の最初のオブジェクトへのポインタ |
| size | - | 各オブジェクトのサイズ |
| count | - | 書き込まれるオブジェクトの数 |
| stream | - | 出力ストリームへのポインタ |
戻り値
正常に書き込まれたオブジェクトの数。エラーが発生した場合にのみ count よりも小さくなります。
もし size または count がゼロの場合、fwrite はゼロを返し、それ以外の処理は行いません。
例
このコードを実行する
#include <assert.h>
#include <stdio.h>
#include <stdlib.h>
enum { SIZE = 5 };
int main(void)
{
double a[SIZE] = {1, 2, 3, 4, 5};
FILE* f1 = fopen("file.bin", "wb");
assert(f1);
size_t r1 = fwrite(a, sizeof a[0], SIZE, f1);
printf("wrote %zu elements out of %d requested\n", r1, SIZE);
fclose(f1);
double b[SIZE];
FILE* f2 = fopen("file.bin", "rb");
size_t r2 = fread(b, sizeof b[0], SIZE, f2);
fclose(f2);
printf("read back: ");
for (size_t i = 0; i < r2; ++i)
printf("%0.2f ", b[i]);
}
出力:
wrote 5 elements out of 5 requested
read back: 1.00 2.00 3.00 4.00 5.00
参考文献
- C23 標準 (ISO/IEC 9899:2024):
- 7.21.8.2 fwrite 関数 (p: TBD)
- C17 標準 (ISO/IEC 9899:2018):
- 7.21.8.2 fwrite 関数 (p: TBD)
- C11 標準 (ISO/IEC 9899:2011):
- 7.21.8.2 fwrite 関数 (p: 335-336)
- C99 標準 (ISO/IEC 9899:1999):
- 7.19.8.2 fwrite 関数 (p: 301-302)
- C89/C90 標準 (ISO/IEC 9899:1990):
- 4.9.8.2 fwrite 関数
関連項目
(C99)(C11)(C11)(C11)(C11) |
書式付き出力をstdout、ファイルストリーム、またはバッファに出力する （関数） |
| 文字列をファイルストリームに書き込む （関数） | |
| ファイルから読み込む （関数） | |
C++ のドキュメント の fwrite
| |