calloc

Aloca uma matriz na memória com elementos inicializados como 0.

Sintaxe

void *calloc(
   size_t number,
   size_t size
);

Parâmetros

number
Número de elementos.

size
O comprimento, em bytes, de cada elemento.

Retornar valor

calloc retorna um ponteiro para o espaço alocado. O espaço de armazenamento apontado pelo valor de retorno é adequadamente alinhado para armazenamento de qualquer tipo de objeto. Para obter um ponteiro para um tipo que não seja void, use uma conversão de tipo no valor retornado.

Comentários

A função calloc aloca espaço de armazenamento para uma matriz de number elementos, cada um com um tamanho de size bytes. Cada elemento é inicializado como 0.

calloc definirá errno como ENOMEM se uma alocação de memória falhar ou se a quantidade de memória solicitada exceder _HEAP_MAXREQ. Para obter informações sobre esse e outros códigos de erro, confira errno, _doserrno, _sys_errlist e _sys_nerr.

Na implementação da Microsoft, se number ou size for zero, calloc retorna um ponteiro para um bloco alocado de tamanho diferente de zero. Uma tentativa de ler ou gravar por meio do ponteiro retornado leva a um comportamento indefinido.

calloc usa a função _set_new_mode C++ para definir o novo modo de manipulador. O novo modo do manipulador indica se, em caso de falha, calloc deverá chamar a nova rotina do manipulador, conforme definido por _set_new_handler. Por padrão, calloc não chama a nova rotina do manipulador em caso de falha ao alocar memória. Você pode substituir esse comportamento padrão para que, quando calloc falhar ao alocar memória, ele chame a nova rotina do manipulador da mesma forma que o operador new fará quando ele falhar pelo mesmo motivo. Para substituir o padrão, chame

_set_new_mode(1);

no início do programa ou vincule-se a NEWMODE.OBJ (consulte Opções de link).

Quando o aplicativo estiver vinculado a uma versão de depuração das bibliotecas de runtime do C, calloc será resolvido como _calloc_dbg. Para obter mais informações sobre como o heap é gerenciado durante o processo de depuração, consulte O heap de depuração CRT.

calloc é marcado como __declspec(noalias) e __declspec(restrict), o que representa a garantia de que a função não modifica variáveis globais e que o ponteiro retornado não é um alias. Para obter mais informações, consulte noalias e restrict.

Por padrão, o estado global dessa função tem como escopo o aplicativo. Para alterar esse comportamento, consulte Estado global na CRT.

Requisitos

Rotina	Cabeçalho necessário
calloc	<stdlib.h> e <malloc.h>

Para obter informações sobre compatibilidade, consulte Compatibilidade.

Exemplo

// crt_calloc.c
// This program uses calloc to allocate space for
// 40 long integers. It initializes each element to zero.

#include <stdio.h>
#include <malloc.h>

int main( void )
{
   long *buffer;

   buffer = (long *)calloc( 40, sizeof( long ) );
   if( buffer != NULL )
      printf( "Allocated 40 long integers\n" );
   else
      printf( "Can't allocate memory\n" );
   free( buffer );
}

Allocated 40 long integers

Confira também

Alocação de memória
free
malloc
realloc