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.
« 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 :
| Code | Constante | Signification officielle |
|---|---|---|
| 5051 | ERR_SMALL_ASSERIES_ARRAY | The receiving array is declared as AS_SERIES, and it is of insufficient size |
| 5052 | ERR_SMALL_ARRAY | Too small array, the starting position is outside the array |
| 4006 | ERR_INVALID_ARRAY | Array of a wrong type, wrong size, or a damaged object of a dynamic array |
| 4007 | ERR_ARRAY_RESIZE_ERROR | Not 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.
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.
- Erreurs de compilation MQL5
- Invalid pointer access
- GetLastError et gestion des erreurs
- Codes de retour du serveur de trading
- 10004 Requote
- 10006 Requête rejetée
- 10013 Requête invalide
- 10014 Volume invalide
- 10015 Prix invalide
- 10016 Stops invalides
- 10017 Trading désactivé
- 10018 Marché fermé
- 10019 Fonds insuffisants
- 10021 Pas de cotations
- 10024 Trop de requêtes
- 10027 Trading automatique désactivé
- 10030 Mode de remplissage non supporté
- 4756 Échec d’envoi de la requête
- Division par zéro
