Guide du débogueur sous Delphi

Pour cela, il existe plusieurs méthodes :

• appui de F5 lorsque le curseur dans l'éditeur de code est sur la ligne
• clic dans la gouttière à gauche au niveau de la ligne

Cela aura pour effet de mettre en surbrillance la ligne sélectionnée.

Si vous exécutez le programme, le déroulement sera mis en pause juste avant l'exécution de la ligne du point d'arrêt.

Vous pouvez désactiver le point d'arrêt en cliquant avec le bouton droit sur le rond rouge et en cliquant sur Activé dans le menu contextuel. Pour le réactiver, refaites la même manipulation.
Pour supprimer un point d'arrêt, cliquez simplement sur le rond rouge ou bien tapez F5 sur la ligne.

À partir de là, vous avez la possibilité de vérifier, modifier les différentes valeurs de vos variables afin de vérifier votre code.

On ne peut pas poser des points d'arrêt partout. En effet, certaines lignes de code ne sont pas utilisables. C'est le cas par exemple de certaines lignes sur un with telles que celle-ci :

    with MaClasse do

Cette ligne n'appelle aucune méthode. C’est plus une aide au développement qu'une instruction réelle. Vous ne pourrez donc pas poser un point d'arrêt dessus.
Par contre, si le with appelle une méthode ou une procédure par exemple :

    with TMaClasse.Create do

vous pourrez poser un point d'arrêt: cette ligne appelle le constructeur de TMaClasse.

C'est le cas également des lignes end; de fermeture de bloc. On ne peut y poser de point d'arrêt sauf sur la dernière ligne d'une procédure ou d'une fonction.

Heureusement, Delphi vous informe sur les lignes qui peuvent être marquées:
si vous avez bien observé cette fameuse gouttière, vous avez vu des petits points bleus.

Ces petits points d'apparence anodine nous indiquent – entre autres – les lignes utilisables : s'il y a un point bleu, un point d'arrêt peut être posé, sinon, le point d'arrêt n'aura aucun effet. C'est aussi simple que ça.
Si toutefois, vous avez posé un point d'arrêt sur une ligne inutilisable, Delphi vous prévient en colorisant le point d'arrêt différemment lorsque vous exécutez :

Vous remarquerez également que l'icône dans la gouttière a changé.
Dans cet exemple, le point d'arrêt a été posé sur une ligne vide. Il n'y a pas de point bleu.
Cette colorisation se fait au moment de l'exécution et seulement à ce moment-là.

Il est également possible de définir des points d'arrêt qui stoppe le déroulement du programme suivant une ou plusieurs conditions.
Pour cela, ajoutez un point d'arrêt comme nous l'avons vu plus haut. Cliquez avec le bouton droit sur le rond rouge dans la gouttière puis cliquez sur Propriété du point d'arrêt dans le menu contextuel qui apparait. Cette boite de dialogue apparait :

Voici la description des champs disponibles :

• Condition : définit la condition à laquelle le point d'arrêt doit stopper le déroulement du programme ;
• Passes : définit le nombre de fois où le programme passe sur le point d'arrêt sans s'arrêter ;
• Groupe : crée un groupe de points d'arrêt auquel appartient ce point d'arrêt ;
• Bouton Avancées : permet d'accéder à des paramètres étendus qui vont modifier l'action qui se produit lorsque le point d'arrêt se déclenche.

II-C-1. Condition▲

(i=10) and (j=2)

II-C-2. Passes▲

var
  I: Integer;
begin
  for I := 1 to 10 do
    ShowMessage(IntToStr(I));
end;

II-C-3. Groupes▲

Vous pouvez avoir une vue d'ensemble des points d'arrêt définis en affichant la liste de ces points.
Pour cela, allez dans le menu Voir\Fenêtres de débogage\Points d'arrêt.
Une liste exhaustive des points spécifiés apparait ainsi que leurs paramètres.

L'appui de F8 ou bien sur l'icône correspondante dans la barre d'outils passera le déroulement à la ligne suivante dans l'éditeur de code en restant dans la même méthode.

L'appui de F7 produit la même action que l'appui sur F8 à la grosse différence près que le déroulement « rentre » dans les fonctions citées.

Prenons l'exemple suivant :

function Test: integer
begin
  Result := 10;
end;

procedure Execute;
var i: integer;
begin
 i := Test;
end;

Si l'on pose un point d'arrêt sur la ligne

i := Test;

le déroulement s'arrête sur cette ligne. Si vous appuyez sur F8, la ligne courante passe au-dessous. Par contre, si vous appuyez sur F7, la ligne passe dans la fonction Test.
Pour déboguer efficacement, il faut apprendre à utiliser ces deux fonctionnalités et jongler entre elles.

Vous pouvez indiquer au débogueur de stopper le déroulement de l'exécution sur la ligne du curseur dans l'éditeur de code. Autrement dit, sans ajouter de point d'arrêt. Très pratique pour tester rapidement le code que l'on vient d'écrire.

Si vous voulez reprendre le déroulement normal du programme, appuyez sur F9 ou bien cliquez dans le menu Exécuter\Exécuter ou sur le bouton ad hoc dans la barre d'outils ou.
Par contre, cela ne désactive pas les différents points d'arrêt définis qui pourront toujours se déclencher.

