std::calloc
來自 cppreference.com
| 定義於標頭檔案 <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
|
