calloc

Artículo
04/10/2013

Asigna una matriz en memoria con elementos inicializado a 0.

void *calloc( 
   size_t num,
   size_t size 
);

Parámetros

num
número de elementos.
size
longitud en bytes de cada elemento.

Valor devuelto

calloc devuelve un puntero al espacio asignado.El espacio de almacenamiento designado por el valor devuelto se garantiza que sea sencilla alineadas para el almacenamiento de cualquier tipo de objeto.Para obtener un puntero a un tipo distinto de void, utilice una conversión de tipo del valor devuelto.

Comentarios

La función de calloc asigna espacio de almacenamiento para una matriz de elementos de num , cada uno de los bytes de size de longitud.Cada elemento se inicializa en 0.

calloc establece errno a ENOMEM si se produce una asignación de memoria o si la cantidad de memoria solicitada supera _HEAP_MAXREQ.Para obtener información sobre estos y otros códigos de error, vea errno, _doserrno, _sys_errlist, y _sys_nerr.

llamadas malloc decalloc para usar la función de C++ _set_new_mode para establecer el nuevo modo de controlador.El nuevo modo de controlador indica si, en el error, malloc es llamar a la nueva rutina de controlador como lo establece _set_new_handler.De forma predeterminada, malloc no llama a la nueva rutina de controlador en el error asignar memoria.Puede invalidar este comportamiento predeterminado para que, cuando calloc no puede para asignar memoria, malloc llame a la nueva rutina del controlador de la misma manera que el operador de new cuando falla por la misma razón.Para reemplazar el valor predeterminado, llame a

_set_new_mode(1)

al principio del programa, o vínculo con NEWMODE.OBJ (vea Opciones de vínculo).

Cuando la aplicación se vincula con una versión de depuración de las bibliotecas en tiempo de ejecución de C, calloc resuelve a _calloc_dbg.Para obtener más información sobre cómo la pila se administra durante el proceso de depuración, vea El montón de depuración de CRT.

calloc es __declspec(noalias) marcado y __declspec(restrict), lo que significa que la función está garantizada para no modificar variables globales, y que el puntero devuelto no es con alias.Para obtener más información, vea noalias y limitado.

Requisitos

rutina	Encabezado necesario
calloc	<stdlib.h> y <malloc.h>

Para obtener información adicional de compatibilidad, vea compatibilidad en la Introducción.

Ejemplo

// 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 );
}