Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C

calloc — função de alocação C23

`calloc(nmemb, size)` de `<stdlib.h>` aloca um array de `nmemb` objetos com `size` bytes, põe a zero todos os bits da região e devolve o ponteiro ou null. C23 também exige null se o produto `nmemb * size` desse wrap em `size_t`.

Versão: C23

Sintaxe

void *calloc(size_t nmemb, size_t size);

calloc(nmemb, size) de <stdlib.h> aloca um array de nmemb objetos com size bytes, põe a zero todos os bits da região e devolve o ponteiro ou null. C23 também exige null se o produto nmemb * size desse wrap em size_t.

Usa-a para um array dinâmico cuja representação deve começar a zero. O exemplo aloca quatro int, verifica falha, lê realmente os quatro zeros iniciais e liberta exatamente esse bloco com free.

Todos os bits a zero não têm de representar 0.0 flutuante nem ponteiro nulo, por isso calloc não é inicialização tipada universal. Para tamanho zero a implementação pode devolver null ou ponteiro especial não desreferenciável; verifica null antes do acesso e liberta qualquer alocação bem-sucedida.

Exemplos

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

Resultado

0 0 0 0

Usa-a para um array dinâmico cuja representação deve começar a zero. O exemplo aloca quatro `int`, verifica falha, lê realmente os quatro zeros iniciais e liberta exatamente esse bloco com `free`.

Fontes