CKTIS / C
free — paměťová funkce C23
`free(ptr)` z `<stdlib.h>` uvolní úložiště označené `ptr` pro další alokace; null nezpůsobí žádnou akci a funkce nic nevrací. Nenulový ukazatel musí pocházet z kompatibilní paměťové funkce a stále označovat živou alokaci.
Verze: C23
Syntaxe
void free(void *ptr);free(ptr) z <stdlib.h> uvolní úložiště označené ptr pro další alokace; null nezpůsobí žádnou akci a funkce nic nevrací. Nenulový ukazatel musí pocházet z kompatibilní paměťové funkce a stále označovat živou alokaci.
Příklad alokuje čtyři int pomocí malloc, uloží 1 až 4, vypočte a vytiskne 10 a právě jednou zavolá free. Poté pole nečte ani se je nepokusí znovu uvolnit.
Vnitřní ukazatel, automatické úložiště, nekompatibilní alokátor či již uvolněná alokace znamená nedefinované chování. Po free je přístup přes každý starý alias neplatný; nastavení jednoho lokálního ukazatele na null chrání jen jej. C řadí uvolnění před pozdější alokaci stejné oblasti.
Příklady
#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;}
Výsledek
10
Příklad alokuje čtyři `int` pomocí `malloc`, uloží 1 až 4, vypočte a vytiskne `10` a právě jednou zavolá `free`. Poté pole nečte ani se je nepokusí znovu uvolnit.