_malloc_dbg

Alloue un bloc de mémoire dans le tas avec un espace supplémentaire pour un en-tête de débogage et remplace les mémoires tampons (version de débogage uniquement).

Syntaxe

void *_malloc_dbg(
   size_t size,
   int blockType,
   const char *filename,
   int linenumber
);

Paramètres

size
Taille demandée du bloc de mémoire (en octets).

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.

Les filename paramètres et linenumber les paramètres sont disponibles uniquement lorsqu’ils ont été appelés explicitement ou si _malloc_dbg la _CRTDBG_MAP_ALLOC constante de préprocesseur a été définie.

Valeur retournée

Une fois l’achèvement réussi, cette fonction retourne un pointeur vers la partie utilisateur du bloc de mémoire alloué, appelle la nouvelle fonction de gestionnaire ou retourne NULL. Pour obtenir une description complète du comportement de retour, voir la section Notes suivante. Pour plus d’informations sur l’utilisation de la nouvelle fonction de gestionnaire, consultez la malloc fonction.

Notes

_malloc_dbg est une version de débogage de la malloc fonction. Lorsqu’il _DEBUG n’est pas défini, chaque appel à est _malloc_dbg réduit à un appel à malloc. malloc et _malloc_dbg allouent toutes deux un bloc de mémoire dans le tas de base, mais _malloc_dbg propose plusieurs fonctionnalités de débogage : des mémoires tampons de chaque côté de la partie utilisateur du bloc pour vérifier la présence de fuites, un paramètre de type de bloc pour effectuer le suivi de types d’allocation spécifiques et des informations filename/linenumber pour déterminer l’origine des demandes d’allocation.

_malloc_dbg alloue le bloc de mémoire avec un peu plus d'espace que la valeur size demandée. L’espace supplémentaire est utilisé par le gestionnaire de tas de débogage pour lier les blocs de mémoire de débogage et fournir à l’application des informations d’en-tête de débogage et remplacer les mémoires tampons. Lorsque le bloc est alloué, la partie utilisateur du bloc est remplie avec la valeur 0xCD, et chacune des mémoires tampons de remplacement est remplie de 0xFD.

_malloc_dbg affecte la valeur errno à ENOMEM si une allocation de mémoire échoue ou si la quantité de mémoire nécessaire (y compris la surcharge mentionnée précédemment) dépasse _HEAP_MAXREQ. Pour plus d’informations sur ce code et d’autres codes d’erreur, consultez , , _sys_errlist_doserrnoet _sys_nerr.errno

Pour plus d’informations sur la façon dont les blocs de mémoire sont alloués, initialisés et gérés dans la version de débogage du tas de base, consultez les détails du tas de débogage CRT. Pour plus d’informations sur les types de blocs d’allocation et leur utilisation, consultez Types de blocs sur le tas de débogage. Pour plus d’informations sur les différences entre les fonctions de tas standard et les versions de débogage, consultez Les versions de débogage des fonctions d’allocation de tas.

Spécifications

Routine	En-tête requis
_malloc_dbg	<crtdbg.h>

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

Bibliothèques

Uniquement les versions de débogage des bibliothèques Runtime C.

Exemple

Pour obtenir un exemple d’utilisation _malloc_dbg, consultez crt_dbg1.

Voir aussi

Routines de débogage
malloc
_calloc_dbg