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

MQL5 · Codes d’erreur

Array out of range en MQL5 : comprendre et éviter le dépassement de tableau

L’erreur critique array out of range arrête l’EA ou l’indicateur. Lire le message, identifier les causes fréquentes en trading et écrire des accès aux tableaux sûrs.

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

« Array out of range » est une erreur critique d’exécution : votre programme a tenté de lire ou d’écrire un élément de tableau à un indice qui n’existe pas, par exemple l’élément [5] d’un tableau de cinq éléments (indices 0 à 4), ou l’élément [0] d’un tableau vide. La documentation MQL5 classe ce cas parmi les erreurs qui terminent immédiatement le programme : l’EA ou l’indicateur est arrêté, et un message de la forme array out of range in 'MonEA.mq5' (42,17) apparaît dans l’onglet Experts, avec le nom du fichier, la ligne et la colonne fautives. Il n’existe pas de code GetLastError() à intercepter ni de bloc try/catch : la seule parade est de vérifier la taille du tableau avant chaque accès risqué.

Cette page explique comment localiser l’accès fautif, présente les situations qui le provoquent le plus souvent en trading et les réflexes de code qui l’éliminent. Elle fait partie de la rubrique Codes d’erreur et de retour MQL5.

Lire le message d’erreur

Le message indique le fichier source et la position, sous la forme (ligne, colonne). Ouvrez le fichier dans MetaEditor et allez à cette ligne : l’expression qui accède au tableau à la colonne indiquée est celle qui a dépassé les bornes. Si le fichier mentionné est un fichier inclus (.mqh), l’accès fautif se trouve dans ce fichier, mais la cause est souvent dans le code appelant qui lui a transmis un tableau trop petit.

Deux remarques pratiques :

  • Le message n’apparaît qu’une fois, puis le programme s’arrête. Un EA arrêté n’envoie plus aucun ordre et ne gère plus ses positions ouvertes : surveillez l’onglet Experts après chaque déploiement.
  • La position indiquée correspond au code compilé : si vous avez modifié le fichier depuis, recompilez et reproduisez l’erreur avant de chercher.

Ne pas confondre avec les erreurs 50xx

La table officielle des erreurs d’exécution contient des codes liés aux tableaux, mais ils concernent les fonctions qui reçoivent un tableau, pas l’accès direct par indice :

CodeConstanteSignification officielle
5051ERR_SMALL_ASSERIES_ARRAYThe receiving array is declared as AS_SERIES, and it is of insufficient size
5052ERR_SMALL_ARRAYToo small array, the starting position is outside the array
4006ERR_INVALID_ARRAYArray of a wrong type, wrong size, or a damaged object of a dynamic array
4007ERR_ARRAY_RESIZE_ERRORNot enough memory for the relocation of an array, or an attempt to change the size of a static array

Ces erreurs se lisent avec GetLastError() après l’appel d’une fonction, et le programme continue. L’« array out of range », lui, ne laisse pas de code : il arrête tout.

Les causes typiques en trading

Une copie de données incomplète

C’est la cause n° 1 dans les EA. CopyBuffer(), CopyRates() ou CopyClose() renvoient le nombre d’éléments réellement copiés, qui peut être inférieur au nombre demandé, voire -1 en cas d’échec : historique pas encore chargé, indicateur en cours de calcul, symbole tout juste ajouté. Si le code accède ensuite à buffer[2] sans vérifier ce nombre, l’erreur survient.

Le décalage d’indice dans une boucle

Une boucle for(int i = 0; i < size; i++) qui lit prix[i + 1] dépasse le tableau au dernier tour. Les comparaisons entre bougies successives (close[i] et close[i+1]) sont la source classique de ce bug.

La confusion d’indexation

Avec ArraySetAsSeries(tableau, true), l’élément [0] est la bougie la plus récente ; sans cette instruction, c’est la plus ancienne. Un code qui suppose une indexation et en reçoit une autre lit les mauvaises valeurs ou dépasse les bornes. Le sujet est détaillé dans ArraySetAsSeries et indexation des séries.

Les indicateurs et leur période de calcul

Dans OnCalculate(), une moyenne sur 20 périodes lit 19 valeurs en arrière. Si la boucle démarre à l’indice 0 sans tenir compte de cette profondeur, elle lit des indices négatifs. Démarrez la boucle à period - 1 au minimum, et utilisez prev_calculated pour ne recalculer que les nouvelles barres. Voyez OnCalculate et prev_calculated.

Le tableau dynamique jamais dimensionné

Un tableau déclaré double valeurs[]; a une taille nulle tant qu’on ne l’a pas redimensionné avec ArrayResize() ou rempli par une fonction de copie. Y écrire directement provoque l’erreur.

