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

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.

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

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.

TypeTailleMinimumMaximum
char1 octet-128127
uchar1 octet0255
short2 octets-32 76832 767
ushort2 octets065 535
int4 octets-2 147 483 6482 147 483 647
uint4 octets04 294 967 295
long8 octets-9 223 372 036 854 775 8089 223 372 036 854 775 807
ulong8 octets018 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.8 vaut 9 ; utilisez MathRound() pour arrondir à l’entier le plus proche ;
  • une valeur hors plage est tronquée : affecter 400 à un char donne -112 ;
  • les conversions entre types signés et non signés de même taille peuvent perdre de l’information ;
  • un long très grand converti en double peut 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 un int, sous peine d’obtenir 0 pour un micro-lot.
  • Distances en points : un int convient pour un stop exprimé en points, mais la conversion en prix doit se faire en double : 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 color et datetime plutôt que des int ou long ; 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.

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.