_calloc_dbg
デバッグのヘッダーとオーバーライドのバッファー (デバッグ バージョンだけ) 用の領域を使用してヒープの一部のメモリ ブロックを割り当てます。
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 は ENOMEM にメモリ割り当てに失敗した場合 errno を設定します ; EINVAL は必要なメモリ量 (前記のオーバーヘッドを含む) _HEAP_MAXREQ を超えるとが返されます。この変更およびそのほかのエラー コードについてはerrno、_doserrno、_sys_errlist、および _sys_nerr を参照してください。
デバッグ バージョンのベース ヒープに対するメモリ ブロックの割り当て、初期化、管理方法の詳細については、「メモリ管理とデバッグ ヒープ」を参照してください。標準のヒープ関数とアプリケーションのデバッグ ビルドのデバッグ バージョンとの違いについてはデバッグ バージョンを使用して基本バージョン を参照してください。
必要条件
ルーチン |
必須ヘッダー |
|---|---|
_calloc_dbg |
<crtdbg.h> |
互換性の詳細については、「C ランタイム ライブラリ」の「互換性」を参照してください。
使用例
// 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 );
}
同等の .NET Framework 関数
該当なし標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。