`_expand_dbg`

아티클
04/03/2023

블록을 확장하거나 축소하여 힙에서 지정된 메모리 블록의 크기를 조정합니다(디버그 버전에만 해당).

구문

void *_expand_dbg(
   void *userData,
   size_t newSize,
   int blockType,
   const char *filename,
   int lineNumber
);

매개 변수

userData
이전에 할당된 메모리 블록에 대한 포인터입니다.

newSize
요청된 블록의 새 크기(바이트)입니다.

blockType
크기가 조정된 블록의 요청된 형식: _CLIENT_BLOCK 또는 _NORMAL_BLOCK.

filename
확장 작업 또는 NULL을 요청한 소스 파일의 이름에 대한 포인터입니다.

lineNumber
확장 작업이 요청되었거나 NULL인 소스 파일의 줄 번호입니다.

및 lineNumber 매개 변수는 filename 명시적으로 호출되었거나 _CRTDBG_MAP_ALLOC 전처리기 상수가 정의된 경우에만 사용할 수 있습니다_expand_dbg.

반환 값

성공적으로 완료되면 _expand_dbg는 크기가 조정된 메모리 블록의 포인터를 반환합니다. 메모리가 이동되지 않으므로 주소는 userData와 동일합니다. 오류가 발생했거나 요청된 크기로 블록을 확장할 수 없는 경우 해당 블록이 반환됩니다 NULL. 오류가 발생할 경우 errno는 운영 체제에서 제공되는 오류 특성에 대한 정보에 기반을 둡니다. 에 대한 errno자세한 내용은 , , _doserrno_sys_errlist및_sys_nerr 를 참조하세요errno.

설명

함수는 _expand_dbg _expand 함수의 디버그 버전입니다. 정의되지 않은 경우 _DEBUG 각 호출 _expand_dbg 이 호출로 _expand줄어듭니다. _expand와 _expand_dbg 둘 다 기본 힙에서 메모리 블록을 크기 조정하지만 _expand_dbg는 여러 디버깅 기능을 수용합니다. 이러한 기능에는 메모리 블록의 사용자 부분 한 쪽에서의 버퍼(어느 쪽이든지 상관없이)로 누수 테스트, 블록 형식 매개 변수로 특정 할당 형식 추적 및 filename/lineNumber 정보로 할당 요청의 원점을 확인하는 기능이 있습니다.

_expand_dbg는 요청된 newSize보다 약간 더 많은 공간을 사용하여 메모리 블록의 크기를 조정합니다. newSize는 원래 할당된 메모리 블록의 크기보다 더 크거나 작을 수 있습니다. 추가 공간은 디버그 힙 관리자가 디버그 메모리 블록을 연결하고 애플리케이션에 디버그 헤더 정보 및 덮어쓰기 버퍼를 제공하는 데 사용됩니다. 크기를 조정하려면 원래 메모리 블록을 확장하거나 축소합니다. _expand_dbg 는 함수와 마찬가지로 메모리 블록을 이동하지 않습니다 _realloc_dbg .

newSize가 원래 블록 크기보다 클 경우 메모리 블록이 확장됩니다. 확장 중에 요청된 크기를 NULL 수용하도록 메모리 블록을 확장할 수 없는 경우 반환됩니다. newSize가 원래 블록 크기보다 작으면 메모리 블록은 새 크기와 같아질 때까지 축소됩니다.

기본 힙의 디버그 버전에서 메모리 블록을 할당, 초기화 및 관리하는 방법에 대한 자세한 내용은 CRT 디버그 힙 세부 정보를 참조 하세요. 할당 블록 형식 및 사용 방법에 대한 자세한 내용은 디버그 힙의 블록 유형을 참조 하세요. 표준 힙 함수와 디버그 버전 간의 차이점에 대한 자세한 내용은 힙 할당 함수의 디버그 버전을 참조 하세요.

이 함수는 해당 매개 변수의 유효성을 검사합니다. null 포인터이거나 크기가 보다 큰 경우 userData 이 함수는 매개 변수 유효성 검사에 설명된 대로 잘못된 매개 변수 처리기를 호출합니다._HEAP_MAXREQ 계속해서 실행하도록 허용된 경우 errno 는 EINVAL 로 설정되고 함수에서 NULL버전입니다.

요구 사항

루틴에서 반환된 값	필수 헤더
`_expand_dbg`	<crtdbg.h>

호환성에 대한 자세한 내용은 호환성을 참조하세요.

라이브러리

C 런타임 라이브러리의 디버그 버전만 해당됩니다.

예시

// crt_expand_dbg.c
//
// This program allocates a block of memory using _malloc_dbg
// and then calls _msize_dbg to display the size of that block.
// Next, it uses _expand_dbg to expand the amount of
// memory used by the buffer and then calls _msize_dbg again to
// display the new amount of memory allocated to the buffer.
//

#include <stdio.h>
#include <malloc.h>
#include <stdlib.h>
#include <crtdbg.h>

int main( void )
{
   long *buffer;
   size_t size;

   // Call _malloc_dbg to include the filename and line number
   // of our allocation request in the header
   buffer = (long *)_malloc_dbg( 40 * sizeof(long),
                                 _NORMAL_BLOCK, __FILE__, __LINE__ );
   if( buffer == NULL )
      exit( 1 );

   // Get the size of the buffer by calling _msize_dbg
   size = _msize_dbg( buffer, _NORMAL_BLOCK );
   printf( "Size of block after _malloc_dbg of 40 longs: %u\n", size );

   // Expand the buffer using _expand_dbg and show the new size
   buffer = (long *)_expand_dbg( buffer, size + sizeof(long),
                                 _NORMAL_BLOCK, __FILE__, __LINE__ );

   if( buffer == NULL )
      exit( 1 );
   size = _msize_dbg( buffer, _NORMAL_BLOCK );
   printf( "Size of block after _expand_dbg of 1 more long: %u\n",
           size );

   free( buffer );
   exit( 0 );
}

Size of block after _malloc_dbg of 40 longs: 160
Size of block after _expand_dbg of 1 more long: 164

설명

이 프로그램의 출력은 모든 섹션을 확장하는 컴퓨터 기능에 따라 달라집니다. 모든 섹션이 확장되면 출력이 출력 섹션에 반영됩니다.

참고 항목

디버그 루틴
_malloc_dbg