free (функция)

free (с англ. — «освобождение») — функция стандартной библиотеки языка Си, предназначенная для освобождения ранее выделенной динамической памяти.

#include <stdlib.h>

void free (void *ptr);

Функция принимает указатель на область, подлежащую освобождению, или NULL. Возвращаемого значения не имеет. free() не проверяет указатель на правильность, и может «освободить» невыделенную область памяти, что в некоторых реализациях может привести к необратимому повреждению кучи (англ. heap). Вызов функции с NULL безопасен (проверка на NULL обязана выполняться внутри free() согласно стандарту). Для избежания повреждения кучи некоторые руководства по языку Си рекомендуют обнулять каждый освобождаемый указатель.

Область памяти, освобождённая после вызова free() может быть выделена снова, однако частый вызов malloc и free() может привести к фрагментации кучи и невозможности выделить области памяти большого объёма.

Функция объявлена в заголовочных файлах malloc.h, stdlib.h. Точное описание поведения функции приводится в стандарте ANSI C, на него же ссылается описание в стандарте POSIX.

• ptr — указатель на область памяти, предварительно выделенную malloc, calloc, realloc функциями либо NULL.

pointer = malloc(number_of_elements * sizeof(*pointer));

/* … проверка успешности выделения памяти, использование блока памяти … */

free(pointer);
pointer = NULL;

• malloc
• calloc
• realloc
• NULL
• Си (язык программирования)
• Стандартная библиотека
• Динамическая память
• Куча

• free — системные интерфейсы, The Single UNIX® Specification, выпуск 7 от The Open Group  (англ.)