MQL5 · Bases du langage
Structures en MQL5 : struct, MqlRates et MqlTick
Regrouper des données avec struct, lire des bougies complètes avec MqlRates et CopyRates, obtenir le dernier tick avec MqlTick et SymbolInfoTick : membres, règles de copie et exemple commenté.
Une structure (struct) regroupe sous un même nom plusieurs variables de types différents, appelées membres. MQL5 en fournit plusieurs toutes faites, dont deux essentielles pour lire le marché : MqlRates, qui décrit une bougie complète (heure, ouverture, plus haut, plus bas, clôture, volumes, spread), et MqlTick, qui décrit le dernier tick (bid, ask, last, volume, heure en millisecondes). On remplit un tableau de MqlRates avec CopyRates() et un MqlTick avec SymbolInfoTick(). Vous pouvez aussi déclarer vos propres structures pour transporter proprement des données liées : un signal, un niveau de prix, des statistiques de trading.
Cette page fait partie de la rubrique Les bases du langage MQL5.
Déclarer une structure
La syntaxe est la suivante :
struct NiveauPrix
{
datetime heure; // heure de detection
double prix; // niveau
int touches; // nombre de contacts
bool actif; // niveau encore valide ?
};
Le point-virgule après l’accolade fermante est obligatoire. La documentation précise que le nom d’une structure ne peut pas servir d’identifiant (nom de variable ou de fonction) et qu’une structure ne peut être déclarée qu’une fois dans un projet. On déclare ensuite des variables de ce type comme pour un type simple : NiveauPrix support;, puis on accède aux membres avec le point : support.prix = 1.0850;.
Initialiser et remettre à zéro
Une structure peut être initialisée entre accolades. La documentation indique que les membres non précisés valent alors zéro, et donne l’exemple MqlTradeRequest request = {};, qui remet tous les champs à zéro. Pour réinitialiser une structure existante, ZeroMemory(variable) remet tous ses membres à zéro ; pour un membre de type chaîne, l’effet équivaut à lui affecter NULL.
Structures simples et copie
La documentation appelle structures simples celles qui ne contiennent ni chaînes, ni objets de classe, ni pointeurs, ni tableaux dynamiques. Les structures simples peuvent être copiées par affectation entre variables du même type, ou de types liés par héritage. Une structure qui contient une chaîne ou un tableau dynamique reçoit un constructeur implicite généré par le compilateur pour initialiser correctement ces membres.
Par défaut, les membres sont placés en mémoire sans remplissage, dans l’ordre de déclaration. L’attribut pack(n) modifie cet alignement ; la documentation précise qu’il ne sert qu’aux échanges avec des DLL.
Passer une structure à une fonction
Les structures sont toujours passées par référence. Une fonction qui reçoit const MqlRates &barre peut la lire sans copie et sans risque de la modifier. Une fonction peut aussi renvoyer une structure avec return.
MqlRates : une bougie complète
La structure MqlRates comporte huit membres, documentés comme suit :
| Membre | Type | Contenu |
|---|---|---|
| time | datetime | Heure d’ouverture de la période |
| open | double | Prix d’ouverture |
| high | double | Plus haut de la période |
| low | double | Plus bas de la période |
| close | double | Prix de clôture |
| tick_volume | long | Volume en ticks |
| spread | int | Spread |
| real_volume | long | Volume réel échangé |
CopyRates() remplit un tableau de MqlRates. Elle existe en trois variantes : par position de départ et nombre de barres, par date de départ et nombre de barres, ou entre deux dates. Elle renvoie le nombre d’éléments copiés, ou -1 en cas d’erreur. La documentation précise que, quel que soit le réglage du tableau, l’élément le plus ancien est stocké au début de la mémoire : appelez ArraySetAsSeries() si vous voulez que l’index 0 soit la barre en cours. Ce point est détaillé dans ArraySetAsSeries et indexation des séries.
L’intérêt de CopyRates() est d’obtenir en un appel toutes les informations d’une bougie, là où il faudrait sinon appeler CopyOpen(), CopyHigh(), CopyLow(), CopyClose() et CopyTime() séparément.
MqlTick : le dernier tick
MqlTick décrit une cotation :
| Membre | Type | Contenu |
|---|---|---|
| time | datetime | Heure de la dernière mise à jour des prix |
| bid | double | Prix bid courant |
| ask | double | Prix ask courant |
| last | double | Prix de la dernière transaction |
| volume | ulong | Volume au dernier prix |
| time_msc | long | Heure de la dernière mise à jour, en millisecondes |
| flags | uint | Drapeaux du tick |
| volume_real | double | Volume au dernier prix, avec une précision accrue |
Le membre flags indique ce qui a changé : TICK_FLAG_BID, TICK_FLAG_ASK, TICK_FLAG_LAST, TICK_FLAG_VOLUME, TICK_FLAG_BUY et TICK_FLAG_SELL. Il se teste avec l’opérateur &.
SymbolInfoTick(symbole, tick) remplit la structure et renvoie true en cas de succès. La documentation de SymbolInfoDouble() recommande d’ailleurs d’utiliser SymbolInfoTick() lorsqu’on veut les informations du dernier tick : on obtient bid, ask et heure de façon cohérente, en un seul appel.
Les autres structures prédéfinies
MQL5 utilise des structures dans de nombreux domaines. Vous rencontrerez notamment MqlDateTime pour décomposer une date (voir Dates, heures et fuseaux), ainsi que MqlTradeRequest et MqlTradeResult pour envoyer un ordre et lire la réponse du serveur, présentées dans OrderSend et MqlTradeRequest.
Exemple complet : bougies, tick et structure personnalisée
//+------------------------------------------------------------------+
//| Script : MqlRates, MqlTick et structure personnalisee |
//+------------------------------------------------------------------+
struct StatsBougies
{
int haussieres; // nombre de bougies haussieres
int baissieres; // nombre de bougies baissieres
double amplitudeMoy; // amplitude moyenne high - low (en prix)
long volumeTotal; // somme des volumes en ticks
};
//--- Analyse un tableau de bougies (passe par reference, en lecture seule)
StatsBougies Analyser(const MqlRates &barres[], int n)
{
StatsBougies st = {}; // tous les membres a zero
double somme = 0.0;
for(int i = 0; i < n; i++)
{
if(barres[i].close > barres[i].open) st.haussieres++;
else if(barres[i].close < barres[i].open) st.baissieres++;
somme += barres[i].high - barres[i].low;
st.volumeTotal += barres[i].tick_volume;
}
if(n > 0)
st.amplitudeMoy = somme / n;
return(st);
}
void OnStart()
{
//--- 1. Les 50 dernieres bougies cloturees (on commence a l'index 1)
MqlRates barres[];
ArraySetAsSeries(barres, true); // barres[0] = derniere bougie cloturee
int n = CopyRates(_Symbol, _Period, 1, 50, barres);
if(n <= 0)
{
Print("CopyRates a echoue, erreur ", GetLastError());
return;
}
PrintFormat("Derniere bougie cloturee : %s O=%.*f C=%.*f spread=%d",
TimeToString(barres[0].time), _Digits, barres[0].open,
_Digits, barres[0].close, barres[0].spread);
StatsBougies st = Analyser(barres, n);
PrintFormat("%d haussieres, %d baissieres, amplitude moyenne %.1f points",
st.haussieres, st.baissieres, st.amplitudeMoy / _Point);
//--- 2. Le dernier tick
MqlTick tick;
if(!SymbolInfoTick(_Symbol, tick))
{
Print("SymbolInfoTick a echoue, erreur ", GetLastError());
return;
}
bool bidChange = ((tick.flags & TICK_FLAG_BID) != 0);
PrintFormat("Bid %.*f Ask %.*f | heure ms %I64d | bid modifie : %s",
_Digits, tick.bid, _Digits, tick.ask, tick.time_msc,
bidChange ? "oui" : "non");
}
La fonction Analyser() reçoit le tableau de bougies en const et renvoie une structure personnalisée : le code appelant récupère quatre résultats en un seul appel, sans variables globales.
Quand créer sa propre structure
Une structure personnalisée devient utile dès que plusieurs valeurs voyagent toujours ensemble. Quelques cas typiques dans un Expert Advisor :
- un signal : sens, prix d’entrée théorique, stop, objectif et heure de la bougie qui l’a produit. La fonction de signal renvoie une seule structure au lieu de remplir cinq variables globales ;
- un niveau de prix : support ou résistance détecté, avec son heure, son nombre de contacts et son statut ;
- des statistiques de session : nombre de trades, profit cumulé, plus forte perte, calculés une fois par jour et journalisés ;
- un symbole suivi dans un EA multi-symboles : nom, handle d’indicateur, heure de la dernière bougie traitée, rangés dans un tableau de structures.
Le gain est double. Les signatures de fonctions restent courtes et explicites, et l’ajout d’un champ (par exemple un commentaire ou un identifiant de stratégie) ne casse aucun appel existant. Lorsque la structure doit en plus porter des comportements (méthodes, données privées, héritage), la classe devient l’outil adapté : c’est l’objet de Programmation orientée objet : classes. Retenez aussi qu’un tableau de structures se manipule avec les mêmes fonctions qu’un tableau de nombres : ArrayResize(), ArraySize() ou ArrayFree().
Pièges fréquents
- Oublier le point-virgule après l’accolade fermante de la déclaration : erreur de compilation.
- Structure locale non initialisée : ses membres sont indéterminés. Utilisez
= {}ouZeroMemory(). - Lire
barres[0]sans vérifierCopyRates(): si la copie échoue, le tableau est vide et l’accès provoque une erreur critique. - Prendre la bougie en cours pour une bougie close : avec un départ à 0, l’index 0 en mode série est la bougie en formation, dont
closechange à chaque tick. - Copier deux structures de types différents : refusé par le compilateur, même avec une conversion explicite, sauf lien d’héritage.
- Confondre
volumeetvolume_real: le second offre une précision accrue ; les deux concernent le dernier prix de transaction, renseigné surtout sur les marchés boursiers.
FAQ
Quelle différence entre MqlRates et MqlTick ?
MqlRates décrit une bougie entière (ouverture, plus haut, plus bas, clôture, volumes, spread) ; MqlTick décrit une cotation instantanée (bid, ask, last, volume, heure en millisecondes). On utilise le premier pour l’analyse des bougies, le second pour les prix d’exécution.
Comment remettre une structure à zéro ?
À la déclaration, initialisez-la avec = {} ; ensuite, appelez ZeroMemory(variable). Tous les membres numériques passent à zéro et les chaînes sont vidées.
Une structure est-elle copiée quand je la passe à une fonction ?
Non. Les structures sont toujours passées par référence. Ajoutez const devant le paramètre si la fonction ne doit pas la modifier.
Peut-on mettre une chaîne ou un tableau dynamique dans une structure ?
Oui, mais la structure n’est alors plus une structure simple : elle ne peut pas être transmise à une DLL et le compilateur lui ajoute un constructeur implicite pour initialiser ces membres.
- 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
- Énumérations (enum) personnalisées
- #include, #define et #property
- Les fonctions événementielles
- Print, Comment, Alert : déboguer avec le journal
- NormalizeDouble et précision des prix
- SymbolInfoDouble, SymbolInfoInteger
- AccountInfoDouble : lire les informations du compte
- Bien utiliser MetaEditor
