free

malloc() 、 calloc() 、 aligned_alloc() 、 (C11以降) または realloc() によって以前に割り当てられた領域を解放します。

ptr がnullポインタの場合、この関数は何も行いません。

ptr の値が、以前に malloc() 、 calloc() 、 realloc() 、または aligned_alloc() (C11以降) によって返された値と等しくない場合、動作は未定義です。

ptr が参照するメモリ領域が既に解放されている場合、すなわち、 free() , free_sized() , free_aligned_sized() (C23以降) もしくは realloc() が既に ptr を引数として呼び出され、その後 malloc() 、 calloc() 、 realloc() 、もしくは aligned_alloc() (C11以降) の呼び出しによって ptr と等しい値のポインタが返されていない場合、動作は未定義です。

free() が返った後、 ptr を通じてアクセスが行われる場合（別の割り当て関数がたまたま ptr と等しいポインタ値を返した場合を除く）、動作は未定義です。

パラメータ

戻り値

(なし)

注記

この関数は、特殊ケースの量を減らすために（何も行わずに）nullポインタを受け入れます。アロケーションが成功するかどうかにかかわらず、アロケーション関数によって返されたポインタは free() に渡すことができます。

例

#include <stdlib.h>
int main(void)
{
    int *p1 = malloc(10*sizeof *p1);
    free(p1); // 割り当てられたすべてのポインタは解放されなければならない
    int *p2 = calloc(10, sizeof *p2);
    int *p3 = realloc(p2, 1000*sizeof *p3);
    if(p3) // p3がnullでない場合、p2はreallocによって解放されたことを意味する
       free(p3);
    else // p3がnullの場合、p2は解放されなかったことを意味する
       free(p2);
}

参考文献

関連項目