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

MQL5 · Bases du langage

Chaînes de caractères en MQL5 : StringFind, StringSplit, StringFormat

Assembler, rechercher, découper, nettoyer et formater du texte en MQL5 : les fonctions String essentielles, leurs signatures exactes et les pièges des fonctions qui modifient la chaîne en place.

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

En MQL5, une chaîne (string) est une suite de caractères Unicode. On la concatène avec +, on mesure sa longueur avec StringLen(), on cherche un motif avec StringFind() (qui renvoie -1 s’il est absent), on extrait une portion avec StringSubstr(), on la découpe avec StringSplit() et on la formate avec StringFormat(). Attention à une particularité : StringToUpper(), StringToLower(), StringTrimLeft(), StringTrimRight() et StringReplace() modifient la chaîne passée en paramètre au lieu de renvoyer une nouvelle chaîne. Dans un Expert Advisor, ces fonctions servent à construire des messages de journal, des commentaires d’ordres, des noms d’objets graphiques et à analyser des paramètres saisis par l’utilisateur.

Cette page fait partie de la rubrique Les bases du langage MQL5.

Déclarer et assembler des chaînes

Une constante chaîne s’écrit entre guillemets doubles. Les caractères spéciaux s’obtiennent par une barre oblique inverse : \n pour un saut de ligne, \t pour une tabulation, \" pour un guillemet, \\ pour la barre elle-même. Deux constantes littérales placées côte à côte sont fusionnées par le compilateur, ce qui permet de couper un long texte sur plusieurs lignes du code.

L’opérateur + assemble deux chaînes. Lorsqu’une chaîne est combinée à un nombre, le nombre est converti en texte, car la documentation indique que le type string a la priorité la plus haute parmi les types simples. Cette conversion automatique est pratique mais peu maîtrisée : un double sera affiché avec de nombreuses décimales. Pour contrôler le format, convertissez explicitement avec DoubleToString(valeur, chiffres), dont la signature documentée est string DoubleToString(double value, int digits = 8), ou utilisez StringFormat().

StringConcatenate() et la méthode Add() constituent d’autres manières de construire une chaîne à partir de plusieurs éléments.

Les fonctions de base

FonctionSignature documentéeRetour
StringLenint StringLen(string string_value)Nombre de caractères
StringFindint StringFind(string string_value, string match_substring, int start_pos = 0)Position trouvée ou -1
StringSubstrstring StringSubstr(string string_value, int start_pos, int length = -1)Sous-chaîne, vide si impossible
StringReplaceint StringReplace(string &str, const string find, const string replacement)Nombre de remplacements, -1 en cas d’erreur
StringSplitint StringSplit(const string string_value, const ushort separator, string &result[])Nombre de sous-chaînes
StringToUpperbool StringToUpper(string &string_var)true si succès
StringTrimLeftint StringTrimLeft(string &string_var)Nombre de caractères retirés

Quelques détails qui comptent :

  • dans StringSubstr(), une longueur de -1 (valeur par défaut) extrait jusqu’à la fin de la chaîne ;
  • StringReplace() remplace toutes les occurrences et renvoie 0 si le motif est absent ;
  • le séparateur de StringSplit() n’est pas une chaîne mais un code de caractère de type ushort, que l’on obtient avec StringGetCharacter(",", 0) ou en écrivant directement le caractère entre apostrophes ',' ;
  • si le séparateur est absent, StringSplit() renvoie 1 et place la chaîne entière dans le tableau ; si la chaîne est vide, elle renvoie 0 ; en cas d’erreur, -1 ;
  • StringTrimLeft() et StringTrimRight() retirent les espaces, tabulations et sauts de ligne en début ou en fin de chaîne.

Formater avec StringFormat et PrintFormat

StringFormat(format, ...) construit une chaîne selon un modèle, avec les mêmes règles que PrintFormat(). La syntaxe d’un spécificateur est %[drapeaux][largeur][.précision]type. Les plus utiles en trading sont %d (entier), %I64d ou %I64u (entier 64 bits, pour un ticket), %.2f (réel à deux décimales), %s (chaîne) et %% (signe pour cent). La précision peut être fournie en argument avec %.*f, ce qui permet d’afficher un prix avec exactement _Digits décimales.

Convertir entre texte et nombres

Pour lire un nombre saisi sous forme de texte, utilisez StringToDouble() ou StringToInteger(). Pour une date, StringToTime() accepte notamment les formats yyyy.mm.dd hh:mi et yyyy-mm-dd hh:mi:ss. Dans l’autre sens, DoubleToString(), IntegerToString() et TimeToString() produisent du texte. Les conversions de dates sont développées dans Dates, heures et fuseaux.

Comparer des chaînes

L’opérateur == compare deux chaînes caractère par caractère, en tenant compte de la casse : "eurusd" == "EURUSD" est faux. Pour une comparaison insensible à la casse, convertissez les deux chaînes en majuscules au préalable, ou utilisez StringCompare(), qui renvoie -1, 0 ou 1. Une chaîne ne peut pas servir d’expression à un switch : il faut des if.

Exemple complet : analyser une liste de symboles saisie en paramètre

Un cas très concret : l’utilisateur saisit une liste de symboles séparés par des virgules, avec des espaces et des minuscules. Le code doit la nettoyer, gérer un éventuel suffixe de courtier et vérifier que chaque symbole existe.

//+------------------------------------------------------------------+
//| Script : nettoyage et analyse d'une liste de symboles            |
//+------------------------------------------------------------------+
#property script_show_inputs

