ErrorDescription - bibliothèque pour MetaTrader 5

La bibliothèque contient les fonctions suivantes :

• TradeServerReturnCodeDescription - renvoie la description des codes de retour du serveur de trades ;
• ErrorDescription - renvoie la description des erreurs d'exécution.

//+------------------------------------------------------------------+
//|                                             ErrorDescription.mqh |
//|                        Copyright 2010, MetaQuotes Software Corp. |
//|                                              http://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "2010, MetaQuotes Software Corp."
#property link      "http://www.mql5.com"
#property version   "1.00"
//+------------------------------------------------------------------+
//| renvoie la description du code de retour du serveur de trades    |
//+------------------------------------------------------------------+
string TradeServerReturnCodeDescription(int return_code)
//+------------------------------------------------------------------+
//| renvoie la description du code d'erreur d'exécution              |
//+------------------------------------------------------------------+
string ErrorDescription(int err_code)

Exemple :

(N'oubliez pas de copier le fichier ErrorDescription.mq5 dans le dossier \MetaTrader 5\MQL5\Include)

//+------------------------------------------------------------------+
//|                                               ErrorDescrTest.mq5 |
//|                        Copyright 2010, MetaQuotes Software Corp. |
//|                                              http://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "2010, MetaQuotes Software Corp."
#property link      "http://www.mql5.com"
#property version   "1.00"
#include <ErrorDescription.mqh>
//+------------------------------------------------------------------+
//| Exemple d'utilisation de la bibliothèque ErrorDescription.mqh    |
//+------------------------------------------------------------------+
void OnStart()
  {
   Print("----- Description des codes de retour du serveur de trades -----");
   for(int i=10004;i<=10034;i++)
     {
      Print("Code de retour du serveur de trades :",i,TradeServerReturnCodeDescription(i));
     }
   Print("-------- Description of runtime error codes ---------");
   for(int i=4001;i<=4014;i++)
     {
      Print("Code d'erreur d'exécution :",i,ErrorDescription(i));
     }
  }
//+------------------------------------------------------------------+

Dans certains cas, il est nécessaire de travailler avec des erreurs définies par l'utilisateur. Dans MQL5, il existe une fonction SetUserError, qui initialise la variable prédéfinie _LastError avec la valeur égale à ERR_USER_ERROR_FIRST + user_error.

Les codes d'erreur définis par l'utilisateur commencent à partir du code ERR_USER_ERROR_FIRST. Dans de tels cas, vous pouvez utiliser la fonction ErrorDescriptionExt pour renvoyer la description des erreurs, y compris les erreurs définies par l'utilisateur :

//+------------------------------------------------------------------+
//|                                               UserErrorDescr.mq5 |
//|                        Copyright 2010, MetaQuotes Software Corp. |
//|                                              http://www.mql5.com |
//+------------------------------------------------------------------+
#property copyright "2010, MetaQuotes Software Corp."
#property link      "http://www.mql5.com"
#property version   "1.00"
#include <ErrorDescription.mqh>
//+------------------------------------------------------------------+
//| renvoie la description du code d'erreur d'exécution,             |
//| avec des erreurs définies par l'utilisateur                      |
//+------------------------------------------------------------------+
string ErrorDescriptionExt(int err_code,string&user_errors[])
  {
   if(err_code>=0 && err_code<ERR_USER_ERROR_FIRST) return(ErrorDescription(err_code));
//--- erreurs d'exécution définies par l'utilisateur
   err_code-=ERR_USER_ERROR_FIRST;
   if(err_code<=ArraySize(user_errors)) return(user_errors[err_code]);
//---
   return("Erreur inconnue");
  };

// tableau avec la description des erreurs d'exécution définies par l'utilisateur
string MyErrors[]=
  {
   "Erreur utilisateur №1",
   "Erreur utilisateur №2",
   "Erreur utilisateur №3"
  };
//+------------------------------------------------------------------+
//| Fonction de démarrage du programme de script                     |
//+------------------------------------------------------------------+
void OnStart()
  {
//---
   for(int i=0;i<=2;i++)
     {
      SetUserError(i);
      Print("Code d'erreur défini par l'utilisateur :",i,ErrorDescriptionExt(GetLastError(),MyErrors));
     }
  }
//+------------------------------------------------------------------+