Поделиться через

_fullpath_dbg, _wfullpath_dbg

  • Статья

_fullpathВерсии, _wfullpath использующие отладочную версию malloc для выделения памяти.

Синтаксис

char *_fullpath_dbg(
   char *absPath,
   const char *relPath,
   size_t maxLength,
   int blockType,
   const char *filename,
   int linenumber
);
wchar_t *_wfullpath_dbg(
   wchar_t *absPath,
   const wchar_t *relPath,
   size_t maxLength,
   int blockType,
   const char *filename,
   int linenumber
);

Параметры

absPath
Указатель на буфер, содержащий абсолютный или полный путь, или значение NULL.

relPath
Относительный путь.

maxLength
Максимальная длина буфера абсолютного пути (absPath). Длина указывается в байтах для _fullpath_dbg и в расширенных символах (wchar_t) для _wfullpath_dbg.

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

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

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

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

Каждая функция возвращает указатель на буфер, который содержит абсолютный путь (absPath). Если возникает ошибка (например, если значение, переданное включающее relPath букву диска, недопустимое или не найденное, или если длина созданного абсолютного имени пути (absPath) больше maxLength) возвращается NULLфункция.

Замечания

Функции _fullpath_dbg идентичны _fullpath и _wfullpath за исключением того, что при _DEBUG определении эти функции используют отладочную версию malloc, _malloc_dbgчтобы выделить память, если NULL передается _wfullpath_dbg в качестве первого параметра. Дополнительные сведения о функциях отладки _malloc_dbgсм. в статье _malloc_dbg.

В большинстве случаев эти функции не нужно вызывать явным образом. Вместо этого можно определить флаг _CRTDBG_MAP_ALLOC. Если определен флаг _CRTDBG_MAP_ALLOC, вызовы функций _fullpath и _wfullpath повторно сопоставляются с _fullpath_dbg и _wfullpath_dbg соответственно, а для параметра blockType задается флаг _NORMAL_BLOCK. Таким образом, вам не нужно явно вызывать эти функции, если вы не хотите пометить блоки кучи как _CLIENT_BLOCK. Дополнительные сведения см. в разделе Типы блоков в отладочной куче.

Сопоставления подпрограмм универсального текста

Подпрограмма Tchar.h _UNICODE и _MBCS не определен _MBCS Определенные _UNICODE Определенные
_tfullpath_dbg _fullpath_dbg _fullpath_dbg _wfullpath_dbg

Требования

Function Обязательный заголовок
_fullpath_dbg <crtdbg.h>
_wfullpath_dbg <crtdbg.h>

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

См. также

Обработка файлов
_fullpath, _wfullpath
Версии отладки функций выделения кучи