命名空间
变体
操作

std::calloc

来自 cppreference.com
< cpp‎ | memory‎ | c
 
 
实用程序库
语言支持
类型支持 (基本类型,RTTI)
库功能测试宏 (C++20)
动态内存管理
程序实用程序
协程支持 (C++20)
可变参数函数
调试支持
(C++26)
三路比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用实用程序
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (在 C++20 中已弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型操作
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
通用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
基本字符串转换
(C++17)
(C++17)

 
动态内存管理
未初始化内存算法
受约束的未初始化内存算法
分配器
垃圾收集支持
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)
(C++11)(直到 C++23)



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

为大小为 sizenum 个对象分配内存,并将它们初始化为全零位 (隐式创建 目标区域中的对象)。

如果分配成功,则返回指向分配的内存块中最低 (第一个) 字节的指针,该指针适合任何对象类型的对齐。

如果 size 为零,则行为由实现定义(可以返回空指针,也可以返回一些非空指针,这些指针可能无法用于访问存储)。

以下函数需要是线程安全的

分配或释放特定存储单元的这些函数调用按单个总顺序发生,并且每个这样的释放调用 发生之前 此顺序中的下一个分配(如果有)。

(自 C++11 起)

内容

[编辑] 参数

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

[编辑] 返回值

成功时,返回指向新分配的内存开头的指针。为了避免内存泄漏,返回的指针必须使用 std::free()std::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 <cstdlib>
#include <iostream>
 
int main()
{
    int* p1 = (int*)std::calloc(4, sizeof(int)); // allocate and zero out an array of 4 int
    int* p2 = (int*)std::calloc(1, sizeof(int[4])); // same, naming the array type directly
    int* p3 = (int*)std::calloc(4, sizeof *p3); // same, without repeating the type name
 
    if (p2)
        for (int n = 0; n < 4; ++n) // print the array
            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 文档calloc