calloc

使用初始化为 0 的元素分配内存中的数组。

语法

void *calloc(
   size_t number,
   size_t size
);

参数

number
元素数量。

size
每个元素的长度（以字节为单位）。

返回值

calloc 返回指向已分配空间的指针。 返回值指向的存储空间与任何类型的对象的存储适当对齐。 若要获取指向类型而非 void 的指针，请在返回值中使用类型转换。

备注

calloc 函数为 number 元素的数组分配存储空间，每个长度为 size 字节。 将每个元素初始化为 0。

如果内存分配失败或请求的内存量超过 _HEAP_MAXREQ，calloc 会将 errno 设置为 ENOMEM。 有关此错误代码和其他错误代码的信息，请参阅 errno、_doserrno、_sys_errlist 和 _sys_nerr。

在 Microsoft 实现中，如果 number 或 size 为零，则 calloc 返回指向非零大小的已分配块的指针。 尝试通过返回的指针读取或写入会导致未定义的行为。

calloc 使用 C++ _set_new_mode 函数设置新的处理程序模式。 新的处理程序模式将指示 calloc 是否在失败时调用由 _set_new_handler 设置的新处理程序例程。 默认情况下，calloc 在失败时不调用新的处理程序例程来分配内存。 可以替代此默认行为，以便在 calloc 无法分配内存时，它可以调用新的处理程序例程，方法与 new 运算符出于相同原因无法分配内存时所执行的操作一样。 若要替代默认值，请在程序的早期调用：

_set_new_mode(1);

或链接到 NEWMODE.OBJ（请参阅链接选项）。

当应用程序与调试版的 C 运行时库链接时，calloc 将解析为 _calloc_dbg。 有关在调试过程中如何托管堆的详细信息，请参阅 CRT 调试堆。

calloc 被标记为 __declspec(noalias) 和 __declspec(restrict)，也就是说确保该函数不能修改全局变量，并且指针返回不使用别名。 有关详细信息，请参阅 noalias 和 restrict。

默认情况下，此函数的全局状态范围限定为应用程序。 若要更改此行为，请参阅 CRT 中的全局状态。

要求

例程	必需的标头
calloc	<stdlib.h> 和 <malloc.h>

有关兼容性的详细信息，请参阅 兼容性。

示例

// 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

另请参阅

内存分配
free
malloc
realloc