_recalloc

realloc 및 calloc의 조합입니다. 메모리에 배열을 다시 할당하고 해당 요소를 0으로 초기화합니다.

구문

void *_recalloc(
   void *memblock
   size_t num,
   size_t size
);

매개 변수

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

number
요소의 수입니다.

size
각 요소의 길이입니다(바이트).

반환 값

_recalloc는 다시 할당된(그리고 이동되었을 수 있는) 메모리 블록에 대한 void 포인터를 반환합니다.

사용 가능한 메모리가 부족하여 블록을 지정된 크기로 확장할 수 없는 경우 원래 블록은 변경되지 NULL 않고 반환됩니다.

요청된 크기가 0이면 memblock에서 가리키는 블록이 해제됩니다. 반환 값은 NULL이며, memblock은 해제된 블록을 가리키는 상태로 유지됩니다.

반환 값은 모든 유형의 개체의 스토리지에 적합하게 정렬된 스토리지 공간을 가리킵니다. void가 아닌 형식의 포인터를 가져오려면 반환 값에 형식 캐스팅을 사용합니다.

설명

_recalloc 함수는 할당된 메모리 블록의 크기를 변경합니다. memblock 인수는 메모리 블록의 시작 부분을 가리킵니다. memblock이 NULL이면 _recalloc는 calloc와 같은 방식으로 동작하며 number * size바이트의 새 블록을 할당합니다. 각 요소는 0으로 초기화됩니다. 그렇지 않은 경우 memblock 이전 호출calloc에서 반환한 포인터이거나 realloc. mallocNULL

새 블록이 새 메모리 위치에 있을 수 있으므로 반환된 _recalloc 포인터가 인수를 통해 memblock 전달되는 포인터가 될 수 없습니다.

메모리 할당이 실패하거나 요청된 메모리의 양이 _HEAP_MAXREQ를 초과하는 경우 _recalloc는 errno를 ENOMEM으로 설정합니다. 이 코드 및 기타 오류 코드에 대한 자세한 내용은 , _doserrno, _sys_errlist및 _sys_nerr를 참조하세요errno.

recalloc는 C++ _set_new_mode 함수를 사용하여 새 처리기 모드를 설정하기 위해 호출 realloc 됩니다. 새 처리기 모드는 실패 시 realloc이 _set_new_handler에서 설정한 대로 새 처리기 루틴을 호출하는지 여부를 나타냅니다. 기본적으로 realloc 메모리를 할당하지 못한 경우 새 처리기 루틴을 호출하지 않습니다. _recalloc가 메모리 할당에 실패한 경우 realloc이 new 연산자가 같은 이유로 실패했을 때 수행하는 것과 동일한 방식으로 새 처리기 루틴을 호출하도록 이 기본 동작을 재정의할 수 있습니다. 기본값을 재정의하려면 다음 코드를

_set_new_mode(1);

프로그램에서 초기에 호출하거나, NEWMODE.OBJ를 사용하여 연결합니다.

애플리케이션이 C 런타임 라이브러리 _recalloc 의 디버그 버전과 연결되면 .로 확인 _recalloc_dbg됩니다. 디버깅 프로세스 중에 힙을 관리하는 방법에 대한 자세한 내용은 CRT 디버그 힙을 참조하세요.

_recalloc 가 표시 __declspec(noalias) 되고 __declspec(restrict), 함수가 전역 변수를 수정하지 않도록 보장되고 반환된 포인터가 별칭이 지정되지 않음을 의미합니다. 자세한 내용은 noalias 및 restrict를 참조하세요.

기본적으로 이 함수의 전역 상태는 애플리케이션으로 범위가 지정됩니다. 이 동작을 변경하려면 CRT의 전역 상태를 참조하세요.

요구 사항

루틴에서 반환된 값	필수 헤더
_recalloc	<stdlib.h> 및 <malloc.h>

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

참고 항목

메모리 할당
_recalloc_dbg
_aligned_recalloc
_aligned_offset_recalloc
free
링크 옵션