Sdílet prostřednictvím

_fullpath_dbg, _wfullpath_dbg

  • Článek

_fullpathVerze , _wfullpathkteré používají ladicí verzi malloc k přidělení paměti.

Syntaxe

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
);

Parametry

absPath
Ukazatel na vyrovnávací paměť obsahující absolutní nebo úplný název cesty nebo NULL.

relPath
Relativní název cesty

maxLength
Maximální délka vyrovnávací paměti názvu absolutní cesty (absPath). Tato délka je v bajtech pro _fullpath_dbg , ale v širokých znacích (wchar_t) pro _wfullpath_dbg.

blockType
Požadovaný typ bloku paměti: _CLIENT_BLOCK nebo _NORMAL_BLOCK.

filename
Ukazatel na název zdrojového souboru, který požadoval operaci přidělení nebo NULL.

linenumber
Číslo řádku ve zdrojovém souboru, kde byla požadována operace přidělení nebo NULL.

Vrácená hodnota

Každá funkce vrátí ukazatel na vyrovnávací paměť obsahující absolutní název cesty (absPath). Pokud dojde k chybě (například pokud předaná relPath hodnota obsahuje neplatné písmeno jednotky nebo nelze najít nebo pokud je délka vytvořené absolutní cestyabsPath větší než maxLength) vrátí NULLfunkce .

Poznámky

Funkce _fullpath_dbg jsou _wfullpath_dbg identické s a _wfullpath s tím rozdílem_fullpath, že pokud _DEBUG jsou definovány, tyto funkce používají ladicí verzi malloc, _malloc_dbgk přidělení paměti, pokud NULL je předán jako první parametr. Informace o funkcích ladění naleznete _malloc_dbgv tématu _malloc_dbg.

Ve většině případů tyto funkce nemusíte volat explicitně. Místo toho můžete příznak definovat _CRTDBG_MAP_ALLOC . Pokud _CRTDBG_MAP_ALLOC je definována, volání a _wfullpath _fullpath jsou znovu namapována _fullpath_dbg a _wfullpath_dbg, v uvedeném pořadí, s nastavenou na _NORMAL_BLOCKblockType . Proto není nutné tyto funkce volat explicitně, pokud nechcete označit bloky haldy jako _CLIENT_BLOCK. Další informace naleznete v tématu Typy bloků v haldě ladění.

Mapování rutin obecného textu

Rutina Tchar.h _UNICODE a _MBCS není definován _MBCS definovaný _UNICODE definovaný
_tfullpath_dbg _fullpath_dbg _fullpath_dbg _wfullpath_dbg

Požadavky

Function Požadovaný hlavičkový soubor
_fullpath_dbg <crtdbg.h>
_wfullpath_dbg <crtdbg.h>

Další informace o kompatibilitě najdete v tématu Kompatibilita.

Viz také

Zpracování souborů
_fullpath, _wfullpath
Ladění verzí funkcí přidělení haldy