_getcwd_dbg, _wgetcwd_dbg

 

Pour obtenir la dernière documentation sur Visual Studio 2017, consultez Documentation Visual Studio 2017.

Les versions Debug de la _getcwd, _wgetcwd fonctions (disponibles uniquement pendant 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.

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.

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, consultez errno, _doserrno, _sys_errlist et _sys_nerr.

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, consultez _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. Lors de la _CRTDBG_MAP_ALLOC est défini, les appels à _getcwdet _wgetcwdsont remappés à _getcwd_dbget _wgetcwd_dbg, respectivement, avec la blockType la valeur _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, consultez Types de bloc sur le tas de débogage.

Routine Tchar.h_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tgetcwd_dbg_getcwd_dbg_getcwd_dbg_wgetcwd_dbg
RoutineEn-tête requis
_getcwd_dbg<crtdbg.h>
_wgetcwd_dbg<crtdbg.h>

Pour plus d’informations sur la compatibilité, consultez Compatibility dans l’introduction.

CurrentDirectory

_getcwd, _wgetcwd
Contrôle de répertoire
Versions Debug des fonctions d’Allocation du tas

Afficher: