Everything

free 【V1.02以降】


メモリを解放します。

[所属]

標準ライブラリ

[指定形式]

#include <stdlib.h>

void __far free(void __near *ptr);

[詳細説明]

ptrが指す領域を解放します。ptrがnullポインタである場合は何もしません。それ以外で,ptrがcalloc,malloc,およびreallocで割り付けた領域でない場合,または,ptrがfreeおよびreallocによって既に解放されていた場合,動作を保証しません。

 

【Professional版のみ】 【V1.03以降】

セキュリティ機能用malloc系ライブラリを使用する場合,次の操作を行った場合に__heap_chk_fail関数を呼び出します。

-

calloc,malloc,reallocで割り付けた領域以外のポインタをfree,reallocに渡す。

-

freeで開放した後のポインタを再度free,reallocに渡す。

-

calloc,malloc,reallocで割り当てた領域の外側(前後各2バイト)に何らかの値を書き込んだ後,割り当てた領域を指すポインタをfree,reallocに渡す。

 

__heap_chk_fail関数はユーザが定義する必要があり,動的メモリ管理の異常時に実行する処理を記述します。

__heap_chk_fail関数を定義する際には,次の項目に注意してください。

-

__heap_chk_fail関数は,返却値および引数の型がvoid型のfar関数とします。
void __far __heap_chk_fail(void);

-

__heap_chk_fail関数は,static関数にしないでください。

-

__heap_chk_fail関数内で再帰的にヒープ・メモリ領域の破壊を検出しないでください。

 

セキュリティ機能用のcalloc,malloc,およびreallocは,領域外への書き込みを検出するために前後各2バイト余分に領域を割り当てます。このため,通常より多くヒープ・メモリ領域を消費します。