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)); // "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] == 0
p2[1] == 0
p2[2] == 0
p2[3] == 0

参考

• C23 标准 (ISO/IEC 9899:2024)

• 7.22.3.2 calloc 函数 (p: TBD)

• C17 标准 (ISO/IEC 9899:2018)

• 7.22.3.2 calloc 函数 (p: 253)

• 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 函数

参阅

C++ 文档 用于 calloc