関数CKfree マニュアル

(The documentation of function CKfree)
Last Update: 2023/4/10


◆機能・用途(Purpose)

関数free(配列の動的メモリの解放)をエラーチェック付きで実行する。
Call function free (releasing the dynamic memory of an array) with error checks.

◆形式(Format)

#include <functions_with_errcheck.h>
inline void CKfree(void ∗∗ptr)


◆引数(Arguments)

ptr 動的メモリを解放したいポインタ変数のアドレス。 ポインタ変数に更に&を付け、void ∗∗型に変換して渡す。
The address of a pointer variable whose dynamic memory is to be released. Append & to a pointer variable and cast to void ∗∗-type.


◆動作とエラーチェック (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.
上記以外の場合
The other cases 		∗ptrが指す配列の動的メモリを解放する。 その上で、メモリ解放済みであることが後で分かるように ∗にNULLを代入する。
Release the dynamic memory of an array pointed by ∗ptr. In addition, NULL is inserted to ∗ptr to indicate that the dynamic memory of this array has already been released.


◆使用例(Example)

int ∗array=(int ∗)CKcalloc(10,sizeof(int));
CKfree((void ∗∗)&array);


◆補足(Additional notes)

関数freeとは引数の形式が異なる。
The format of the argument is different from that of function free.