_fullpath_dbg, _wfullpath_dbg

 

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

Versions de _fullpath, _wfullpath qui utilisent la version debug de malloc d’allocation de mémoire.

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

Paramètres

absPath
Pointeur vers une mémoire tampon contenant le nom de chemin d'accès absolu ou complet, ou NULL.

relPath
Nom de chemin d'accès relatif.

maxLength
Longueur maximale de la mémoire tampon du nom de chemin d'accès absolu (absPath). Cette longueur est représentée en octets pour _fullpath mais en caractères larges (wchar_t) pour _wfullpath.

blockType
Type de bloc de mémoire demandé : _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.

Chaque fonction retourne un pointeur vers une mémoire tampon contenant le nom de chemin d'accès absolu (absPath). En cas d'erreur (par exemple, si la valeur passée dans relPath comprend une lettre de lecteur qui n'est pas valide ou qui est introuvable, ou si la longueur du nom de chemin d'accès absolu créé (absPath) est supérieure à maxLength) la fonction retourne NULL.

Le _fullpath_dbg et _wfullpath_dbg fonctions sont identiques aux _fullpath et _wfullpath , sauf que, lorsque _DEBUGest défini, ces fonctions utilisent la version debug de malloc, _malloc_dbgpour allouer la mémoire si NULL est passé comme premier paramètre. Pour plus d’informations sur les fonctionnalités de débogage de _malloc_dbg, 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_ALLOCest défini, les appels à _fullpath et _wfullpathsont remappés à _fullpath_dbg et _wfullpath_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.

Mappages de routines de texte générique

Routine Tchar.h_UNICODE et _MBCS non définis_MBCS défini_UNICODE défini
_tfullpath_dbg_fullpath_dbg_fullpath_dbg_wfullpath_dbg
FonctionEn-tête requis
_fullpath_dbg<crtdbg.h>
_wfullpath_dbg<crtdbg.h>

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

Créer

Gestion de fichiers
_fullpath, _wfullpath
Versions Debug des fonctions d’Allocation du tas

Afficher: