_recalloc
realloc 和 calloc 的組合。 重新配置在記憶體中建立陣列並初始化其元素為 0。
void *_recalloc(
void *memblock
size_t num,
size_t size
);
參數
memblock
指向先前配置的記憶體區塊的指標。num
項目數。size
每個項目的位元組長度。
傳回值
_recalloc 傳回 void 指標到重新配置 (和可捲動) 的記憶體區塊。
如果沒有將區塊展開成足夠特定大小的可用記憶體，原始的區塊會保持不變，因此會傳回 NULL 。
如果要求的大小為零，則被 memblock 指向的區塊被釋放；傳回值為 NULL，且 memblock 會保留指向其釋放區塊。
傳回值指向保證可以儲存任何型別的物件的適當地對齊的儲存空間。 若要得到 void 之外的型別指標，請在傳回值上使用型別轉換。
備註
_recalloc 函式變更配置記憶體區塊的大小。 對記憶體區塊的起始 memblock 引數指向記憶體區塊的起始。 如果 memblock 是 NULL，recalloc ) 產生行為與 calloc相同，並且配置一個 num * size 位元組的新區塊。 每個元素初始化為 0。 如果 memblock 不是 NULL，它應該是先前呼叫 calloc 所傳回的指標、malloc或 realloc。
由於新的區塊可以在新的記憶體位置，recalloc 傳回的指標不保證是透過 memblock 引數傳遞的指標。
如果記憶體配置失敗，或是要求的記憶體數量超過 _HEAP_MAXREQ，則 _recalloc 會將 errno 設定為 ENOMEM。 如需有關這個錯誤碼及其他錯誤碼的詳細資訊，請參閱 errno、_doserrno、_sys_errlist 和 _sys_nerr。
recalloc 會呼叫 realloc 以使用 C++ _set_new_mode 函來設定新的處理常式模式。 新的處理常式模式表示，失敗時，realloc 是否要呼叫由 _set_new_handler 設定的新處理常式。 根據預設， realloc 不會在無法配置記憶體時呼叫新的處理常式。 您可以覆寫這個預設行為，因此，當 recalloc 無法配置記憶體時，realloc 會以 new 運算子因為相同原因失敗時的相同方式，呼叫新處理常式。 若要覆寫預設值，請呼叫
_set_new_mode(1)
及早在您的程式中呼叫，或與 NEWMODE.OBJ 連結。
當應用程式使用 C 執行期程式庫偵錯版本連結時，recalloc 會解析為 _recalloc_dbg。 如需堆積在偵錯過程中的運作，請參閱 The CRT Debug Heap 。
_recalloc 會標示為 __declspec(noalias) 和 __declspec(restrict)，這表示函式保證不會修改全域變數且傳回的指標不會產生別名。 如需詳細資訊，請參閱 noalias 和 restrict。
需求
常式 |
必要的標頭 |
|---|---|
_recalloc |
<stdlib.h> 和 <malloc.h> |
如需其他相容性資訊，請參閱＜簡介＞中的相容性。
.NET Framework 對等用法
不適用。若要呼叫標準 C 函式，請使用 PInvoke。如需詳細資訊，請參閱平台叫用範例。