関数CKfwrite マニュアル

(The documentation of function CKfwrite)
Last Update: 2023/4/11


◆機能・用途(Purpose)

関数fwrite(ファイルへのバイナリデータの書き込み)をエラーチェック付きで実行する。
Call function fwrite (writing a binary data into a file) with error checks.

◆形式(Format)

#include <functions_with_errcheck.h>
inline void CKfwrite (const void ∗ptr,int size,int n,FILE ∗stream)


◆引数(Arguments)

ptr 出力するデータの先頭アドレス。 変数型はvoid型でなくても良い。
The first address of the data to output. The variable type may not be void-type.
size 出力するデータ型の1データあたりのサイズ(バイト数)。
The size (the number of bytes) of each data sample to output.
n 出力するデータ数。
The number of data to output.
stream 出力先のファイルのファイルポインタ。
The file pointer of the file to write.


◆動作とエラーチェック (Behaviour and error checks)

下表で桃色のセルがエラー処理を表す。
The pick colored cells in the table below represent error checks.
条件
Condition 		動作
Behaviour of the function
ptr=NULL プログラムをエラー終了する。
The program finishes as an error.
size≤0 プログラムをエラー終了する。
The program finishes as an error.
n≤0 プログラムをエラー終了する。
The program finishes as an error.
stream=NULL プログラムをエラー終了する。
The program finishes as an error.
関数fwriteの戻り値(出力したデータ数)<nとなった。
The return value of function fwrite (the number of data written) was less than n. 		プログラムをエラー終了する。
The program finishes as an error.
上記以外の場合
The other cases 		関数fwriteを用いてptrに格納されたsizeバイトのデータn個を streamに出力する。
Write n data of size bytes in ptr to stream using function fwrite.


◆使用例(Example)

int single_variable_int=1;
double array_double[5]={2.3,4.5,6.7,8.9,10.1};
char string[11]="abcdefghij"
FILE ∗fp=fopen("data.dat","wb");
CKfwrite(&single_variable_int,sizeof(int),1,fp);
CKfwrite(array_double,sizeof(double),5,fp);
CKfwrite(string,sizeof(char),10,fp);
fclose(fp);