MQL5 · Bases du langage
Types de données en MQL5 : int, double, bool, string, datetime
Entiers, réels, booléens, chaînes et dates : quels types MQL5 utiliser dans un Expert Advisor, quelles sont leurs limites exactes et quelles conversions provoquent des bugs silencieux.
En MQL5, chaque variable possède un type qui fixe sa taille en mémoire, les valeurs qu’elle peut contenir et les opérations autorisées. Pour un Expert Advisor, cinq types couvrent l’essentiel du travail : int et long pour les compteurs et les tickets, double pour les prix et les volumes, bool pour les conditions, string pour les textes et datetime pour les dates. Choisir le bon type n’est pas un détail de style : une division entière mal placée ou une comparaison directe entre deux double suffit à fausser un calcul de lot ou un signal d’entrée.
Cette page fait partie de la rubrique Les bases du langage MQL5. Elle présente les types simples, leurs limites exactes selon la documentation officielle et les conversions qui posent problème en pratique.
Les types entiers
MQL5 propose huit types entiers, signés ou non signés, de 1 à 8 octets. Le tableau ci-dessous reprend les tailles et bornes publiées dans la documentation officielle.
| Type | Taille | Minimum | Maximum |
|---|---|---|---|
| char | 1 octet | -128 | 127 |
| uchar | 1 octet | 0 | 255 |
| short | 2 octets | -32 768 | 32 767 |
| ushort | 2 octets | 0 | 65 535 |
| int | 4 octets | -2 147 483 648 | 2 147 483 647 |
| uint | 4 octets | 0 | 4 294 967 295 |
| long | 8 octets | -9 223 372 036 854 775 808 | 9 223 372 036 854 775 807 |
| ulong | 8 octets | 0 | 18 446 744 073 709 551 615 |
Dans un robot de trading, int sert pour les compteurs de boucle, les périodes d’indicateurs ou les nombres de points. long et ulong interviennent dès qu’il s’agit d’identifiants fournis par le terminal : le numéro de compte renvoyé par AccountInfoInteger(ACCOUNT_LOGIN) est un long, et les tickets d’ordres et de positions sont des ulong. Stocker un ticket dans un int est une erreur classique : la valeur peut dépasser la capacité et être tronquée sans message d’erreur explicite.
Les types char, uchar, short et ushort sont surtout utiles pour manipuler des octets (fichiers binaires, échanges avec une DLL) ou des codes de caractères. Pour le reste, int et long suffisent.
bool, color et datetime
Trois autres types sont des entiers déguisés. bool occupe 1 octet et vaut true ou false. color occupe 4 octets et peut s’écrire sous forme littérale C'128,128,128', sous forme hexadécimale 0x00BBGGRR ou avec une constante nommée comme clrRed. datetime occupe 8 octets et stocke un nombre de secondes écoulées depuis le 1er janvier 1970 ; sa plage valide va du 1er janvier 1970 au 31 décembre 3000. Un littéral de date s’écrit D'2024.03.15 09:30'. Le traitement des dates fait l’objet d’une page dédiée : dates, heures et fuseaux en MQL5.
Les types réels : double et float
Les nombres à virgule flottante existent en deux tailles. float occupe 4 octets avec une mantisse de 23 bits ; double occupe 8 octets avec une mantisse de 52 bits. La documentation précise que double offre une précision deux fois supérieure à celle de float. Dans un EA, utilisez double pour tout ce qui touche aux prix, aux volumes, aux soldes et aux indicateurs : toutes les fonctions de marché (SymbolInfoDouble, AccountInfoDouble, CopyClose…) travaillent en double. float ne se justifie que pour de très grands tableaux où l’économie de mémoire compte.
Le point essentiel est qu’un double est une approximation binaire. Une valeur comme 0,3 n’a pas de représentation exacte en base 2. La documentation officielle déconseille donc fortement de comparer deux réels avec ==. Deux approches sont proposées : vérifier que l’écart absolu est inférieur à une tolérance (qui ne peut pas être inférieure à DBL_EPSILON, soit environ 2,2e-16), ou arrondir la différence avec NormalizeDouble(a - b, 8) == 0. En trading, la tolérance naturelle est souvent une fraction du point du symbole. La page NormalizeDouble et précision des prix détaille ce sujet.
Le type string
Une string est une suite de caractères Unicode. Elle se déclare entre guillemets doubles et accepte les séquences d’échappement \n (saut de ligne), \t (tabulation), \" (guillemet) et \\ (barre oblique inverse). Les chaînes servent aux noms de symboles, aux commentaires d’ordres, aux messages de journal et aux noms d’objets graphiques. Lorsqu’une opération mélange une chaîne et un autre type, la documentation indique que la chaîne a la priorité la plus haute parmi les types simples : l’autre opérande est converti en texte. Les fonctions de manipulation sont présentées dans la page consacrée aux chaînes de caractères de cette rubrique.
Conversions implicites et explicites
Lorsqu’une expression combine deux types différents, MQL5 convertit l’opérande de type inférieur vers le type supérieur. Les types char, uchar, short et ushort sont toujours promus en int. Avant une affectation, le résultat est converti dans le type de la variable cible.
Le piège le plus fréquent est la division entière. La documentation l’illustre ainsi : double x = 1/2; donne 0, car l’expression 1/2 est évaluée entre deux entiers avant d’être stockée dans le double. Il faut écrire 1.0/2 ou convertir explicitement un opérande. Dans un EA, ce piège apparaît quand on calcule un pourcentage de risque à partir d’un paramètre entier : RisquePct/100 vaut 0 si RisquePct est un int inférieur à 100.
Autres pertes de données documentées :
- la conversion d’un réel en entier supprime la partie décimale :
(int)9.8vaut 9 ; utilisezMathRound()pour arrondir à l’entier le plus proche ; - une valeur hors plage est tronquée : affecter 400 à un
chardonne -112 ; - les conversions entre types signés et non signés de même taille peuvent perdre de l’information ;
- un
longtrès grand converti endoublepeut perdre en précision.
La conversion explicite s’écrit (type)valeur ou type(valeur). Elle fonctionne aussi depuis une chaîne : double("1.2345e2") ou datetime("2009.06.01") sont des exemples tirés de la documentation. Pour plus de lisibilité, préférez les fonctions dédiées comme StringToDouble() ou StringToTime().
Exemple complet : un script qui illustre les types
Ce script affiche dans le journal les valeurs typiques d’un EA et met en évidence la division entière et la comparaison de réels.
//+------------------------------------------------------------------+
//| Script : demonstration des types de donnees MQL5 |
//+------------------------------------------------------------------+
#property script_show_inputs
input int RisquePct = 2; // Risque par trade en %
void OnStart()
{
// Entiers : compte (long) et compteur (int)
long compte = AccountInfoInteger(ACCOUNT_LOGIN);
int nbBarres = Bars(_Symbol, _Period);
// Reels : prix et solde
double bid = SymbolInfoDouble(_Symbol, SYMBOL_BID);
double solde = AccountInfoDouble(ACCOUNT_BALANCE);
// Booleen, chaine et date
bool estDemo = (AccountInfoInteger(ACCOUNT_TRADE_MODE) == ACCOUNT_TRADE_MODE_DEMO);
string symbole = _Symbol;
datetime maint = TimeCurrent();
PrintFormat("Compte %I64d (%s) | %s | %d barres", compte,
estDemo ? "demo" : "reel", symbole, nbBarres);
PrintFormat("Bid = %.5f | Solde = %.2f | Heure serveur = %s",
bid, solde, TimeToString(maint, TIME_DATE|TIME_SECONDS));
// Piege 1 : division entiere
double faux = RisquePct / 100; // 0.0 si RisquePct < 100
double juste = RisquePct / 100.0; // 0.02 pour 2 %
PrintFormat("Division entiere : %.4f | division reelle : %.4f", faux, juste);
// Piege 2 : comparaison de reels
double a = 0.1 + 0.2;
double b = 0.3;
Print("a == b ? ", (a == b)); // peut afficher false
Print("Ecart < point ? ", (MathAbs(a - b) < _Point / 2.0)); // comparaison avec tolerance
}
Cas d’usage en trading et pièges
Le choix des types a des conséquences directes sur le comportement d’un robot. Voici les situations que l’on rencontre le plus souvent lors de la relecture de code.
- Tickets et identifiants : déclarez-les en
ulong. La classe CTrade et les fonctions de positions renvoient des tickets de ce type. - Volumes : un lot est un
double(0.01, 0.1, 1.0). Ne le stockez jamais dans unint, sous peine d’obtenir 0 pour un micro-lot. - Distances en points : un
intconvient pour un stop exprimé en points, mais la conversion en prix doit se faire endouble:distance * _Point. - Pourcentages : écrivez toujours les constantes avec un point décimal (
100.0) pour forcer une division réelle. - Comparaisons de prix : comparez avec une tolérance ou après normalisation, jamais avec
==brut. - Couleurs et dates : utilisez les types
coloretdatetimeplutôt que desintoulong; le code est plus lisible et les fonctions d’affichage formatent correctement les valeurs.
Un autre réflexe utile consiste à activer et lire les avertissements du compilateur. MetaEditor signale de nombreuses conversions susceptibles de perdre des données ; les traiter une par une évite des bugs silencieux. Les messages les plus courants sont expliqués dans Erreurs de compilation fréquentes.
Enfin, sachez que les types définis par l’utilisateur (énumérations, structures, classes) reposent sur ces types simples. Une énumération, par exemple, occupe toujours 4 octets et se comporte comme un entier. Maîtriser les types simples est donc le prérequis à toute la suite : variables, constantes et portée, tableaux, structures et programmation orientée objet.
FAQ
Quel type utiliser pour un prix en MQL5 ?
Utilisez double. Toutes les fonctions de marché renvoient les prix en double, et ce type offre une précision suffisante pour tous les symboles. Pensez à normaliser les prix envoyés au serveur au nombre de décimales du symbole.
Pourquoi ma division renvoie-t-elle 0 ?
Parce que les deux opérandes sont des entiers : la division est entière et la partie décimale est perdue avant l’affectation. Écrivez au moins un opérande sous forme réelle, par exemple x / 100.0, ou convertissez-le avec (double)x.
Peut-on comparer deux double avec == ?
La documentation officielle le déconseille fortement, car la plupart des valeurs décimales ne sont pas représentables exactement en binaire. Comparez l’écart absolu avec une tolérance, ou utilisez NormalizeDouble(a - b, n) == 0.
Quelle est la différence entre int et long ?
int occupe 4 octets et va jusqu’à environ 2,1 milliards ; long occupe 8 octets et couvre une plage beaucoup plus large. Utilisez long ou ulong pour les identifiants renvoyés par le terminal, comme le numéro de compte ou les tickets.
- 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
- Structures (struct) et MqlRates, MqlTick
- É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
