_getcwd_dbg, _wgetcwd_dbg
Versions de débogage des fonctions _getcwd, _wgetcwd (disponibles uniquement durant le débogage).
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 );
Paramètres
buffer
Emplacement de stockage pour le chemin d'accès.maxlen
Longueur maximale du chemin d'accès en caractères : char pour _getcwd_dbg et wchar_t pour _wgetcwd_dbg.blockType
Type demandé du bloc de mémoire : _CLIENT_BLOCK ou _NORMAL_BLOCK.filename
Pointeur vers le nom du fichier source qui a demandé l'opération d'allocation ou NULL.linenumber
Numéro de ligne dans le fichier source où l'opération d'allocation a été demandée ou NULL.
Valeur de retour
Retourne un pointeur vers buffer. Une valeur de retour NULL indique une erreur et errno prend la valeur ENOMEM, ce qui indique que la mémoire est insuffisante pour allouer maxlen octets (quand un argument NULL est donné comme buffer), ou la valeur ERANGE, ce qui indique que le chemin d'accès fait plus de maxlen caractères.
Pour plus d'informations, voir errno, _doserrno, _sys_errlist et _sys_nerr.
Notes
Les fonctions _getcwd_dbg et _wgetcwd_dbg sont identiques à _getcwd et _wgetcwd sauf que, quand _DEBUG est défini, ces fonctions utilisent la version de débogage de malloc et _malloc_dbg pour allouer la mémoire si la valeur NULL est passée comme premier paramètre. Pour plus d'informations, voir _malloc_dbg.
Dans la plupart des cas, vous n'avez pas besoin d'appeler ces fonctions de manière explicite. À la place, vous pouvez définir l'indicateur _CRTDBG_MAP_ALLOC. Quand _CRTDBG_MAP_ALLOC est défini, les appels à _getcwdet _wgetcwdsont remappés à _getcwd_dbget _wgetcwd_dbg, respectivement, avec leblockType défini sur _NORMAL_BLOCK. Ainsi, vous n'avez pas besoin d'appeler ces fonctions de manière explicite sauf si vous souhaitez marquer les blocs du tas comme _CLIENT_BLOCK. Pour plus d'informations, voir Types de bloc sur le tas de débogage.
Mappages de routines de texte générique
Routine Tchar.h |
_UNICODE et _MBCS non définis |
_MBCS défini |
_UNICODE défini |
---|---|---|---|
_tgetcwd_dbg |
_getcwd_dbg |
_getcwd_dbg |
_wgetcwd_dbg |
Configuration requise
Routine |
En-tête requis |
---|---|
_getcwd_dbg |
<crtdbg.h> |
_wgetcwd_dbg |
<crtdbg.h> |
Pour plus d'informations sur la compatibilité, voir Compatibilité dans l'introduction.