MQL5 · Bases du langage
Print, Comment et Alert en MQL5 : déboguer avec le journal
Écrire des messages exploitables dans le journal avec Print et PrintFormat, afficher un tableau de bord avec Comment, alerter avec Alert : formats, limites documentées et bonnes pratiques de journalisation.
MQL5 offre trois moyens principaux d’afficher une information pendant l’exécution. Print() et PrintFormat() écrivent une ligne dans le journal des Experts : c’est l’outil de base du débogage et de la traçabilité. Comment() affiche un texte dans le coin supérieur gauche du graphique, idéal pour un tableau de bord. Alert() ouvre une fenêtre d’alerte avec un son, réservée aux événements qui exigent votre attention. Retenez deux limites documentées : Print(), PrintFormat() et Comment() ne fonctionnent pas pendant une optimisation dans le Strategy Tester, et Alert() ne fonctionne pas du tout dans le testeur.
Cette page fait partie de la rubrique Les bases du langage MQL5. Pour un débogage pas à pas avec points d’arrêt, voir Bien utiliser MetaEditor.
Print : écrire dans le journal
Print(argument, ...) accepte jusqu’à 64 arguments séparés par des virgules et les écrit, concaténés, dans le journal de l’Expert Advisor. La documentation précise le format par défaut des différents types :
double: jusqu’à 16 chiffres après la virgule, en notation standard ou scientifique selon la plus compacte ;float: 5 chiffres après la virgule ;bool:trueoufalse;datetime:AAAA.MM.JJ HH:MI:SS.
Un tableau ne peut pas être passé directement : il faut l’afficher élément par élément, ou utiliser ArrayPrint() pour les tableaux de types simples et de structures simples.
Le format par défaut des double est rarement satisfaisant pour un prix : Print(prix) peut afficher des chiffres parasites dus à la représentation binaire. Convertissez avec DoubleToString(prix, _Digits), ou utilisez PrintFormat().
PrintFormat : contrôler le format
PrintFormat(format, ...) fonctionne comme printf en C. La chaîne de format contient du texte et des spécificateurs de la forme %[drapeaux][largeur][.précision]type. Les types les plus utiles :
| Spécificateur | Usage |
|---|---|
%d | Entier signé (int) |
%I64d / %I64u | Entier 64 bits signé ou non signé (long, ulong, ticket) |
%.2f | Réel avec deux décimales (montant) |
%.*f | Réel dont la précision est passée en argument (prix avec _Digits) |
%s | Chaîne |
%e / %g | Notation scientifique ou forme la plus compacte |
%% | Le caractère pour cent |
La documentation limite PrintFormat() à 64 paramètres, chaîne de format comprise. StringFormat() suit exactement les mêmes règles mais renvoie la chaîne au lieu de l’écrire, ce qui permet de la réutiliser dans Comment() ou dans une notification.
Où lire les messages
Dans le terminal, la fenêtre Boîte à outils comporte un onglet Experts, qui reçoit les messages de vos programmes, et un onglet Journal, qui reçoit les messages du terminal lui-même (connexion, chargement des programmes, exécution des ordres). Lors d’un test, les messages apparaissent dans l’onglet Journal du Strategy Tester. Les journaux sont également enregistrés sous forme de fichiers texte, un par jour, accessibles par un clic droit dans l’onglet puis l’ouverture du dossier.
Prenez l’habitude de lire les deux onglets : un ordre refusé apparaît souvent avec plus de détails dans le Journal du terminal que dans votre propre message.
Comment : un tableau de bord sur le graphique
Comment(argument, ...) affiche ses arguments dans le coin supérieur gauche du graphique. Selon la documentation, elle accepte jusqu’à 64 paramètres, et le texte affiché est tronqué au-delà de 2 045 caractères. Les sauts de ligne s’écrivent \n. Chaque appel remplace le texte précédent ; pour effacer l’affichage, appelez Comment(""), typiquement dans OnDeinit().
Comment() convient pour afficher en continu l’état d’un EA : spread courant, signal en cours, nombre de positions, résultat du jour. Comme elle est rafraîchie à chaque appel, limitez sa fréquence (par exemple une fois par seconde ou à chaque nouvelle bougie) pour ne pas alourdir OnTick(). Pour une présentation plus riche, les objets graphiques et les panneaux sont présentés dans Panneaux et boutons (CAppDialog).
Alert : attirer l’attention
Alert(argument, ...) affiche une fenêtre avec le message et joue un son. Elle accepte jusqu’à 64 arguments ; les double y sont affichés avec 8 décimales par défaut. La documentation précise qu’elle ne fonctionne pas dans le Strategy Tester. Réservez-la aux situations qui demandent une intervention : perte de connexion prolongée, erreur répétée de passage d’ordre, limite de perte atteinte. Une alerte à chaque signal devient vite un bruit que l’on finit par ignorer. Les notifications à distance (e-mail, push) sont traitées dans Alertes, e-mails et notifications push.
Journaliser les erreurs avec GetLastError
La plupart des fonctions signalent un échec par leur valeur de retour et enregistrent un code dans la variable _LastError, lisible avec GetLastError(). Le schéma sûr consiste à appeler ResetLastError() juste avant l’opération, puis à lire GetLastError() immédiatement en cas d’échec et à l’inclure dans le message. Sans remise à zéro, vous risquez de journaliser un code laissé par une opération antérieure. La signification des codes est détaillée dans GetLastError et gestion des erreurs.
Exemple complet : journal structuré et tableau de bord
//+------------------------------------------------------------------+
//| EA : Print, PrintFormat, Comment, Alert et GetLastError |
//+------------------------------------------------------------------+
input bool InpLogDetaille = false; // Journalisation detaillee
//--- Message de journal avec un mot-cle stable en tete
void Log(const string niveau, const string message)
{
PrintFormat("%s | %s | %s", niveau, _Symbol, message);
}
int OnInit()
{
Log("INFO", StringFormat("Demarrage, %d decimales, point = %.*f", _Digits, _Digits, _Point));
// Lecture d'un indicateur avec journalisation de l'erreur eventuelle
ResetLastError();
int h = iATR(_Symbol, _Period, 14);
if(h == INVALID_HANDLE)
{
Log("ERREUR", StringFormat("iATR impossible, code %d", GetLastError()));
return(INIT_FAILED);
}
return(INIT_SUCCEEDED);
}
void OnTick()
{
static datetime dernierAffichage = 0;
datetime maint = TimeCurrent();
if(maint - dernierAffichage < 1) // rafraichissement au plus une fois par seconde
return;
dernierAffichage = maint;
MqlTick tick;
if(!SymbolInfoTick(_Symbol, tick))
return;
long spread = SymbolInfoInteger(_Symbol, SYMBOL_SPREAD);
double equite = AccountInfoDouble(ACCOUNT_EQUITY);
int positions = PositionsTotal();
// Tableau de bord sur le graphique
Comment(StringFormat("Bid %s Ask %s\nSpread %I64d points\nPositions %d\nEquite %.2f",
DoubleToString(tick.bid, _Digits), DoubleToString(tick.ask, _Digits),
spread, positions, equite));
if(InpLogDetaille)
Log("DEBUG", StringFormat("spread=%I64d positions=%d", spread, positions));
// Alerte unique si le spread devient anormal (Alert est inactive dans le testeur)
static bool alerteEmise = false;
if(spread > 100 && !alerteEmise)
{
Alert(_Symbol, " : spread anormal de ", spread, " points");
alerteEmise = true;
}
else if(spread <= 100)
alerteEmise = false;
}
void OnDeinit(const int reason)
{
Comment(""); // efface le texte du graphique
Log("INFO", StringFormat("Arret, motif %d", reason));
}
Le mot-clé en tête de chaque ligne (INFO, ERREUR, DEBUG) permet de filtrer le fichier journal ; l’alerte n’est émise qu’une fois par épisode de spread anormal ; et Comment("") nettoie le graphique à l’arrêt.
Une méthode de débogage par le journal
Quand un EA ne fait pas ce que vous attendez (aucun trade, ou des trades au mauvais moment), le journal permet de localiser le problème en quelques minutes, à condition de procéder par étapes.
- Vérifiez que le gestionnaire est appelé : un
Print("OnTick")temporaire, limité à quelques occurrences avec un compteurstatic, confirme que l’EA reçoit bien des ticks. - Affichez chaque filtre : pour chaque condition bloquante (horaire, spread, position déjà ouverte), journalisez la valeur testée et le résultat. Le premier filtre qui renvoie systématiquement faux est souvent le coupable.
- Affichez les données d’entrée du signal : valeurs d’indicateurs aux index utilisés, avec l’heure de la bougie correspondante. Une valeur nulle ou identique d’un appel à l’autre révèle une copie échouée ou une indexation inversée.
- Affichez le résultat de l’envoi d’ordre : code de retour du serveur, prix, volume et stops demandés.
- Retirez ou désactivez ensuite ces messages : un journal surchargé masque les informations importantes.
Cette démarche fonctionne aussi bien en compte de démonstration qu’en backtest visuel, où l’on peut comparer chaque message avec la bougie affichée.
Bonnes pratiques
- Journalisez les décisions, pas les ticks : une ligne par ouverture, modification, fermeture ou refus d’ordre, avec les valeurs qui l’ont motivée.
- Incluez toujours le contexte : symbole, ticket, prix, code d’erreur.
- Rendez le niveau de détail réglable par un paramètre ou par la compilation conditionnelle (
#ifdef _DEBUG). - N’utilisez pas le journal en optimisation : il y est désactivé. Pour exploiter des résultats de passes, utilisez
OnTester()ou les frames. - Limitez Comment() à quelques lignes lisibles, rafraîchies à un rythme raisonnable.
FAQ
Pourquoi mes Print n’apparaissent-ils pas pendant l’optimisation ?
C’est le comportement documenté : Print(), PrintFormat() et Comment() ne fonctionnent pas pendant une optimisation dans le Strategy Tester. En backtest simple, les messages apparaissent dans l’onglet Journal du testeur.
Comment effacer le texte affiché par Comment ?
Appelez Comment(« ») avec une chaîne vide. Faites-le dans OnDeinit() pour ne pas laisser de texte sur le graphique après le retrait de l’EA.
Alert fonctionne-t-il dans le Strategy Tester ?
Non. La documentation précise qu’Alert() ne fonctionne pas dans le testeur. Pour tracer un événement en backtest, utilisez Print().
Comment afficher un prix avec le bon nombre de décimales ?
Utilisez PrintFormat avec le spécificateur %.*f et _Digits comme précision, ou DoubleToString(prix, _Digits). Le format par défaut de Print peut afficher jusqu’à 16 décimales.
- Types de données en MQL5
- Variables, constantes et portée
- Paramètres input et sinput
- Opérateurs et expressions
- Conditions if, else et switch
- Boucles for, while et do while
- Écrire ses propres fonctions
- Tableaux statiques et dynamiques
- ArraySetAsSeries et indexation des séries
- Manipuler les chaînes de caractères
- Dates, heures et fuseaux
- Structures (struct) et MqlRates, MqlTick
- Énumérations (enum) personnalisées
- #include, #define et #property
- Les fonctions événementielles
- NormalizeDouble et précision des prix
- SymbolInfoDouble, SymbolInfoInteger
- AccountInfoDouble : lire les informations du compte
- Bien utiliser MetaEditor
