_malloc_dbg

Выделяет блок памяти в куче с дополнительным пространством для заголовка отладки и перезаписи буферов (только для отладки).

Синтаксис

void *_malloc_dbg(
   size_t size,
   int blockType,
   const char *filename,
   int linenumber
);

Параметры

size
Запрошенный размер блока памяти (байт).

blockType
Запрошенный тип блока памяти: _CLIENT_BLOCK или _NORMAL_BLOCK.

filename
Указатель на имя исходного файла, который запросил операцию выделения, или NULL.

linenumber
Номер строки в исходном файле, в которой была запрошена операция выделения, или NULL.

linenumber Параметры filename доступны только при _malloc_dbg явном вызове или _CRTDBG_MAP_ALLOC определении константы препроцессора.

Возвращаемое значение

При успешном завершении эта функция возвращает указатель на пользовательную часть выделенного блока памяти, вызывает новую функцию обработчика или возвращает.NULL Полное описание поведения возвращения см. в следующем разделе "Примечания". Дополнительные сведения о том, как используется новая функция обработчика, см. в malloc этой функции.

Замечания

_malloc_dbg — это отладочная версия malloc функции. Если _DEBUG не определено, каждый вызов _malloc_dbg уменьшается до вызова malloc. И malloc, и _malloc_dbg выполняют выделение блока памяти в основной куче, однако _malloc_dbg включает различные возможности отладки: буферы на обеих сторонах пользовательской части блока для тестирования утечек, параметр типа блока для отслеживания конкретных типов выделения, а также сведения о filename/linenumber для определения источника запросов на выделение.

_malloc_dbg выделяет блок памяти, добавив немного больше пространства, чем запрошено size. Дополнительное пространство используется диспетчером кучи отладки для связывания блоков памяти отладки и предоставления приложению сведений о заголовках отладки и перезаписи буферов. При выделении блока пользовательская часть блока заполняется значением 0xCD, а каждый из буферов перезаписи заполняется 0xFD.

_malloc_dbg задает для errno значение ENOMEM в случае сбоя выделения памяти или если необходимый объем памяти (включая ранее упомянутую нагрузку) превышает _HEAP_MAXREQ. Сведения об этом и других кодах ошибок см. в разделе errno, _doserrnoи _sys_errlist_sys_nerr.

Сведения о выделении, инициализации и управлении блоками памяти в отладочной версии базовой кучи см. в сведениях об отладочной куче CRT. Сведения о типах блоков выделения и их использовании см. в разделе "Типы блоков" в куче отладки. Сведения о различиях между стандартными функциями кучи и версиями отладки см. в разделе "Отладка версий функций выделения кучи".

Требования

Маршрут	Обязательный заголовок
_malloc_dbg	<crtdbg.h>

Дополнительные сведения о совместимости см. в разделе Совместимость.

Библиотеки

Только отладочные версии библиотек времени выполнения языка C.

Пример

Пример использования _malloc_dbgсм. в разделе crt_dbg1.

См. также

Отладка подпрограмм
malloc
_calloc_dbg