_realloc_dbg
블록을 이동하거나 크기를 조정하여 힙에서 지정된 메모리 블록을 재할당합니다(디버그 버전에만 해당).
구문
void *_realloc_dbg(
void *userData,
size_t newSize,
int blockType,
const char *filename,
int linenumber
);
매개 변수
userData
이전에 할당된 메모리 블록에 대한 포인터입니다.
newSize
재할당된 블록에 대해 요청된 크기(바이트)입니다.
blockType
재할당된 블록에 대해 요청된 형식(_CLIENT_BLOCK
또는 _NORMAL_BLOCK
)입니다.
filename
작업을 요청한 realloc
원본 파일의 이름 또는 NULL
.
linenumber
작업이 요청되었거나 NULL
소스 파일의 realloc
줄 번호입니다.
및 linenumber
매개 변수는 filename
명시적으로 호출되었거나 _CRTDBG_MAP_ALLOC
전처리기 상수가 정의된 경우에만 사용할 수 있습니다_realloc_dbg
.
반환 값
성공적으로 완료되면 이 함수는 다시 할당된 메모리 블록의 사용자 부분에 대한 포인터를 반환하거나, 새 처리기 함수를 호출하거나, 반환합니다 NULL
. 반환 동작에 대한 자세한 설명은 다음 설명 섹션을 참조하세요. 새 처리기 함수를 사용하는 방법에 대한 자세한 내용은 함수를 참조하세요 realloc
.
설명
_realloc_dbg
는 함수의 디버그 버전입니다 realloc
. 정의되지 않은 경우 _DEBUG
각 호출 _realloc_dbg
이 호출로 realloc
줄어듭니다. realloc
와 _realloc_dbg
둘 다 기본 힙에서 메모리 블록을 다시 할당하지만 _realloc_dbg
는 여러 디버깅 기능을 수용합니다. 이러한 기능에는 메모리 블록의 사용자 부분 한쪽에서의 버퍼(어느 쪽이든지 상관없이)로 누수 테스트, 블록 형식 매개 변수로 특정 할당 형식 추적 및 filename
/linenumber
정보로 할당 요청의 원점을 확인하는 기능이 있습니다.
_realloc_dbg
는 요청된 newSize
보다 약간 더 많은 공간을 지정된 메모리 블록에 다시 할당합니다. newSize
는 원래 할당된 메모리 블록의 크기보다 더 크거나 작을 수 있습니다. 추가 공간은 디버그 힙 관리자가 디버그 메모리 블록을 연결하고 애플리케이션에 디버그 헤더 정보 및 덮어쓰기 버퍼를 제공하는 데 사용됩니다. 다시 할당하면 원래 메모리 블록을 힙의 다른 위치로 이동하고 메모리 블록의 크기를 변경할 수 있습니다. 메모리 블록이 이동하면 원래 블록의 내용을 덮어씁니다.
메모리 할당에 실패한 경우 또는 필요한 메모리 양(앞에서 언급한 오버헤드 포함)이 _realloc_dbg
를 초과한 경우 errno
는 ENOMEM
를 _HEAP_MAXREQ
으로 설정합니다. 이 코드 및 기타 오류 코드에 대한 자세한 내용은 , _doserrno
, _sys_errlist
및 _sys_nerr
를 참조하세요errno
.
기본 힙의 디버그 버전에서 메모리 블록을 할당, 초기화 및 관리하는 방법에 대한 자세한 내용은 CRT 디버그 힙 세부 정보를 참조 하세요. 할당 블록 형식 및 사용 방법에 대한 자세한 내용은 디버그 힙의 블록 유형을 참조 하세요. 표준 힙 함수와 디버그 버전 간의 차이점에 대한 자세한 내용은 힙 할당 함수의 디버그 버전을 참조 하세요.
요구 사항
루틴에서 반환된 값 | 필수 헤더 |
---|---|
_realloc_dbg |
<crtdbg.h> |
호환성에 대한 자세한 내용은 호환성을 참조하세요.
라이브러리
C 런타임 라이브러리의 디버그 버전만 해당됩니다.
예시
문서의 예제를 _msize_dbg
참조하세요.