Подпрограммы отладки

Статья
04/03/2023

Отладочная версия библиотеки времени выполнения C предоставляет множество служб диагностики, упрощающих отладку программ и позволяющих разработчикам:

пошагово входить непосредственно в функции времени выполнения во время отладки;
разрешать утверждения, ошибки и исключения;
трассировать выделение памяти в куче и предотвращать утечки памяти;
выводить отладочные сообщения пользователю.

Отладочные версии подпрограмм библиотеки времени выполнения C

Чтобы использовать эти подпрограммы, _DEBUG необходимо определить флаг. В окончательной сборке приложения все эти подпрограммы не выполняют никаких действий. Дополнительные сведения об использовании новых подпрограмм отладки см . в статьях о методах отладки CRT.

Маршрут	Использование
`_ASSERT`	Вычисление выражения и создание отчета отладки при получении результата `FALSE`
`_ASSERTE`	Аналогична `_ASSERT`, но включает в создаваемый отчет выражение, где произошел сбой
`_CrtCheckMemory`	Проверяет целостность выделенных блоков памяти в отладочной куче
`_CrtDbgBreak`	Устанавливает точку останова.
`_CrtDbgReport`, `_CrtDbgReportW`	Создает отладочный отчет с сообщением для пользователя и отправляет отчет в три возможных назначения
`_CrtDoForAllClientObjects`	Вызывает предоставленную приложением функцию для всех типов `_CLIENT_BLOCK` в куче
`_CrtDumpMemoryLeaks`	Сбрасывает все блоки памяти в отладочной куче при значительной утечке памяти
`_CrtIsMemoryBlock`	Проверяет, что указанный блок памяти находится в локальной куче, а также что он имеет допустимый идентификатор типа блока отладочной кучи
`_CrtIsValidHeapPointer`	Проверяет, что указанный указатель находится в локальной куче
`_CrtIsValidPointer`	Проверяет, что указанный диапазон памяти допустим для чтения и записи
`_CrtMemCheckpoint`	Получает текущее состояние отладочной кучи и сохраняет его в предоставленной приложением структуре `_CrtMemState`
`_CrtMemDifference`	Сравнивает два состояния памяти на предмет значащих отличий и возвращает результаты
`_CrtMemDumpAllObjectsSince`	Сбрасывает сведения об объектах в куче с указанной контрольной точки или с начала выполнения программы
`_CrtMemDumpStatistics`	Сбрасывает данные заголовка отладки для указанного состояния памяти в понятной пользователю форме
`_CrtReportBlockType`	Возвращает тип и подтип блока, связанные с указателем блока заданной отладочной кучи.
`_CrtSetAllocHook`	Устанавливает определяемую клиентом функцию выделения путем присоединения ее к отладочному процессу выделения памяти времени выполнения C
`_CrtSetBreakAlloc`	Устанавливает точку останова на указанном порядковом номере выделения объекта
`_CrtSetDbgFlag`	Извлекает или изменяет состояние флага `_crtDbgFlag` для управления поведением выделения диспетчера отладочной кучи
`_CrtSetDumpClient`	Устанавливает определяемую приложением функцию, которая вызывается при каждом вызове функции отладочного дампа для сброса блоков памяти типа `_CLIENT_BLOCK`
`_CrtSetReportFile`	Указывает файл или поток, используемый в качестве назначения для определенного типа отчета `_CrtDbgReport`
`_CrtSetReportHook`	Устанавливает определяемую клиентом функцию отчетов путем присоединения ее к отладочному процессу отчетов времени выполнения С
`_CrtSetReportHook2`, `_CrtSetReportHookW2`	Устанавливает или удаляет определяемую клиентом функцию отчетов путем ее присоединения к отладочному процессу отчетов времени выполнения языка C.
`_CrtSetReportMode`	Задает общие назначения для определенного типа отчета, создаваемого `_CrtDbgReport`
`_RPT[0,1,2,3,4]`	Отслеживает ход выполнения приложения путем создания отладочного отчета, вызывая `_CrtDbgReport` со строкой формата и переменным количеством аргументов. Не предоставляет сведений об исходном файле и номере строки.
`_RPTF[0,1,2,3,4]`	Аналогична макросам `_RPTn`, но предоставляет имя файла и номер строки в файле, где возник запрос отчета
`_calloc_dbg`	Выделение указанного количества блоков памяти в куче с дополнительным пространством для заголовка отладки и перезаписи буферов
`_expand_dbg`	Изменяет размер указанного блока памяти в куче, увеличивая его или сжимая
`_free_dbg`	Освобождает блок памяти в куче
`_fullpath_dbg`, `_wfullpath_dbg`	Создайте абсолютное или полное имя пути для указанного относительного имени пути, используя `_malloc_dbg` для выделения памяти.
`_getcwd_dbg`, `_wgetcwd_dbg`	Получите текущий рабочий каталог, используя `_malloc_dbg` для выделения памяти.
`_malloc_dbg`	Выделение блока памяти в куче с дополнительным пространством для заголовка отладки и перезаписи буферов
`_msize_dbg`	Вычисляет размер блока памяти в куче
`_realloc_dbg`	Перераспределяет указанный блок памяти в куче, перемещая его и (или) изменяя его размер
`_strdup_dbg`, `_wcsdup_dbg`	Дублирует строку, используемую `_malloc_dbg` для выделения памяти.
`_tempnam_dbg`, `_wtempnam_dbg`	Создавать имена, которые можно использовать для создания временных файлов, используя `_malloc_dbg` для выделения памяти.

Подпрограммы среды выполнения C, недоступные в форме исходного кода

Отладчик можно использовать для пошагового выполнения исходного кода большинства подпрограмм среды выполнения C в процессе отладки. Однако корпорация Майкрософт считает, что некоторые технологии являются собственными и поэтому не предоставляют исходный код для подмножества этих подпрограмм. Большинство этих подпрограмм относится либо к обработке исключений, либо к группам операций с плавающей запятой, однако есть также несколько подпрограмм других категорий. Эти подпрограммы перечислены в следующей таблице.

Хотя исходный код доступен для большинства printf и scanf подпрограмм, они вызывают внутреннюю процедуру, для которой исходный код не предоставляется.

Подпрограммы, которые ведут себя иначе в отладочной сборке приложения

Некоторые функции времени выполнения C и операторы C++ ведут себя иначе при их вызове из отладочной сборки приложения. (Можно создать отладочную сборку приложения, определив _DEBUG флаг или связав отладочную версию библиотеки времени выполнения C.) Различия в поведении обычно состоят из дополнительных функций или сведений, предоставляемых подпрограммой для поддержки процесса отладки. Эти подпрограммы перечислены в следующей таблице.

Подпрограмма C abort

Подпрограмма C assert

Оператор C++ delete

Оператор C++ new

См. также

Универсальные подпрограммы среды выполнения C по категориям
Ошибка среды выполнения проверка