Nouveau : la formation trading algorithmique MQL5, MQL4 et ProRealTimeDécouvrir →

MQL4 · Codes d’erreur

Erreurs de compilation MQL4 : comprendre et corriger les messages de MetaEditor

Undeclared identifier, unexpected end of program, possible loss of data : les messages de compilation de MetaEditor décodés, avec la méthode pour les corriger et le rôle de #property strict.

Mis à jour le 23 octobre 2026Lecture : 8 minPar Alix, OptiBot Trading

Une erreur de compilation n’a rien à voir avec les codes renvoyés par GetLastError() : elle survient avant que le programme ne tourne. Lorsque vous compilez un fichier .mq4 dans MetaEditor (touche F7 ou bouton « Compile »), le compilateur analyse le code source et produit, s’il n’y trouve pas d’erreur, un fichier exécutable .ex4. Les problèmes détectés s’affichent dans l’onglet Errors de la fenêtre Toolbox, avec le nom du fichier, la ligne, la colonne et un message en anglais.

Tant qu’il reste une seule erreur, aucun fichier .ex4 à jour n’est produit, et le terminal continue d’utiliser l’ancienne version compilée s’il en existe une. C’est un piège classique : on modifie le code, on recompile, une erreur passe inaperçue, et l’EA sur le graphique tourne toujours avec l’ancien comportement. L’angle de cette page est la lecture des messages : savoir ce qu’ils veulent dire et par où commencer quand la liste est longue.

Erreurs et avertissements

Le compilateur distingue deux catégories de messages :

  • les erreurs empêchent la production du fichier .ex4 : le programme est invalide ;
  • les avertissements (warnings) n’empêchent pas la compilation, mais signalent une construction suspecte, qui fonctionne peut-être mais révèle souvent un défaut.

En bas de l’onglet Errors, MetaEditor récapitule le nombre d’erreurs et d’avertissements. L’objectif à viser est zéro erreur et zéro avertissement : un avertissement ignoré aujourd’hui est fréquemment l’explication d’un comportement étrange demain.

La méthode : toujours commencer par la première erreur

Un double clic sur un message place le curseur sur la ligne concernée. Corrigez la première erreur de la liste, puis recompilez. Une seule faute de syntaxe, comme un point-virgule ou une accolade manquante, désorganise l’analyse de tout le reste du fichier et produit des dizaines de messages en cascade, qui disparaissent d’un coup une fois la cause corrigée. Chercher à corriger la vingtième erreur avant la première est une perte de temps.

Attention aussi à la ligne indiquée : le compilateur signale l’endroit où il constate le problème, qui peut être situé après la faute réelle. Un point-virgule oublié en fin de ligne est souvent signalé au début de la ligne suivante.

Les messages les plus fréquents

Message (extrait)SignificationCorrection habituelle
undeclared identifierUn nom de variable ou de fonction est inconnuVérifier l’orthographe, la casse, la déclaration et la portée
unexpected end of programLe fichier se termine alors qu’un bloc est ouvertRechercher une accolade fermante manquante
unbalanced parenthesesParenthèses ouvrantes et fermantes en nombre différentRecompter les parenthèses de l’expression
function not definedUne fonction est appelée mais jamais définieÉcrire la fonction, inclure le bon fichier ou corriger son nom
wrong parameters countMauvais nombre d’arguments dans un appelComparer à la signature de la fonction
variable already definedDeux déclarations du même nom dans la même portéeRenommer ou supprimer la déclaration en double
not all control paths return a valueUne fonction non void peut se terminer sans returnAjouter un return dans toutes les branches
possible loss of data due to type conversionAvertissement : conversion implicite, par exemple double vers intConvertir explicitement, par exemple (int)valeur
return value of 'OrderSend' should be checkedAvertissement : la valeur de retour d’une fonction importante est ignoréeTester la valeur renvoyée
declaration of '...' hides global variableAvertissement : une variable locale porte le nom d’une variable globaleRenommer la variable locale

Le libellé exact peut varier légèrement selon la version de MetaEditor, mais la logique reste la même. Lisez toujours le nom placé entre apostrophes au début du message : c’est l’élément du code qui pose problème.

Un exemple commenté

Le petit EA ci-dessous contient volontairement plusieurs fautes typiques, signalées en commentaire, suivies de la version corrigée.

//--- VERSION FAUTIVE : chaque commentaire indique le message produit
#property strict

input int InpPeriod = 14;

double Moyenne(int periode)
  {
   double somme = 0;
   for(int i = 0; i < periode; i++)
      somme += Close[i];
   if(periode > 0)
      return somme / periode;
   // pas de return ici : "not all control paths return a value"
  }

void OnTick()
  {
   int valeur = Moyenne(InpPeriod);    // "possible loss of data due to type conversion"
   OrderSend(Symbol(), OP_BUY, 0.1, Ask, 3, 0, 0);
                                       // "return value of 'OrderSend' should be checked"
   Print(Valeur);                      // "'Valeur' - undeclared identifier" (casse)
  }

