Bopd : Fonctions de debugging.

Fichier à inclure.
Les fonctions.

Fonctionnalités.

Quelques fonctions apportant une aide au debugging.
Elles ne sont pas très sophistiquées, mais permettent de tracer l'exécution d'un programme en affichant des valeurs pertinentes.
Ces fonctions ne sont activées que lorsque la variable du préprocesseur DEBUG est > 0.
Il serait très probablement une très mauvaise idée de définir à une autre valeur que 0 la variable DEBUG dans un contexte de production.

API.

Fichier à inclure.

#include <bop.2/bop.h>

Les fonctions.

• void bopdTace( ... )
  Cette fonction prend les arguments que peut prendre la fonction printf(1),
  agit comme printf mais envoie les données sur stderr.
  
• void bopdEnter( void )
  Affiche sur stderr le nom de la fonction courante en l'indentant.
  Si elle est utilisée, cette fonction devrait être appelée une fois par fonction (typiquement à l'entrée de la fonction) et utilisée conjointement à bopdReturn( ).
  
• void bopdBack( )
  Affiche sur stderr le nom de la fonction courante en l'indentant.
  Si elle est utilisée, cette fonction devrait être appelée une fois par fonction (typiquement avant le retour d'une fonction void) et utilisée conjointement à bopEnter( ).
  
• void bopdReturn( val )
  Affiche sur stderr le nom de la fonction courante en l'indentant.
  La valeur val castée à un long est écrite en notation hexadécimale.
  Si elle est utilisée, cette fonction devrait être appelée une fois par fonction (typiquement avant son retour) et utilisée conjointement à bopEnter( ).
  

Exemples.

Reste à faire.

Voir aussi.