_getcwd_dbg, _wgetcwd_dbg
Ladicí verze _getcwd, _wgetcwd funkce (k dispozici pouze při ladění).
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 );
Parametry
buffer
Umístění úložiště pro danou cestu.maxlen
Maximální délka cesty ve znacích: char pro _getcwd_dbg a wchar_t pro _wgetcwd_dbg.blockType
Požadovaný typ bloku paměti: _CLIENT_BLOCK nebo _NORMAL_BLOCK.filename
Ukazatel na název zdrojového souboru, který požadovanou operaci přidělení nebo NULL.linenumber
Číslo řádku na zdrojový soubor, kde byla požadována operace přidělení nebo NULL.
Vrácená hodnota
Vrací ukazatel na parametr buffer.Vrácená hodnota NULL označuje chybu a parametr errno je nastaven buď na hodnotu ENOMEM označující nedostatek paměti k přidělení maxlen bajtů (pokud je předána hodnota NULL parametru buffer), nebo na hodnotu ERANGE označující, že cesta je delší než maxlen znaků.
Další informace naleznete v tématu errno, _doserrno, _sys_errlist, and _sys_nerr.
Poznámky
_getcwd_dbg a _wgetcwd_dbg funkce jsou shodné s _getcwd a _wgetcwd s tím rozdílem, že, když _DEBUG je definována, použijte tyto funkce ladění verzi malloc a _malloc_dbg přidělení paměti, pokud NULL je předán jako první parametr.Další informace naleznete v tématu _malloc_dbg.
Chcete-li tyto funkce volat explicitně ve většině případů nepotřebujete.Namísto toho můžete definovat _CRTDBG_MAP_ALLOC příznak.When _CRTDBG_MAP_ALLOC is defined, calls to _getcwdand _wgetcwdare remapped to _getcwd_dbgand _wgetcwd_dbg, respectively, with the blockType set to _NORMAL_BLOCK.Tedy není nutné explicitně volat tyto funkce, pokud chcete označit bloky haldy jako _CLIENT_BLOCK.Další informace naleznete v tématu typy bloky haldy ladění.
Mapování rutin obecného textu
Rutina Tchar.h |
_UNICODE a _MBCS nejsou definovány. |
_MBCS definováno |
_UNICODE definováno |
|---|---|---|---|
_tgetcwd_dbg |
_getcwd_dbg |
_getcwd_dbg |
_wgetcwd_dbg |
Požadavky
Rutina |
Požadovaný hlavičkový soubor |
|---|---|
_getcwd_dbg |
< crtdbg.h > |
_wgetcwd_dbg |
< crtdbg.h > |
Další informace o kompatibilitě, podívejte se na téma Kompatibilita v zavedení.