free

Освобождает пространство, ранее выделенное с помощью malloc() , calloc() , aligned_alloc() , (начиная с C11) или realloc() .

Если ptr является нулевым указателем, функция ничего не делает.

Поведение не определено, если значение ptr не равно значению, возвращённому ранее функцией malloc() , calloc() , realloc() , или aligned_alloc() (начиная с C11) .

Поведение не определено, если область памяти, на которую ссылается ptr , уже была освобождена, то есть, free() , free_sized() , free_aligned_sized() (since C23) , или realloc() уже была вызвана с ptr в качестве аргумента и после этого не было вызовов malloc() , calloc() , realloc() , или aligned_alloc() (since C11) , которые вернули бы указатель, равный ptr .

Поведение не определено, если после возврата из free() осуществляется доступ через указатель ptr (если только другая функция выделения памяти случайно не вернула значение указателя, равное ptr ).

Параметры

Возвращаемое значение

(нет)

Примечания

Функция принимает (и ничего не делает с) нулевым указателем для уменьшения количества особых случаев. Независимо от того, успешно ли выделение памяти или нет, указатель, возвращаемый функцией выделения, может быть передан в 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);
}

Ссылки

Смотрите также