命名空间
变体
操作

calloc

来自 cppreference.com
< c‎ | 内存
 
C
 
动态内存管理
 
定义在头文件 <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++ 文档 for calloc
检索自 "https://cppreference.cn/mwiki/index.php?title=c/memory/calloc&oldid=157923"