//--- VERSION CORRIGÉE
#property strict

input int InpPeriod = 14;

double Moyenne(const int periode)
  {
   if(periode <= 0)
      return 0.0;                       // toutes les branches renvoient une valeur
   double somme = 0;
   for(int i = 0; i < periode && i < Bars; i++)
      somme += Close[i];
   return somme / periode;
  }

void OnTick()
  {
   double valeur = Moyenne(InpPeriod);  // type cohérent : pas de conversion implicite
   int ticket = OrderSend(Symbol(), OP_BUY, 0.1, NormalizeDouble(Ask, Digits),
                          3, 0, 0, "", 0, 0, clrNONE);
   if(ticket < 0)
      Print("OrderSend : erreur ", GetLastError());
   Print(valeur);
  }

Les deux versions ne doivent évidemment pas figurer dans le même fichier : la première sert seulement à associer chaque faute à son message. MQL4 est sensible à la casse : Valeur et valeur sont deux identifiants différents, d’où l’erreur undeclared identifier.

Le rôle de #property strict

La directive #property strict active un mode de compilation plus rigoureux, aligné sur les règles de MQL5. Les nouveaux modèles créés par l’assistant de MetaEditor l’incluent. Avec ce mode, le compilateur signale davantage de constructions douteuses : conversions implicites, valeurs de retour ignorées, variables masquées. Certains anciens codes MQL4, écrits avant ce mode, compilent sans lui mais produisent des erreurs ou de nombreux avertissements une fois la directive ajoutée.

Faut-il retirer #property strict pour faire compiler un vieux code ? C’est une solution de facilité qui masque des défauts réels. Mieux vaut corriger les messages un par un : c’est aussi la meilleure préparation à une éventuelle migration vers MQL5. Les effets précis de la directive sont détaillés dans #property strict.

Cas pratiques et pièges

Fichiers d’inclusion

Une erreur peut être signalée dans un fichier .mqh inclus plutôt que dans votre fichier principal. Le nom du fichier figure dans le message : ouvrez-le pour corriger, ou vérifiez que vous incluez la bonne version. Une fonction comme ErrorDescription() provoque une erreur undeclared identifier tant que #include <stdlib.mqh> est absent, comme le rappelle la page GetLastError en MQL4.

Code MQL5 collé dans un fichier MQL4

Un extrait trouvé en ligne peut utiliser des fonctions propres à MQL5, comme CopyBuffer ou la classe CTrade, qui n’existent pas en MQL4 : le compilateur les signale comme identifiants inconnus. Vérifiez toujours la plateforme d’origine d’un exemple. Les différences entre les deux langages sont présentées dans la rubrique Migrer de MQL4 vers MQL5.

Le terminal n’a pas pris la nouvelle version

Après une compilation réussie, le terminal recharge en principe l’EA sur les graphiques. En cas de doute, vérifiez la date du fichier .ex4 dans le dossier MQL4\Experts, ou ajoutez un message de version dans OnInit(). L’environnement de travail de MetaEditor est présenté dans MetaEditor pour MQL4.

Compiler n’est pas tester

Un programme qui compile sans erreur n’est pas un programme correct. Les erreurs d’exécution (division par zéro, indice hors limites) et les refus du serveur (stops invalides, volume invalide) n’apparaissent qu’au fonctionnement. Les autres pages de la rubrique Codes d’erreur MQL4 couvrent ces cas.

Un EA qui compile n’est pas pour autant prêt pour un compte réel. Après chaque modification, recompilez sans avertissement, puis testez le comportement en backtest et en démonstration. Le trading comporte un risque de perte en capital.

Questions fréquentes

Pourquoi ma modification n’a-t-elle aucun effet sur l’EA ?

Probablement parce que la compilation a échoué : tant qu’il reste une erreur, aucun nouveau fichier .ex4 n’est produit et le terminal utilise l’ancienne version. Vérifiez l’onglet Errors après chaque compilation.

Par quelle erreur commencer quand la liste est longue ?

Par la première. Une seule faute de syntaxe peut provoquer de nombreuses erreurs en cascade, qui disparaissent quand la cause est corrigée. Recompilez après chaque correction.

Faut-il corriger les avertissements ?

Oui, autant que possible. Ils n’empêchent pas la compilation, mais signalent souvent un vrai défaut : conversion qui tronque une valeur, valeur de retour non testée, variable masquée.

Que signifie « undeclared identifier » ?

Que le compilateur ne connaît pas le nom utilisé : faute de frappe, différence de majuscule, variable déclarée dans une autre portée, ou fonction provenant d’un fichier d’inclusion absent.

A

Alix · fondateur d’OptiBot Trading

Développeur MQL5 et ProBuilder, spécialiste du backtest et de l’optimisation de stratégies automatiques. Chaque contenu est vérifié sur la documentation officielle (MQL5.com, manuels ProRealTime) et testé avant publication. Notre méthode éditoriale.