_getcwd_dbg, _wgetcwd_dbg
Отладочные версии функций _getcwd, _wgetcwd (доступны только во время отладки)
char *_getcwd_dbg( char *buffer, int maxlen, int blockType, const char *filename, int linenumber ); wchar_t *_wgetcwd_dbg( wchar_t *buffer, int maxlen, int blockType, const char *filename, int linenumber );
Параметры
buffer
Место хранения пути.maxlen
Максимальная длина пути в символах: char для _getcwd_dbg и wchar_t для _wgetcwd_dbg.blockType
Запрошенный тип блока памяти: _CLIENT_BLOCK или _NORMAL_BLOCK.filename
Указатель на имя исходного файла, который запросил операцию выделения, или NULL.linenumber
Номер строки в исходном файле, в которой была запрошена операция выделения, или NULL.
Возвращаемое значение
Возвращает указатель на buffer. Возвращаемое значение NULL указывает на ошибку, а для errno задается значение ENOMEM, указывающее на недостаток памяти для выделения maxlen байт (если аргумент NULL задан как buffer), или значение ERANGE, указывающее, что длина пути превышает maxlen.
Для получения дополнительной информации см. errno, _doserrno, _sys_errlist, and _sys_nerr.
Заметки
Функции _getcwd_dbg и _wgetcwd_dbg идентичны _getcwd и _wgetcwd за исключением того, что если определен флаг _DEBUG, эти функции используют отладочную версию функций malloc и _malloc_dbg для выделения памяти, если NULL передается как первый параметр. Для получения дополнительной информации см. _malloc_dbg.
Как правило, явно вызывать эти функции не требуется. Вместо этого можно определить флаг _CRTDBG_MAP_ALLOC. Если определен флаг _CRTDBG_MAP_ALLOC, вызовы функций _getcwdи _wgetcwdповторно сопоставляются с _getcwd_dbgи _wgetcwd_dbg соответственно, а для параметра blockType задается тип _NORMAL_BLOCK. Таким образом, не требуется явно вызывать эти функции, если только нет необходимости пометить блоки кучи как _CLIENT_BLOCK. Для получения дополнительной информации см. Типы блоков в отладочной куче.
Универсальное текстовое сопоставление функций
Процедура Tchar.h |
_UNICODE и _MBCS не определены |
_MBCS определено |
_UNICODE определено |
---|---|---|---|
_tgetcwd_dbg |
_getcwd_dbg |
_getcwd_dbg |
_wgetcwd_dbg |
Требования
Подпрограмма |
Обязательный заголовок |
---|---|
_getcwd_dbg |
<crtdbg.h> |
_wgetcwd_dbg |
<crtdbg.h> |
Дополнительные сведения о совместимости см. в разделе Совместимость во введении.