input string InpSymboles = " eurusd, GBPUSD ,usdjpy,,xauusd "; // Symboles separes par des virgules
input string InpSuffixe  = "";                                 // Suffixe du courtier (ex. .r)

void OnStart()
  {
   string morceaux[];
   int n = StringSplit(InpSymboles, ',', morceaux);   // separateur = code du caractere ','
   if(n <= 0)
     {
      Print("Liste vide ou erreur ", GetLastError());
      return;
     }

   string valides = "";
   int    nbValides = 0;
   for(int i = 0; i < n; i++)
     {
      string s = morceaux[i];
      StringTrimLeft(s);              // modifie s en place
      StringTrimRight(s);
      if(StringLen(s) == 0)
         continue;                    // element vide (",,")
      StringToUpper(s);               // modifie s en place
      s = s + InpSuffixe;

      bool existe = false;
      if(!SymbolExist(s, existe))     // existe : true si symbole personnalise
        {
         PrintFormat("Symbole introuvable : %s", s);
         continue;
        }
      valides += (nbValides > 0 ? ";" : "") + s;
      nbValides++;
     }

   PrintFormat("%d symbole(s) valide(s) : %s", nbValides, valides);

   // Construire un commentaire d'ordre compact et un nom d'objet unique
   string commentaire = StringFormat("EA-%s-%I64u", _Symbol, (ulong)240501);
   string nomObjet    = "Signal_" + TimeToString(TimeCurrent(), TIME_DATE|TIME_MINUTES);
   StringReplace(nomObjet, " ", "_");     // remplace toutes les espaces
   StringReplace(nomObjet, ":", "");
   PrintFormat("Commentaire : %s | objet : %s", commentaire, nomObjet);

   // Recherche d'un motif
   int pos = StringFind(_Symbol, "USD");
   if(pos >= 0)
      PrintFormat("USD trouve en position %d dans %s", pos, _Symbol);
   else
      Print("USD absent du symbole courant");
  }

SymbolExist() renvoie true si le symbole est connu du terminal ; son second paramètre, passé par référence, indique s’il s’agit d’un symbole personnalisé. La lecture des propriétés d’un symbole est présentée dans SymbolInfoDouble, SymbolInfoInteger, et l’utilisation d’une telle liste dans un robot dans EA multi-symboles.

Construire des messages utiles

La plupart des chaînes d’un EA finissent dans le journal ou dans une notification. Un bon message est un message que l’on peut exploiter plusieurs semaines plus tard, en filtrant un fichier de log. Quelques règles simples :

  • commencez par un mot-clé stable (OUVERTURE, FERMETURE, ERREUR, FILTRE) qui permet de rechercher toutes les lignes d’un même type ;
  • incluez systématiquement le symbole, le ticket ou le magic number, et les valeurs qui ont motivé la décision (prix, spread, valeur d’indicateur) ;
  • formatez les prix avec _Digits décimales et les montants avec deux décimales, pour que les colonnes restent comparables ;
  • en cas d’échec, ajoutez le code renvoyé par GetLastError() ou le code de retour du serveur.

Pour les noms d’objets graphiques, la chaîne doit être unique sur le graphique. Un préfixe propre à l’EA, suivi d’une heure ou d’un compteur, évite qu’un nouvel objet en écrase un autre et permet de supprimer en une fois tous les objets du robot. L’affichage et la journalisation sont traités dans Print, Comment, Alert : déboguer avec le journal.

Pièges fréquents

  • Résultat ignoré d’une fonction « en place » : écrire s = StringToUpper(s); affecte un booléen converti en texte (« true ») à la variable. Appelez simplement StringToUpper(s);.
  • Séparateur de StringSplit sous forme de chaîne : le paramètre attend un caractère (','), pas une chaîne (",").
  • Indices de StringSubstr : la première position est 0, et le deuxième argument est une longueur, pas une position de fin.
  • Comparaison sensible à la casse : normalisez la casse avant de comparer des noms de symboles saisis à la main.
  • Commentaires d’ordres trop longs : le serveur peut tronquer ou modifier le commentaire d’un ordre. Ne vous en servez pas pour identifier vos positions ; utilisez le magic number.
  • Concaténations dans OnTick : construire de longues chaînes à chaque tick, uniquement pour le journal, ralentit le robot et remplit les fichiers de log. Journalisez les événements, pas chaque tick.

FAQ

Comment découper une chaîne en MQL5 ?

Utilisez StringSplit(chaine, separateur, tableau). Le séparateur est un code de caractère (par exemple ‘,’), le tableau reçoit les morceaux et la fonction renvoie leur nombre. Si le séparateur est absent, elle renvoie 1 avec la chaîne entière.

Pourquoi StringToUpper ne renvoie-t-il pas la chaîne convertie ?

Parce qu’il modifie directement la variable passée par référence et renvoie seulement un booléen de réussite. Il en va de même pour StringToLower, StringTrimLeft, StringTrimRight et StringReplace.

Que renvoie StringFind si le texte n’est pas trouvé ?

La valeur -1. Testez toujours pos >= 0 avant d’utiliser la position, notamment avant de la passer à StringSubstr.

Comment afficher un prix avec le bon nombre de décimales ?

Utilisez DoubleToString(prix, _Digits) ou, dans un format, le spécificateur %.*f avec _Digits comme précision. La conversion automatique d’un double en chaîne affiche souvent trop de décimales.

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.