_getcwd_dbg, _wgetcwd_dbg
Versioni di debug delle funzioni _getcwd, _wgetcwd (disponibili solo durante il debug).
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 );
Parametri
buffer
Posizione di archiviazione per il percorso.maxlen
Lunghezza massima del percorso in caratteri: char per _getcwd_dbg e wchar_t per _wgetcwd_dbg.blockType
Tipo di blocco di memoria richiesto: _CLIENT_BLOCK o _NORMAL_BLOCK.filename
Puntatore al nome del file di origine che ha richiesto l'operazione di allocazione o NULL.linenumber
Numero di riga nel file di origine in cui è stata richiesta l'operazione di allocazione o NULL.
Valore restituito
Restituisce un puntatore a buffer. Un valore restituito di NULL indica un errore e errno viene impostato su ENOMEM, indicando che non vi è memoria sufficiente per allocare maxlen byte (quando un argomento NULL viene fornito come buffer) oppure su ERANGE, indicando che il percorso è più lungo di maxlen caratteri.
Per altre informazioni, vedere errno, _doserrno, _sys_errlist, and _sys_nerr.
Note
Le funzioni _getcwd_dbg e _wgetcwd_dbg sono identiche a _getcwd e _wgetcwd tranne per il fatto che, quando _DEBUG è definito, queste funzioni usano la versione di debug di malloc e _malloc_dbg per allocare memoria se NULL viene passato come primo parametro. Per altre informazioni, vedere _malloc_dbg.
Nella maggior parte dei casi non è necessario chiamare queste funzioni in modo esplicito. In alternativa, è possibile definire il flag _CRTDBG_MAP_ALLOC. Quando _CRTDBG_MAP_ALLOC è definito, le chiamate a _getcwde _wgetcwdvengono mappate nuovamente a _getcwd_dbge _wgetcwd_dbg rispettivamente, con blockType impostato su _NORMAL_BLOCK. Quindi, non è necessario chiamare queste funzioni in modo esplicito a meno che non si vogliano contrassegnare blocchi di memoria heap come _CLIENT_BLOCK. Per altre informazioni, vedere Tipi di blocchi sull'heap di debug.
Mapping di routine di testo generico
Routine Tchar.h |
_UNICODE e _MBCS non definiti |
_MBCS definito |
_UNICODE definito |
|---|---|---|---|
_tgetcwd_dbg |
_getcwd_dbg |
_getcwd_dbg |
_wgetcwd_dbg |
Requisiti
Routine |
Intestazione obbligatoria |
|---|---|
_getcwd_dbg |
<crtdbg.h> |
_wgetcwd_dbg |
<crtdbg.h> |
Per altre informazioni sulla compatibilità, vedere Compatibilità nell'introduzione.