_calloc_dbg

  • [アーティクル]

デバッグ ヘッダー用に追加の領域を持つヒープ内のメモリ ブロックを割り当て、バッファーを上書きします (デバッグ バージョンのみ)。

構文

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

パラメーター

number
要求するメモリ ブロックの数。

size
要求する各メモリ ブロックのサイズ (バイト)。

blockType
要求するメモリ ブロックの種類。_CLIENT_BLOCK または _NORMAL_BLOCK。

割り当てブロックの種類とその使用方法については、「デバッグ ヒープ上のブロックの種類」を参照してください。

filename
割り当て操作を要求したソース ファイル名へのポインター、または NULL。

linenumber
割り当て操作が要求されたソース ファイル内の行番号または NULL。

パラメーターfilenameとlinenumberパラメーターは、明示的に呼び出された場合、またはプリプロセッサ定数が_CRTDBG_MAP_ALLOC定義されている場合_calloc_dbgにのみ使用できます。

戻り値

正常に終了した場合、この関数は最後に割り当てられたメモリ ブロックのユーザー部分へのポインターを返すか、新しいハンドラー関数を呼び出すか、NULL を返します。 戻る動作の詳細については、「解説」のセクションを参照してください。 新しいハンドラー関数の使用方法の詳細については、関数を calloc 参照してください。

解説

_calloc_dbg は関数の calloc デバッグ バージョンです。 定義されていない場合 _DEBUG 、各呼び出しは次の呼び _calloc_dbg 出し callocに減らされます。 calloc と _calloc_dbg は、どちらもベース ヒープに number 個のメモリ ブロックを割り当てますが、_calloc_dbg は次のようないくつかのデバッグ機能を提供します。

  • リークをテストするための、ブロックのユーザー部分の両側のバッファー。

  • 特定の割り当ての種類を追跡するためのブロック型パラメーター。

  • 割り当て要求の起点を特定するための filename/linenumber 情報。

_calloc_dbg は、要求された size よりも少し多い領域を使用して各メモリ ブロックを割り当てます。 デバッグ ヒープ マネージャーは、デバッグ メモリ ブロックをリンクし、デバッグ ヘッダー情報をアプリケーションに提供し、バッファーを上書きするために、追加の領域を使用します。 ブロックが割り当てられると、ブロックのユーザー部分に0xCD値が入力され、各上書きバッファーに0xFDが格納されます。

メモリ割り当てが失敗すると、_calloc_dbg は errno を ENOMEM に設定します。必要なメモリの量 (前に説明したオーバーヘッドを含む) が EINVAL を超えると、_HEAP_MAXREQ が返されます。 このエラー コードおよびその他のエラー コードの詳細については、「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 );
}

Allocated memory successfully

関連項目

デバッグ ルーチン
calloc
_malloc_dbg
_DEBUG