C'est la plus simple à obtenir. Il suffit pour cela de positionner votre curseur sur la variable qui vous intéresse. Un hint (bulle d'aide) s'affichera alors avec le contenu de la variable survolée.
Cette méthode est intéressante, car il n'y a rien à mettre en place. Toutefois, cela devient assez fastidieux lorsque vous devez surveiller plusieurs variables en même temps.

Cette liste se remplit automatiquement avec les variables déclarées dans la méthode parcourue actuellement et affiche leur contenu en temps réel lors du parcours du code.
Il est impossible de modifier cette liste.
Par défaut, cette boite se situe juste en dessous de la Liste des points de suivi.

Sinon pour l'afficher, cliquez dans le menu Voir\Fenêtres de débogage\Variables locales.

Lorsqu'il faut surveiller plusieurs valeurs lors du débogage, il est intéressant de les avoir toutes sous les yeux en même temps. C'est ce que permettent les points de suivi.
Avant toute chose, il faut vérifier que la boite qui contient les points de suivi est affichée. Si vous avez laissé les options par défaut, elle se trouve dans la partie gauche de l'EDI, au milieu :

Sinon, vous pouvez l'afficher en cliquant dans le le menu Voir\Fenêtres de débogage\Points de suivi.

Cette liste contient tous les points de suivi ainsi que les valeurs courantes.
Pour ajouter un point de suivi, cliquez dans l'éditeur de code sur la variable que vous souhaitez contrôler puis faites Ctrl+F5. Cela aura pour effet d'ajouter cette variable dans la liste.

Vous pouvez également ajouter un point de suivi en faisant Exécuter\Ajouter un point de suivi…. La boite de dialogue suivante apparait alors :

Saisissez alors dans le champ Expression la valeur que vous souhaitez surveiller.
Si vous utilisez une fonction dans votre valeur, par exemple :

Length(MaPhrase)

vous devez cocher Autoriser les appels de fonction.
En règle générale, vous pouvez laisser cette option cochée, quelle que soit la valeur.

On peut noter également que lorsque l'on suit un type structuré (un record ou une classe), on peut accéder à tous les champs de cette structure :

Toutefois, il y a des situations où la liste des points de suivi sera incapable de vous afficher la valeur. Cela peut provenir de plusieurs raisons :

• la variable a été supprimée par le compilateur : la variable n'est pas ou plus utilisée à l'endroit du suivi, il n'y a plus aucun accès à cette variable ;
• la variable n'existe pas : la variable n'existe pas dans la portion de code parcourue ;
• violation d'accès : la variable (en général, une classe) n'a pas été créée ;
• etc.

La liste des points de suivi opère sur les variables telles qu'elles sont définies dans le code. C'est-à-dire que par exemple, une variable locale dans une procédure ne sera vérifiable que dans cette procédure sauf si l'on parcourt une autre portion de code qui contient cette variable.
Par exemple, reprenons le code précédent :

function Test: integer
begin
  Result := 10;
end;

procedure Execute;
var i: integer;
begin
 i := Test;
end;

et ajoutons un suivi sur Result. Comme vous pouvez le voir, cette variable est seulement disponible dans la fonction Test. Si l'on met un point d'arrêt sur la ligne

i := Test;

la variable Result ne sera pas accessible. Elle le sera seulement lorsque le déroulement passera dans cette fonction Test.
Un clic droit sur un des éléments de la liste donne accès à des actions telles que :

• modifier le point de suivi ;
• ajouter un point de suivi ;
• désactiver le point de suivi ;
• supprimer le point de suivi ;
• copier la valeur du suivi ;
• copier le nom du suivi ;
• activer tous les points de suivi ;
• désactiver tous les points de suivi ;
• supprimer tous les points de suivi ;
• etc.

Pour compléter toutes ces fonctions, il est également possible de modifier la valeur des variables. En effet, si vous faites Exécuter\Evaluer/Modifier… (ou Ctrl+F7), Delphi affichera une boite de dialogue comme celle-ci :

Le champ Expression permet de spécifier la variable que l'on veut évaluer ou modifier. Le champ Résultat est en lecture seule et affiche la valeur contenue dans la variable. Le champs Nouvelle valeur permet de modifier la valeur de l'expression.

Pour utiliser cette boite de dialogue, il faut tout d'abord spécifier la variable. Ensuite, cliquez sur Evaluer pour remplir le champ Résultat
Si vous spécifiez une nouvelle valeur dans le champ du même nom, cliquez ensuite sur Modifier. Si tout s'est bien passé, vous verrez le résultat se modifier et prendre la valeur que vous avez spécifiée.
Ainsi, si vous poursuivez le déroulement de l'exécution, ce sera avec la nouvelle valeur que vous avez définie.

Il est également possible d'ajouter un point de suivi depuis cette boite de dialogue en cliquant sur Suivi. Un point de suivi s'ajoutera automatiquement alors dans la liste des points de suivi.

Avant BDS2005, cette méthode était la plus rapide puisque le système d'affichage des valeurs dans les bulles d'aide (Hint) n'existait pas encore.