calloc

< c‎ | memory
定义于头文件 <stdlib.h>
void* calloc( size_t num, size_t size );

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

若分配成功,会返回指向分配内存块最低位(首位)字节的指针,它为任何类型适当地对齐。

size 为零,则行为是实现定义的(可返回空指针,或返回不可用于访问存储的非空指针)。

calloc 是线程安全的:它表现得如同只访问通过其参数可见的内存区域,而非任何静态存储。

freerealloc 解分配一块内存区域的先前调用,同步于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

引用

  • C11 standard (ISO/IEC 9899:2011):
  • 7.22.3.2 The calloc function (p: 348)
  • C99 standard (ISO/IEC 9899:1999):
  • 7.20.3.1 The calloc function (p: 313)
  • C89/C90 standard (ISO/IEC 9899:1990):
  • 4.10.3.1 The calloc function

参阅