_calloc_dbg

發行項
06/09/2015

在堆積中配置數個記憶體區塊，與偵錯標題和重新寫入緩衝區的額外空間 (僅偵錯版本)。

void *_calloc_dbg( 
   size_t num,
   size_t size,
   int blockType,
   const char *filename,
   int linenumber 
);

參數

num
記憶體區塊要求數目。
size
每個記憶體區塊 (位元組) 的要求大小。
blockType
記憶體區塊的要求型別：_CLIENT_BLOCK 或 _NORMAL_BLOCK。

如需配置區塊類型的資訊以及它們的使用方式，請參閱偵錯堆積中的區塊類型。
filename
指向要求配置作業或 NULL 的來源檔案名稱之指標。
linenumber
配置作業為要求或 NULL 的原始程式檔行號。

filename 和 linenumber 參數只有在 _calloc_dbg 已經明確呼叫或 _CRTDBG_MAP_ALLOC 前置處理器常數已經被定義後才可使用。

傳回值

在成功完成後，這個函式會傳回指向上次配置的記憶體區塊的使用者部分的指標、呼叫新處理常式函式、或傳回 NULL。如需傳回行為的完整說明，請參閱備註章節。如需使用新處理常式函式的詳細資訊，請參閱 calloc 函式。

備註

_calloc_dbg 是 calloc 函式的偵錯版本。當 _DEBUG 未定義時，對 _calloc_dbg 的每個呼叫會減少為對 calloc 的一個呼叫。 calloc 和 _calloc_dbg 會在基底堆積配置 num 記憶體區塊，不過 _calloc_dbg 提供幾個偵錯功能：

在測試遺漏的區塊的任一邊使用者部分進行緩衝。
追蹤特定配置類型的區塊類型參數。
決定配置要求原點的 filename/linenumber 資訊。

_calloc_dbg 配置給每個記憶體區塊的空間會比要求的 size 更多一些。偵錯堆積管理員用額外空間來連接偵錯記憶體區塊，並提供應用程式偵錯標頭資訊並覆寫緩衝區。當區塊被配置時，區塊的使用者部分會被填入 0xCD 值，而且每個覆寫緩衝區會填入 0xFD。

如果記憶體配置失敗，_calloc_dbg 會將 errno 設至 ENOMEM ；如果需要的記憶體數量 (先前提到的包括額外負荷) 超過 _HEAP_MAXREQ，EINVAL 會傳回。如需有關這個錯誤碼及其他錯誤碼的詳細資訊，請參閱 errno、_doserrno、_sys_errlist 和 _sys_nerr。

如需記憶體區塊配置、初始化的方式，並在基底堆積的偵錯版本管理記憶體區塊的詳細資訊，請參閱 CRT 偵錯堆積詳細資料。如需呼叫標準堆積函式以及偵錯應用程式的偵錯組建的版本之差異的詳細資訊，請參閱堆積配置函式的偵錯版本。

需求

常式	必要的標頭
_calloc_dbg	<crtdbg.h>

如需更多關於相容性的資訊，請參閱入門介紹中的相容性 (Compatibility) 。

範例

// crt_callocd.c
/*
 * This program uses _calloc_dbg to allocate space for
 * 40 long integers. It initializes each element to zero.
 */
#include <stdio.h>
#include <malloc.h>
#include <crtdbg.h>

int main( void )
{
        long *bufferN, *bufferC;

        /* 
         * Call _calloc_dbg to include the filename and line number
         * of our allocation request in the header and also so we can
         * allocate CLIENT type blocks specifically
         */
        bufferN = (long *)_calloc_dbg( 40, sizeof(long), _NORMAL_BLOCK, __FILE__, __LINE__ );
        bufferC = (long *)_calloc_dbg( 40, sizeof(long), _CLIENT_BLOCK, __FILE__, __LINE__ );
        if( bufferN != NULL && bufferC != NULL )
              printf( "Allocated memory successfully\n" );
        else
              printf( "Problem allocating memory\n" );

        /* 
         * _free_dbg must be called to free CLIENT type blocks
         */
        free( bufferN );
        _free_dbg( bufferC, _CLIENT_BLOCK );
}