free

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

メモリブロックを解放します。

void free( 
   void *memblock 
);

パラメータ

memblock
解放する割り当て済みメモリブロック。

解説

free 関数は、calloc、malloc、または realloc への呼び出しによって割り当てられたメモリブロック (memblock) を解放します。解放されるバイト数は、ブロック割り当て時 (realloc の場合は再割り当て時) に要求されたバイト数に相当します。memblock が NULL の場合、ポインタは無視され、free からすぐに制御が戻ります。無効なポインタ (calloc、malloc、または realloc によって割り当てられていないメモリブロックへのポインタ) を解放しようとすると、以降の割り当て要求に影響し、エラーが発生する場合があります。

Visual C++ 2005 では、メモリの解放時にエラーが発生した場合、errno は、エラーの原因に関するオペレーティングシステムからの情報と共に設定されます。詳細については、「errno、_doserrno、_sys_errlist、および _sys_nerr」を参照してください。

メモリブロックが解放されると、_heapmin が未使用の領域をつなぎ合わせ、オペレーティングシステムに戻し、ヒープの空きメモリの量を最小化します。解放されたメモリのうち、オペレーティングシステムに戻されなかったメモリは、空きプールに復元され、再度割り当てに使用できるようになります。

アプリケーションを C ランタイムライブラリのデバッグバージョンとリンクすると、free は _free_dbg に置き換わります。デバッグ中のヒープの処理方法の詳細については、「CRT デバッグヒープ」を参照してください。

free には、__declspec(noalias) のマークが付けられます。これは、この関数がグローバル変数を変更しないことを意味します。詳細については、「noalias」を参照してください。

_malloca によって割り当てたメモリを解放する場合は、_freea を使用します。