calloc

为 num 个大小为 size 的对象分配内存，并将已分配存储空间中的所有字节初始化为零。

若分配成功，返回指向已分配内存块中最低（首个）字节的指针，该内存块经过适当对齐，适用于任何具有 基础对齐 要求的对象类型。

如果 size 为零，其行为由实现定义（可能返回空指针，也可能返回某个不可用于访问存储的非空指针）。

参数

返回值

成功时，返回指向新分配内存起始位置的指针。为避免内存泄漏，必须使用 free() 或 realloc() 释放返回的指针。

失败时，返回空指针。

注释

由于对齐要求，分配的字节数不一定等于 num * size 。

将所有位初始化为零并不能保证浮点数或指针会分别被初始化为 0.0 和空指针值（尽管在所有常见平台上确实如此）。

最初（在C89中），添加对零大小的支持是为了适应诸如

OBJ* p = calloc(0, sizeof(OBJ)); // 零长度占位符
...
while(1)
{
    p = realloc(p, c * sizeof(OBJ)); // 持续重分配直到大小稳定
    ... // 可能改变c值或跳出循环的代码
}

示例

#include <stdio.h>
#include <stdlib.h>
int main(void)
{
    int* p1 = calloc(4, sizeof(int));    // 分配并清零包含4个整数的数组
    int* p2 = calloc(1, sizeof(int[4])); // 相同功能，直接指定数组类型
    int* p3 = calloc(4, sizeof *p3);     // 相同功能，无需重复类型名
    if (p2)
    {
        for (int n = 0; n < 4; ++n) // 打印数组内容
            printf("p2[%d] == %d\n", n, p2[n]);
    }
    free(p1);
    free(p2);
    free(p3);
}

p2[0] == 0
p2[1] == 0
p2[2] == 0
p2[3] == 0

参考文献

参阅