std::calloc
来自 cppreference.cn
| 定义于头文件 <cstdlib> |
||
| void* calloc( std::size_t num, std::size_t size ); |
||
分配一个由 num 个大小为 size 的对象组成的数组的内存，并将其初始化为全零比特（隐式地在目标区域创建对象）。
如果分配成功，则返回一个指向所分配内存块中最低（第一个）字节的指针，该指针已适当地对齐以用于任何对象类型。
如果 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
|
