Partager via


Routines de débogage

La version Debug de la bibliothèque Runtime C fournit de nombreux services de diagnostic qui facilitent le débogage des programmes et permettent aux développeurs de :

  • passer directement dans les fonctions d’exécution pendant le débogage ;

  • résoudre les assertions, les erreurs et les exceptions ;

  • suivre les allocations de tas et empêcher les fuites de mémoire ;

  • signaler des messages de débogage à l’utilisateur.

Versions Debug des routines de la bibliothèque Runtime C

Pour utiliser ces routines, l’indicateur _DEBUG doit être défini. Toutes ces routines ne font rien dans une version commerciale d’une application. Pour plus d’informations sur l’utilisation des nouvelles routines de débogage, consultez les techniques de débogage CRT.

Routine Utiliser
_ASSERT Évaluer une expression et générer un rapport de débogage lorsque le résultat est FALSE
_ASSERTE Semblable à _ASSERT, mais inclut l’expression qui a échoué dans le rapport généré
_CrtCheckMemory Confirmer l’intégrité des blocs de mémoire alloués sur le tas de débogage
_CrtDbgBreak Définir un point d’arrêt
_CrtDbgReport, _CrtDbgReportW Générer un rapport de débogage avec un message de l’utilisateur et envoyer le rapport à trois destinations possibles
_CrtDoForAllClientObjects Appeler une fonction fournie par l’application pour tous les types _CLIENT_BLOCK sur le tas
_CrtDumpMemoryLeaks Vider tous les blocs de mémoire sur le tas de débogage quand une fuite de mémoire importante s’est produite
_CrtIsMemoryBlock Vérifier qu’un bloc de mémoire spécifié se trouve dans le tas local et qu’il a un identificateur de type de bloc de tas de débogage valide
_CrtIsValidHeapPointer Vérifier qu’un pointeur spécifié se trouve dans le tas local
_CrtIsValidPointer Vérifier qu’une plage de mémoire spécifiée est valide pour la lecture et l’écriture
_CrtMemCheckpoint Obtenir l’état actuel du tas de débogage et le stocker dans une structure _CrtMemState fournie par l’application
_CrtMemDifference Comparer deux états de mémoire pour déterminer des différences significatives et retourner les résultats
_CrtMemDumpAllObjectsSince Vider des informations sur des objets du tas depuis un point de contrôle spécifié ou le début de l’exécution du programme
_CrtMemDumpStatistics Vider les informations d’en-tête de débogage pour un état de mémoire spécifié dans un format lisible par l’utilisateur
_CrtReportBlockType Retourne le type/sous-type de bloc associé à un pointeur de bloc de tas de débogage donné.
_CrtSetAllocHook Installer une fonction d’allocation définie par le client en la raccordant au processus d’allocation de mémoire de débogage du runtime C
_CrtSetBreakAlloc Définir un point d’arrêt sur un numéro d’ordre d’allocation d’objet spécifié
_CrtSetDbgFlag Récupérer ou modifier l’état de l’indicateur _crtDbgFlag pour contrôler le comportement d’allocation du gestionnaire du tas de débogage
_CrtSetDumpClient Installer une fonction définie par l’application qui est appelée chaque fois qu’une fonction de vidage du débogage est appelée pour vider des blocs de mémoire de type _CLIENT_BLOCK
_CrtSetReportFile Identifier le fichier ou flux que _CrtDbgReport doit utiliser en tant que destination d’un type de rapport spécifique
_CrtSetReportHook Installer une fonction de création de rapports définie par le client en la raccordant au processus de création de rapports de débogage du runtime C
_CrtSetReportHook2, _CrtSetReportHookW2 Installer ou désinstaller une fonction de création de rapports définie par le client en la raccordant au processus de création de rapports de débogage du runtime C
_CrtSetReportMode Spécifier la ou les destinations générales d’un type de rapport spécifique généré par _CrtDbgReport
_RPT[0,1,2,3,4] Suivre la progression de l’application en générant un rapport de débogage en appelant _CrtDbgReport avec une chaîne de format et un nombre variable d’arguments. Ne fournit aucune information sur le fichier source ou le numéro de ligne.
_RPTF[0,1,2,3,4] Similaire aux macros _RPTn, mais fournit le nom du fichier source et le numéro de ligne d’où provient la demande de rapport
_calloc_dbg Allouer un nombre spécifié de blocs de mémoire sur le tas avec un espace supplémentaire pour un en-tête de débogage et remplacer les mémoires tampons
_expand_dbg Redimensionner un bloc de mémoire spécifié sur le tas l’augmentant ou en le diminuant
_free_dbg Libérer un bloc de mémoire sur le tas
_fullpath_dbg, _wfullpath_dbg Créez un nom de chemin d’accès absolu ou complet pour le nom de chemin relatif spécifié, à l’aide de _malloc_dbg l’allocation de mémoire.
_getcwd_dbg, _wgetcwd_dbg Obtenez le répertoire de travail actuel à l’aide _malloc_dbg de l’allocation de mémoire.
_malloc_dbg Allouer un bloc de mémoire sur le tas avec un espace supplémentaire pour un en-tête de débogage et remplacer des mémoires tampons
_msize_dbg Calculer la taille d’un bloc de mémoire dans le tas
_realloc_dbg Réallouer un bloc de mémoire spécifié dans le tas en déplaçant et/ou redimensionnant le bloc
_strdup_dbg, _wcsdup_dbg Dupliquer une chaîne à l’aide _malloc_dbg de l’allocation de mémoire.
_tempnam_dbg, _wtempnam_dbg Générez des noms que vous pouvez utiliser pour créer des fichiers temporaires à l’aide _malloc_dbg de l’allocation de mémoire.

Routines runtime C qui ne sont pas disponibles dans le formulaire de code source

Le débogueur peut être utilisé pour parcourir le code source de la plupart des autres routines runtime C pendant le processus de débogage. Toutefois, Microsoft considère que certaines technologies sont propriétaires et, par conséquent, ne fournit pas le code source pour un sous-ensemble de ces routines. La plupart de ces routines appartiennent à la gestion des exceptions ou aux groupes de traitement à virgule flottante, mais certaines autres sont également incluses. Le tableau suivant répertorie ces routines.

Bien que le code source soit disponible pour la printf plupart des routines, scanf ils effectuent un appel interne à une autre routine pour laquelle le code source n’est pas fourni.

Routines qui se comportent différemment dans une version Debug d’une application

Certaines fonctions de Runtime C et certains opérateurs C++ se comportent différemment quand ils sont appelés à partir d’une version Debug d’une application. (Vous pouvez créer une build de débogage d’une application en définissant l’indicateur _DEBUG ou en liant une version de débogage de la bibliothèque runtime C.) Les différences comportementales se composent généralement de fonctionnalités ou d’informations supplémentaires fournies par la routine pour prendre en charge le processus de débogage. Le tableau suivant répertorie ces routines.

Routine C abort

Routine C assert

Opérateur C++ delete

Opérateur C++ new

Voir aussi

Routines du runtime C universel par catégorie
Vérification des erreurs d’exécution