WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

free — C23-Speicherfunktion

`free(ptr)` aus `<stdlib.h>` gibt den von `ptr` bezeichneten Speicher frei und macht ihn erneut für Allokationen verfügbar; bei null geschieht nichts und es gibt keinen Rückgabewert. Ein Zeiger ungleich null muss von einer kompatiblen Speicherfunktion stammen und eine lebende Allokation bezeichnen.

Version: C23

Syntax

void free(void *ptr);

free(ptr) aus <stdlib.h> gibt den von ptr bezeichneten Speicher frei und macht ihn erneut für Allokationen verfügbar; bei null geschieht nichts und es gibt keinen Rückgabewert. Ein Zeiger ungleich null muss von einer kompatiblen Speicherfunktion stammen und eine lebende Allokation bezeichnen.

Das Beispiel reserviert vier int mit malloc, speichert 1 bis 4, berechnet und druckt 10 und ruft genau einmal free auf. Danach wird das Array weder gelesen noch erneut freigegeben.

Innenzeiger, automatischer Speicher, inkompatibler Allokator oder bereits freigegebener Speicher führen zu undefiniertem Verhalten. Nach free ist Zugriff über jeden alten Alias ungültig; einen lokalen Zeiger auf null zu setzen schützt nur diesen Alias. C ordnet die Freigabe vor einer späteren Allokation desselben Bereichs.

Beispiele

#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;}

Ergebnis

10

Das Beispiel reserviert vier `int` mit `malloc`, speichert 1 bis 4, berechnet und druckt `10` und ruft genau einmal `free` auf. Danach wird das Array weder gelesen noch erneut freigegeben.

Quellen