_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
인 소스 파일의 줄 번호입니다.
및 linenumber
매개 변수는 filename
명시적으로 호출되었거나 _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
이 반환됩니다. 이 코드 및 기타 오류 코드에 대한 자세한 내용은 , _doserrno
, _sys_errlist
및 _sys_nerr
를 참조하세요errno
.
기본 힙의 디버그 버전에서 메모리 블록을 할당, 초기화 및 관리하는 방법에 대한 자세한 내용은 CRT 디버그 힙 세부 정보를 참조 하세요. 표준 힙 함수와 디버그 버전 호출의 차이점에 대한 자세한 내용은 힙 할당 함수의 디버그 버전을 참조 하세요.
요구 사항
루틴에서 반환된 값 | 필수 헤더 |
---|---|
_calloc_dbg |
<crtdbg.h> |
호환성에 대한 자세한 내용은 호환성을 참조하세요.
예시
// 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