_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但以寬字元為單位 (wchar_t) 的_wfullpath。blockType
要求的記憶體區塊類型: _CLIENT_BLOCK或_NORMAL_BLOCK。filename
要求配置作業的原始程式檔名稱的指標或NULL。linenumber
對齊配置操作所要求的原始程式檔中的數字或NULL。
傳回值
每個函式傳回的指標,此緩衝區包含絕對路徑名稱 (absPath)。 如果發生錯誤 (比方說,如果傳入的值時,才relPath包含的磁碟機代號不正確或找不到,或者如果建立的絕對路徑名稱的長度 (absPath) 大於maxLength) 函式會傳回NULL。
備註
_fullpath_dbg和_wfullpath_dbg函式是等於_fullpath和_wfullpath差異在於,當 **_**DEBUG是定義,這些函式會使用偵錯版本的malloc, _malloc_dbg、 配置記憶體,如果將 NULL 傳遞的第一個參數。 如有關的偵錯功能_malloc_dbg,請參閱_malloc_dbg。
您不需要明確地呼叫這些函式,在大多數情況下。 相反地,您可以定義_CRTDBG_MAP_ALLOC旗標。 When _CRTDBG_MAP_ALLOCis defined, calls to _fullpath and _wfullpathare remapped to _fullpath_dbg and _wfullpath_dbg, respectively, with the blockType set to _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> |
如需相容性資訊,請參閱相容性在簡介中。