std::calloc

定义于头文件 `<cstdlib>`
void* calloc( std::size_t num, std::size_t size );

分配 num 个大小为 size 的对象的数组，并初始化所有位为零。

若分配成功，则返回指向为任何对象类型适当对齐的，被分配内存块最低（首）字节的指针。

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

要求下列函数是线程安全的：

operator new 及 operator delete 的库版本
全局 operator new 与 operator delete 的用户替换版本
std::calloc 、 std::malloc 、 std::realloc 、 std::aligned_alloc (C++17 起) 、 std::free

对这些分配或解分配特定存储单元的函数调用以单独全序出现，并且在此顺序中，每个解分配调用先发生于下个分配（若存在）。

(C++11 起)

参数

num	-	对象数量
size	-	每个对象的大小

返回值

成功时，返回指向新分配内存起始的指针。返回的指针必须以 std::free() 或 std::realloc() 解分配。

失败时，返回空指针。

注意

因为对齐要求，分配的字节数不需要等于 num*size 。

将所有位初始化为零不保证浮点数或指针各被初始化到 0.0 与空指针值（尽管大多数平台上这为 true ）

最初（ C89 中），添加对零大小的支持是为了接纳下面这种代码

OBJ *p = calloc(0, sizeof(OBJ)); // “零长度”占位
...
while(1) { 
    p = realloc(p, c * sizeof(OBJ)); // 重分配直至大小稳定
    ... // 可能更改 c 或打破循环的代码
}

示例

运行此代码

#include <iostream>
#include <cstdlib>
 
int main()
{
    int* p1 = (int*)std::calloc(4, sizeof(int)); // 分配并清零 4 个 int 的数组
    int* p2 = (int*)std::calloc(1, sizeof(int[4])); // 同上，直接指名数组类型
    int* p3 = (int*)std::calloc(4, sizeof *p3);   // 同上，不重复类型名
 
    if(p2)
        for(int n=0; n<4; ++n) // 打印数组
            std::cout << "p2[" << n << "] == " << p2[n] << '\n';
 
    std::free(p1);
    std::free(p2);
    std::free(p3);
}

输出：

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

语言
标准库头文件
自立与有宿主实现
具名要求
语言支持库
概念库 (C++20)
诊断库
工具库
字符串库
容器库
迭代器库
范围库 (C++20)
算法库
数值库
本地化库
输入/输出库
文件系统库 (C++17)
正则表达式库 (C++11)
原子操作库 (C++11)
线程支持库 (C++11)
技术规范

std::calloc

参数

返回值

注意

示例

参阅

导航