_calloc_dbg

Article
03/04/2013

Alloue un certain nombre de blocs de mémoire dans le tas avec l'espace supplémentaire pour un en-tête de débogage et les mémoires tampons de remplacer (version debug uniquement).

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

Paramètres

num
Nombre demandé de blocs de mémoire.
size
taille demandée de chaque bloc de mémoire (octets).
blockType
type demandé de bloc de mémoire : _CLIENT_BLOCK ou _NORMAL_BLOCK.

Pour plus d'informations sur les types de bloc d'allocation et leur utilisation, consultez types de blocs sur le tas de débogage.
filename
Pointeur vers le nom du fichier source qui a demandé l'opération ou l' NULLd'allocation.
linenumber
Numéro de ligne dans le fichier source où l'opération d'allocation a été demandée ni NULL.

Les paramètres d' filename et d' linenumber sont uniquement disponibles si _calloc_dbg a été appelé explicitement ou la constante de préprocesseur de _CRTDBG_MAP_ALLOC a été définie.

Valeur de retour

En cas de réussite, cette fonction retourne un pointeur vers la partie utilisateur du dernier bloc de mémoire alloué, appelle la fonction gestionnaire, ou retourne NULL.Pour une description complète du comportement de retour, consultez la section Notes.Pour plus d'informations sur la façon dont la nouvelle fonction gestionnaire est utilisée, consultez la fonction de calloc .

Notes

_calloc_dbg est une version debug de la fonction de calloc .Lorsque _DEBUG n'est pas défini, chaque appel à _calloc_dbg est réduit à un appel à calloc.calloc et _calloc_dbg allouent des blocs de mémoire de num dans le tas de base, mais offre d' _calloc_dbg plusieurs fonctionnalités de débogage :

Mémoires tampons de chaque côté de la partie utilisateur du bloc à déterminer des fuites.
Un paramètre de type de bloc pour suivre des types spécifiques d'allocation.
filename/informations d'linenumber pour déterminer l'origine des demandes d'allocation.

_calloc_dbg alloue chaque bloc de mémoire avec un peu plus d'espace que sizedemandé.L'espace supplémentaire est utilisé par le gestionnaire du tas de débogage pour lier les blocs de mémoire de débogage et pour fournir à l'application les informations d'en-tête du débogage et remplacer des 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 remplacer est remplie avec 0xFD.

ensembles errno d'_calloc_dbg à ENOMEM si une allocation de mémoire échoue ; EINVAL est retourné si la quantité de mémoire nécessaire (charge mémoire y compris mentionnée précédemment) dépasse _HEAP_MAXREQ.Pour plus d'informations sur ce point et d'autres codes d'erreur, consultez errno, _doserrno, _sys_errlist, et _sys_nerr.

Pour plus d'informations sur la manière dont les blocs de mémoire sont alloués, initialisés, et gérés dans la version debug de tas de base, consultez gestion de la mémoire et le tas de débogage.Pour plus d'informations sur les différences entre appeler une fonction standard du tas et sa version debug dans une version debug d'une application, consultez À l'aide de la version debug ou la version de base.

Configuration requise

routine	en-tête requis
_calloc_dbg	<crtdbg.h>

Pour plus d'informations de compatibilité, consultez compatibilité dans l'introduction.

Exemple

// crt_callocd.c
/*
 * This program uses _calloc_dbg to allocate space for
 * 40 long integers. It initializes each element to zero.
 */
#include <stdio.h>
#include <malloc.h>
#include <crtdbg.h>

int main( void )
{
        long *bufferN, *bufferC;

        /* 
         * Call _calloc_dbg to include the filename and line number
         * of our allocation request in the header and also so we can
         * allocate CLIENT type blocks specifically
         */
        bufferN = (long *)_calloc_dbg( 40, sizeof(long), _NORMAL_BLOCK, __FILE__, __LINE__ );
        bufferC = (long *)_calloc_dbg( 40, sizeof(long), _CLIENT_BLOCK, __FILE__, __LINE__ );
        if( bufferN != NULL && bufferC != NULL )
              printf( "Allocated memory successfully\n" );
        else
              printf( "Problem allocating memory\n" );

        /* 
         * _free_dbg must be called to free CLIENT type blocks
         */
        free( bufferN );
        _free_dbg( bufferC, _CLIENT_BLOCK );
}