calloc

 

C

编译器支持

语言

头文件

类型支持

程序工具

变参数函数支持

错误处理

动态内存管理

字符串库

算法

数值

日期和时间工具

输入/输出支持

本地化支持

并发支持 (C11)

技术规范

符号索引

 

动态内存管理

malloc

calloc

realloc

free

free_sized (C23)

free_aligned_sized (C23)

aligned_alloc (C11)

 

在标头 <stdlib.h> 定义
void* calloc( size_t num, size_t size );

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

若分配成功，会返回指向分配内存块最低位（首位）字节的指针，它为任何具有基础对齐的对象类型适当地对齐。

若 size 为零，则行为是实现定义的（可返回空指针，或返回不可用于访问存储的非空指针）。

calloc 是线程安全的：它表现得如同只访问通过其参数可见的内存区域，而非任何静态存储。 解分配一块内存区域的先前 free、 free_sized 及 free_aligned_sized (C23 起) 或 realloc 调用同步于分配同一块或部分相同的内存区域的 calloc 调用。此同步出现于任何通过解分配函数所作的内存访问之后，和任何 calloc 所作出的内存访问之前。所有操作每块特定内存区域的分配和解分配函数拥有单独全序。

(C11 起)

参数

num	-	对象数目
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 的数组
    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

引用

• C23 标准（ISO/IEC 9899:2024）：

• 7.22.3.2 The calloc function （第 TBD 页）

• C17 标准（ISO/IEC 9899:2018）：

• 7.22.3.2 The calloc function （第 253 页）

• C11 标准（ISO/IEC 9899:2011）：

• 7.22.3.2 The calloc function （第 348 页）

• C99 标准（ISO/IEC 9899:1999）：

• 7.20.3.1 The calloc function （第 313 页）

• C89/C90 标准（ISO/IEC 9899:1990）：

• 4.10.3.1 The calloc function