WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

calloc — C23-Allokationsfunktion

`calloc(nmemb, size)` aus `<stdlib.h>` reserviert ein Array aus `nmemb` Objekten zu je `size` Byte, setzt jedes Bit des Bereichs auf null und liefert dessen Zeiger oder null. C23 verlangt auch null, wenn `nmemb * size` in `size_t` umlaufen würde.

Version: C23

Syntax

void *calloc(size_t nmemb, size_t size);

calloc(nmemb, size) aus <stdlib.h> reserviert ein Array aus nmemb Objekten zu je size Byte, setzt jedes Bit des Bereichs auf null und liefert dessen Zeiger oder null. C23 verlangt auch null, wenn nmemb * size in size_t umlaufen würde.

Die Funktion eignet sich für ein dynamisches Array mit genullter Anfangsdarstellung. Das Beispiel reserviert vier int, prüft den Fehlerfall, liest wirklich vier Anfangsnullen und gibt genau diesen Block mit free frei.

Nullbits müssen weder Gleitkomma-0.0 noch einen Nullzeiger darstellen; calloc ist daher keine universelle Typinitialisierung. Bei Größe null darf die Implementierung null oder einen besonderen nicht dereferenzierbaren Zeiger liefern; vor Zugriff prüfen und erfolgreiche Allokationen freigeben.

Beispiele

#include <stdio.h>
#include <stdlib.h>

int main(void) {
    int *values = calloc(4, sizeof *values);
    if (values == NULL) return 1;
    printf("%d %d %d %d\n", values[0], values[1], values[2], values[3]);
    free(values);
    return 0;
}

Ergebnis

0 0 0 0

Die Funktion eignet sich für ein dynamisches Array mit genullter Anfangsdarstellung. Das Beispiel reserviert vier `int`, prüft den Fehlerfall, liest wirklich vier Anfangsnullen und gibt genau diesen Block mit `free` frei.

Quellen