©
本文档使用
php中文网手册 发布
在头文件<stdlib.h>中定义 | ||
|---|---|---|
void * calloc（size_t num，size_t size）; |
为具有num大小的对象数组分配内存size，并将分配的存储中的所有字节初始化为零。
如果分配成功，则返回一个指向已分配内存块中适用于任何对象类型的最低（第一个）字节的指针。
如果size为零，则行为是实现定义的（可能会返回空指针，或者可能会返回一些可能不用于访问存储的非空指针）。
calloc是线程安全的：它的行为就好像只访问通过其参数可见的内存位置，而不是任何静态存储。先前调用free或realloc来释放内存区域的同步 - 调用calloc来分配同一区域或同一区域内存的一部分。在通过解除分配函数访问内存之后和通过calloc访问内存之前，会发生此同步。所有分配和解除分配功能在内存的每个特定区域都有一个总的顺序。 | （自C11以来） |
|---|
在一个 | - | 对象的数量 |
|---|---|---|
尺寸 | - | 每个对象的大小 |
成功时，将指针返回到新分配的内存的开始位置。返回的指针必须用free()或来解除分配realloc()。
失败时，返回一个空指针。
由于对齐要求，分配的字节数不一定等于num*size。
初始化所有位为零并不保证浮点或指针将分别初始化为0.0和空指针值（尽管在所有常见平台上都是如此）。
最初（在C89中），增加了对零大小的支持以适应如下代码。
OBJ *p = calloc(0, sizeof(OBJ)); // "zero-length" placeholder...while(1) {
p = realloc(p, c * sizeof(OBJ)); // reallocations until size settles ... // code that may change c or break out of loop}#include <stdio.h>#include <stdlib.h>
int main(void){
int *p1 = calloc(4, sizeof(int)); // allocate and zero out an array of 4 int
int *p2 = calloc(1, sizeof(int[4])); // same, naming the array type directly
int *p3 = calloc(4, sizeof *p3); // same, without repeating the type name
if(p2) { for(int n=0; n<4; ++n) // print the array printf("p2[%d] == %d\n", n, p2[n]); }
free(p1); free(p2); free(p3);}输出：
p2[0] == 0p2[1] == 0p2[2] == 0p2[3] == 0
C11标准（ISO / IEC 9899：2011）：
7.22.3.2 calloc函数（p：348）
C99标准（ISO / IEC 9899：1999）：
7.20.3.1 calloc函数（p：313）
C89 / C90标准（ISO / IEC 9899：1990）：
4.10.3.1 calloc函数