_tempnam_dbg
, _wtempnam_dbg
Versions de fonction de _tempnam
, , _wtempnam
, _wtmpnam
tmpnam
qui utilisent la version de débogage de malloc
, _malloc_dbg
.
Syntaxe
char *_tempnam_dbg(
const char *dir,
const char *prefix,
int blockType,
const char *filename,
int linenumber
);
wchar_t *_wtempnam_dbg(
const wchar_t *dir,
const wchar_t *prefix,
int blockType,
const char *filename,
int linenumber
);
Paramètres
dir
Chemin d’accès utilisé dans le nom de fichier s’il n’existe aucune variable d’environnement TMP ou si TMP n’est pas un répertoire valide.
prefix
Chaîne qui sera ajoutée aux noms retournés par _tempnam
.
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
.
Valeur retournée
Chaque fonction retourne un pointeur vers le nom généré ou NULL
en cas d’échec. L’échec peut se produire s’il existe un nom de répertoire non valide spécifié dans la variable d’environnement TMP et dans le dir
paramètre.
Remarque
free
(ou free_dbg
) doit être appelé pour les pointeurs alloués par _tempnam_dbg
et _wtempnam_dbg
.
Notes
Les _tempnam_dbg
fonctions et _wtempnam_dbg
les fonctions sont identiques et _tempnam
_wtempnam
sauf que, lorsqu’elles _DEBUG
sont définies, ces fonctions utilisent la version de débogage et , pour allouer de malloc
_malloc_dbg
la mémoire si NULL
elle est passée en tant que premier paramètre. Pour plus d’informations, consultez _malloc_dbg
.
Vous n’avez pas besoin d’appeler ces fonctions explicitement dans la plupart des cas. À la place, vous pouvez définir l'indicateur _CRTDBG_MAP_ALLOC
. Quand _CRTDBG_MAP_ALLOC
est défini, les appels à _tempnam
et _wtempnam
sont remappés à _tempnam_dbg
et _wtempnam_dbg
, respectivement, avec blockType
défini sur _NORMAL_BLOCK
. Par conséquent, vous n’avez pas besoin d’appeler ces fonctions explicitement, sauf si vous souhaitez marquer les blocs de 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 |
---|---|---|---|
_ttempnam_dbg |
_tempnam_dbg |
_tempnam_dbg |
_wtempnam_dbg |
Spécifications
Routine | En-tête requis |
---|---|
_tempnam_dbg , _wtempnam_dbg |
<crtdbg.h> |
Pour plus d’informations sur la compatibilité, consultez Compatibility.
Voir aussi
_tempnam
, , _wtempnam
tmpnam
, ,_wtmpnam
E/S de flux
Versions de débogage des fonctions d’allocation du tas