std::free

 

C++

Язык

Заголовочные файлы

Концепты

Поддержка языка

Ошибка

Утилиты

Строки

Контейнеры

Алгоритмы

Итераторы

Работа с числами

Ввод/вывод

Локализация

Регулярные выражения (C++11)

Атомарные операции (C++11)

Потоки (C++11)

Файловая система (C++17)

Технические спецификации

 

Утилиты библиотеки

Поддежка типов (базовые типы, RTTI, type traits)

Динамическое управление памятью

Обработка ошибок

Управление жизненным циклом программы

Функции с переменным числом аргументов

Дата и время

Функциональные объекты

initializer_list Шаблон:lines

bitset

hash Шаблон:lines

Реляционные операторы

rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>=

Пары и кортежи

pair

tuple Шаблон:lines

piecewise_construct_t Шаблон:lines

piecewise_construct Шаблон:lines

Обмен, передача и перемещение

swap

forward Шаблон:lines

move Шаблон:lines

move_if_noexcept Шаблон:lines

declval Шаблон:lines

 

Динамическое управление памятью

Низкоуровневое управление памятью
Аллокаторы
allocator
allocator_traits Шаблон:lines
allocator_arg_t Шаблон:lines
allocator_arg Шаблон:lines
uses_allocator Шаблон:lines
scoped_allocator_adaptor Шаблон:lines
Неинициализированные хранилища
uninitialized_copy
uninitialized_copy_n Шаблон:lines
uninitialized_fill
uninitialized_fill_n
raw_storage_iterator
get_temporary_buffer
return_temporary_buffer
Умные указатели
unique_ptr Шаблон:lines
shared_ptr Шаблон:lines
weak_ptr Шаблон:lines
auto_ptr Шаблон:lines
owner_less Шаблон:lines
enable_shared_from_this Шаблон:lines
bad_weak_ptr Шаблон:lines
default_delete Шаблон:lines
Поддержка сборки мусора
declare_reachable Шаблон:lines
undeclare_reachable Шаблон:lines
declare_no_pointers Шаблон:lines
undeclare_no_pointers Шаблон:lines
pointer_safety Шаблон:lines
get_pointer_safety Шаблон:lines
Разное
pointer_traits Шаблон:lines
addressof Шаблон:lines
align Шаблон:lines
Библиотека C
malloc calloc	realloc free

 

Defined in header <cstdlib>
void free( void* ptr );

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

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

Её поведение не определено, если значение ptr не равно полученному ранее от std::malloc(), std::calloc() или std::realloc(), а также если память по указателю ptr была уже очищена с помощью std::free() или std::realloc(), но никаких других вызовов std::malloc(), std::calloc() или std::realloc(), порождающих этот указатель не было сделано.

Поведение не определено, если после возврата из std::free() был произведён доступ по указателю ptr (только если не был произведён вызов функции распределения памяти, породивший указатель равный ptr)

Параментры

ptr

—

указатель для очистки памяти

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

(нет)

Примечание

Функция принимает (и ничего не делает) с нулевым указателем, чтобы сократить количество специальных преобразований. Успешно распределение было или нет, указатель, возвращённый выделяющими память функциями, безопасно передавать в free().

Пример

Запустить этот код

#include <cstdlib>
 
int main()
{
    int* p1 = (int*)std::malloc(10*sizeof *p1);
    std::free(p1); // После каждого выделения, указатель должен быть освобождён
 
    int* p2 = (int*)std::calloc(10, sizeof *p2);
    int* p3 = (int*)std::realloc(p2, 1000*sizeof *p3);
    if(p3) // p3 не нулевой указатель, а значит p2 освободил std::realloc
       std::free(p3);
    else // p3 - нулевой указатель, а значит p2 не освободил std::realloc
       std::free(p2);
}

См. также

Справка по C — free