Les tableaux de taille fixe et les paramètres d’entrée

Un tableau statique déclaré double niveaux[5]; ne grandit jamais. Si un paramètre d’entrée permet à l’utilisateur de demander 8 niveaux et que la boucle va jusqu’à ce paramètre, l’erreur survient dès que la valeur dépasse 5. Lorsqu’un tableau dépend d’un paramètre, préférez un tableau dynamique dimensionné dans OnInit() avec ArrayResize(), et vérifiez le résultat de cette fonction : elle renvoie la nouvelle taille, ou -1 en cas d’échec. Ce cas est d’autant plus sournois qu’il n’apparaît qu’avec certains réglages, souvent pendant une optimisation où le testeur explore des valeurs que vous n’aviez pas essayées à la main.

Le code défensif

input int InpMAPeriod = 20;
int       g_maHandle  = INVALID_HANDLE;

int OnInit()
  {
   g_maHandle = iMA(_Symbol, PERIOD_CURRENT, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE);
   return (g_maHandle == INVALID_HANDLE) ? INIT_FAILED : INIT_SUCCEEDED;
  }

void OnTick()
  {
   const int needed = 3;              // on lit les indices 0, 1 et 2
   double ma[];
   ArraySetAsSeries(ma, true);        // [0] = bougie courante

   // 1. Toujours tester le nombre d'éléments réellement copiés
   int copied = CopyBuffer(g_maHandle, 0, 0, needed, ma);
   if(copied < needed)
      return;                         // données incomplètes : on attend le tick suivant

   // 2. Les accès restent dans les bornes connues
   bool crossUp = (ma[1] > ma[2]);

   // 3. Boucle sur des paires d'éléments : s'arrêter à size - 1
   int size = ArraySize(ma);
   for(int i = 0; i < size - 1; i++)
     {
      double slope = ma[i] - ma[i + 1];   // i + 1 <= size - 1 : accès valide
      // ...
     }
  }

Trois réflexes résument l’approche : comparer le nombre d’éléments copiés au nombre requis, borner les boucles qui lisent i + 1 à size - 1, et ne jamais supposer qu’un tableau dynamique a une taille non nulle. Pour un accès isolé dont vous n’êtes pas sûr, une petite fonction utilitaire qui vérifie index >= 0 && index < ArraySize(tableau) avant de renvoyer la valeur rend le code plus robuste, au prix d’une légère lourdeur.

Diagnostiquer quand le message ne suffit pas

Lorsque la ligne indiquée contient plusieurs accès, ou que l’erreur survient de façon aléatoire, ajoutez temporairement avant la ligne fautive un PrintFormat() qui affiche la taille du tableau et l’indice utilisé. Dans le Strategy Tester, le débogage sur données historiques permet aussi de placer un point d’arrêt et d’inspecter les variables au moment de l’accès ; c’est souvent plus rapide que de multiplier les messages. Le débogueur de MetaEditor est présenté dans Bien utiliser MetaEditor.

Les erreurs aléatoires viennent presque toujours de données de longueur variable : un historique qui n’est pas encore chargé au démarrage, un week-end qui réduit le nombre de bougies d’une période, un symbole avec peu d’historique. Testez votre code sur un démarrage à froid, juste après l’ouverture du terminal, et sur un symbole peu fourni.

Un EA arrêté par une erreur critique laisse ses positions ouvertes sans gestion : trailing stop figé, sorties conditionnelles inactives. Le trading à effet de levier comporte un risque élevé de perte : posez des stops côté serveur et surveillez l’état de l’EA en production.

Questions fréquentes

Peut-on intercepter une erreur array out of range ?

Non. La documentation indique que ce type d’erreur termine immédiatement le programme, et MQL5 ne possède pas de mécanisme try/catch. Il faut prévenir l’accès en vérifiant la taille du tableau avec ArraySize() ou le nombre d’éléments copiés.

Pourquoi l’erreur apparaît-elle seulement au démarrage du terminal ?

Parce que l’historique n’est pas encore entièrement disponible : les fonctions de copie renvoient moins d’éléments que demandé. Testez systématiquement leur valeur de retour et attendez le tick suivant si elle est insuffisante.

Quelle différence avec l’erreur 5052 ?

5052 (ERR_SMALL_ARRAY) est une erreur renvoyée par une fonction à qui l’on passe un tableau trop petit ou une position de départ hors du tableau ; le programme continue. L’array out of range est un accès direct par indice hors bornes, qui arrête le programme.

Le message indique un fichier .mqh, l’erreur vient-elle de la bibliothèque ?

L’accès fautif est dans ce fichier, mais la cause est souvent dans votre code, qui lui a transmis un tableau trop petit ou un indice incorrect. Remontez à l’appel de la fonction concernée.

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.