CKTIS / C
free — funkcja pamięci C23
`free(ptr)` z `<stdlib.h>` zwalnia obszar pamięci wskazany przez `ptr`, udostępniając go ponownie funkcjom alokującym; dla null nic nie robi i niczego nie zwraca. Wskaźnik nie-null musi pochodzić z odpowiedniej funkcji zarządzania pamięcią i nadal oznaczać żywą alokację.
Wersja: C23
Składnia
void free(void *ptr);free(ptr) z <stdlib.h> zwalnia obszar pamięci wskazany przez ptr, udostępniając go ponownie funkcjom alokującym; dla null nic nie robi i niczego nie zwraca. Wskaźnik nie-null musi pochodzić z odpowiedniej funkcji zarządzania pamięcią i nadal oznaczać żywą alokację.
Przykład przydziela przez malloc cztery int, zapisuje wartości 1–4, oblicza sumę, wypisuje 10, a następnie dokładnie raz wywołuje free. Kod nie odczytuje już tablicy ani nie próbuje jej ponownie zwalniać.
Przekazanie wskaźnika do wnętrza obiektu, pamięci automatycznej, niezgodnego alokatora albo już zwolnionej alokacji ma niezdefiniowane zachowanie. Po free wszystkie dostępy przez stare aliasy są niedozwolone; przypisanie lokalnego wskaźnika do null pomaga tylko temu jednemu aliasowi. C porządkuje zwolnienie i późniejszą alokację ponownie używającą tego samego regionu.
Przykłady
#include <stdio.h>
#include <stdlib.h>
int main(void){int *values=malloc(4*sizeof *values);if(!values)return 1;int sum=0;for(int i=0;i<4;i++){values[i]=i+1;sum+=values[i];}printf("%d\n",sum);free(values);return 0;}
Wynik
10
Przykład przydziela przez `malloc` cztery `int`, zapisuje wartości 1–4, oblicza sumę, wypisuje `10`, a następnie dokładnie raz wywołuje `free`. Kod nie odczytuje już tablicy ani nie próbuje jej ponownie zwalniać.