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.
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
| Fonction | Signature documentée | Retour |
|---|---|---|
| StringLen | int StringLen(string string_value) | Nombre de caractères |
| StringFind | int StringFind(string string_value, string match_substring, int start_pos = 0) | Position trouvée ou -1 |
| StringSubstr | string StringSubstr(string string_value, int start_pos, int length = -1) | Sous-chaîne, vide si impossible |
| StringReplace | int StringReplace(string &str, const string find, const string replacement) | Nombre de remplacements, -1 en cas d’erreur |
| StringSplit | int StringSplit(const string string_value, const ushort separator, string &result[]) | Nombre de sous-chaînes |
| StringToUpper | bool StringToUpper(string &string_var) | true si succès |
| StringTrimLeft | int 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 typeushort, que l’on obtient avecStringGetCharacter(",", 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()etStringTrimRight()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
_Digitsdé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 simplementStringToUpper(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.
- 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
- 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
