MQL5 · Avancé
Lire et écrire des fichiers CSV en MQL5 : FileOpen, FileWrite et FileReadString
Exporter un journal de transactions vers un tableur, importer une liste de paramètres : le bac à sable de fichiers, les drapeaux de FileOpen, les séparateurs, l’encodage et la lecture champ par champ en MQL5.
Pour écrire un fichier CSV en MQL5, ouvrez-le avec FileOpen en combinant les drapeaux FILE_WRITE et FILE_CSV (plus FILE_ANSI si vous voulez un fichier lisible directement par un tableur), en précisant le séparateur, puis écrivez chaque ligne avec FileWrite, qui insère automatiquement le séparateur entre les valeurs et un retour à la ligne à la fin. Pour le lire, ouvrez-le avec FILE_READ|FILE_CSV et le même séparateur, puis lisez les champs un par un avec FileReadString, en vous aidant de FileIsLineEnding et FileIsEnding pour repérer les fins de ligne et de fichier. Le fichier se trouve obligatoirement dans le bac à sable MQL5\Files du terminal, ou dans le dossier commun avec FILE_COMMON.
Cette page appartient à la rubrique MQL5 avancé. Elle se concentre sur l’échange de données tabulaires avec l’extérieur. Pour la sauvegarde de l’état interne d’un robot entre deux redémarrages, voyez plutôt Sauvegarder l’état dans des fichiers.
Le bac à sable de fichiers
Pour des raisons de sécurité, un programme MQL5 ne peut pas lire ou écrire n’importe où sur le disque. La documentation est claire : les fichiers manipulés par les fonctions MQL5 ne peuvent pas se trouver hors du bac à sable. Trois emplacements sont possibles :
- Par défaut : le sous-dossier
MQL5\Filesdu répertoire de données du terminal (menu Fichier, Ouvrir le dossier des données). - En test : le dossier
MQL5\Filesde l’agent de test. Un fichier écrit pendant un backtest n’apparaît donc pas dans le dossier du terminal, ce qui surprend souvent la première fois. - Avec
FILE_COMMON: le dossier communTerminal\Common\Files, partagé par tous les terminaux installés sur la machine. Pratique pour échanger un fichier entre deux installations ou entre le testeur et le terminal.
Les sous-dossiers sont autorisés dans le nom : FileOpen("exports\\trades.csv", ...) crée le fichier dans MQL5\Files\exports. Notez la double barre oblique inverse, nécessaire dans une chaîne MQL5.
FileOpen : les drapeaux qui comptent
La signature est int FileOpen(string file_name, int open_flags, short delimiter='\t', uint codepage=CP_ACP). Elle renvoie un handle de fichier, ou INVALID_HANDLE en cas d’échec. Les drapeaux se combinent avec | :
| Drapeau | Rôle |
|---|---|
FILE_READ | ouverture en lecture |
FILE_WRITE | ouverture en écriture (le contenu existant est remplacé) |
FILE_CSV | fichier texte structuré en champs séparés |
FILE_TXT | fichier texte simple, sans séparateur par défaut |
FILE_ANSI | texte encodé sur un octet selon la page de code |
FILE_SHARE_READ | autorise la lecture simultanée par d’autres programmes |
FILE_COMMON | dossier commun à tous les terminaux |
Deux valeurs par défaut piègent régulièrement les développeurs. Le séparateur d’un fichier CSV est la tabulation si vous ne le précisez pas. Pour un tableur français, utilisez le point-virgule ';' ; pour un outil anglo-saxon ou Python, la virgule ','. Et sans FILE_ANSI, le fichier texte est lu et écrit en Unicode : un tableur peut alors l’afficher de façon illisible. Avec FILE_ANSI, le paramètre codepage choisit l’encodage ; CP_UTF8 est un choix sûr pour les caractères accentués.
Pour ajouter des lignes à un fichier existant au lieu de l’écraser, ouvrez-le avec FILE_READ|FILE_WRITE, puis placez le pointeur en fin de fichier avec FileSeek(handle, 0, SEEK_END) avant d’écrire.
FileWrite et FileReadString
FileWrite(handle, ...) accepte jusqu’à 256 paramètres de types simples (pas de tableaux ni de structures). En mode CSV, il convertit chaque valeur en texte, insère le séparateur entre les valeurs et termine la ligne. La conversion suit des règles précises : un booléen devient true ou false, une date le format AAAA.MM.JJ HH:MI:SS, et un double est écrit avec 16 chiffres après la virgule, en notation fixe ou scientifique selon la plus courte. Pour un prix ou un montant, cette précision est inutile et brouille la lecture : convertissez vous-même avec DoubleToString(valeur, digits).
En lecture, FileReadString(handle) lit en mode CSV depuis la position courante jusqu’au prochain séparateur ou à la fin de la ligne. FileIsLineEnding(handle) indique si le dernier champ lu terminait la ligne, FileIsEnding(handle) si la fin du fichier est atteinte. Il existe aussi FileReadNumber et FileReadDatetime pour convertir directement un champ. Lire tous les champs en chaînes puis les convertir avec StringToDouble, StringToInteger ou StringToTime reste toutefois l’approche la plus prévisible.
Exemple complet : exporter puis relire un journal de transactions
Le script suivant exporte les transactions des trente derniers jours dans un fichier CSV séparé par des points-virgules, puis relit ce fichier pour calculer le résultat total.
//+------------------------------------------------------------------+
//| DealsToCsv.mq5 : export et relecture d'un journal en CSV |
//+------------------------------------------------------------------+
#property script_show_inputs
input int InpDays=30; // profondeur d'historique (jours)
input string InpFile="exports\\deals.csv"; // chemin relatif à MQL5\Files
void OnStart()
{
if(!ExportDeals()) return;
ReadBack();
}
//--- écriture
bool ExportDeals()
{
datetime to=TimeCurrent(), from=to-InpDays*86400;
if(!HistorySelect(from,to))
{
Print("HistorySelect a échoué : ",GetLastError());
return(false);
}
int h=FileOpen(InpFile,FILE_WRITE|FILE_CSV|FILE_ANSI,';',CP_UTF8);
if(h==INVALID_HANDLE)
{
Print("FileOpen (écriture) a échoué : ",GetLastError());
return(false);
}
FileWrite(h,"ticket","heure","symbole","type","volume","prix","profit","magic");
int total=HistoryDealsTotal(),written=0;
for(int i=0;i<total;i++)
{
ulong t=HistoryDealGetTicket(i);
if(t==0) continue;
//--- on ne garde que les sorties de position (résultat réalisé)
if(HistoryDealGetInteger(t,DEAL_ENTRY)!=DEAL_ENTRY_OUT) continue;
string sym=HistoryDealGetString(t,DEAL_SYMBOL);
int dg =(int)SymbolInfoInteger(sym,SYMBOL_DIGITS);
FileWrite(h,
(string)t,
TimeToString((datetime)HistoryDealGetInteger(t,DEAL_TIME),TIME_DATE|TIME_SECONDS),
sym,
(HistoryDealGetInteger(t,DEAL_TYPE)==DEAL_TYPE_BUY ? "buy" : "sell"),
DoubleToString(HistoryDealGetDouble(t,DEAL_VOLUME),2),
DoubleToString(HistoryDealGetDouble(t,DEAL_PRICE),dg),
DoubleToString(HistoryDealGetDouble(t,DEAL_PROFIT),2),
(string)HistoryDealGetInteger(t,DEAL_MAGIC));
written++;
}
FileClose(h);
PrintFormat("%d transaction(s) exportée(s) dans MQL5\\Files\\%s",written,InpFile);
return(true);
}
//--- lecture : 8 colonnes, la 7e est le profit
void ReadBack()
{
int h=FileOpen(InpFile,FILE_READ|FILE_CSV|FILE_ANSI,';',CP_UTF8);
if(h==INVALID_HANDLE)
{
Print("FileOpen (lecture) a échoué : ",GetLastError());
return;
}
int line=0,col=0;
double sum=0.0;
while(!FileIsEnding(h))
{
string field=FileReadString(h);
if(line>0 && col==6) // ligne 0 = en-tête
sum+=StringToDouble(field);
col++;
if(FileIsLineEnding(h)) { line++; col=0; }
}
FileClose(h);
PrintFormat("%d ligne(s) de données relue(s), profit total %.2f",line-1,sum);
}
Ce script illustre les bonnes pratiques : en-tête explicite, valeurs formatées avec le bon nombre de décimales, séparateur et encodage identiques à l’écriture et à la lecture, et fermeture systématique avec FileClose. Les fonctions d’historique utilisées sont détaillées dans Lire l’historique des ordres et transactions.
Cas d’usage en trading
- Journal de trades pour une analyse dans un tableur : export quotidien ou à chaque clôture de position, depuis
OnTradeTransaction. - Résultats d’optimisation : dans
OnTester, écrire une ligne par passe avec les paramètres et les statistiques, en utilisantFILE_COMMONpour retrouver un fichier unique malgré les agents de test. - Paramètres externes : liste de symboles, calendrier de jours à ne pas trader ou niveaux de prix préparés dans un tableur et lus dans
OnInit. - Données pour Python : un CSV séparé par des virgules se charge directement avec
pandas.read_csv. Pour récupérer des cotations, le module Python MetaTrader5 est toutefois plus direct.
Pièges fréquents
- Séparateur décimal :
DoubleToStringécrit toujours un point. Un tableur réglé en français peut l’interpréter comme du texte ; adaptez l’import plutôt que de remplacer le point par une virgule, qui entrerait en conflit avec un séparateur de champ virgule. - Fichier verrouillé : si le fichier est ouvert dans un tableur, l’ouverture en écriture peut échouer. Ajoutez
FILE_SHARE_READcôté lecture et fermez le fichier dans le tableur avant d’écrire. - Fichier introuvable après un backtest : il est dans le dossier de l’agent, pas dans celui du terminal. Utilisez
FILE_COMMONsi vous devez le récupérer facilement. - Handle non fermé : un fichier resté ouvert n’est pas forcément écrit entièrement sur le disque ; appelez
FileClosedans tous les chemins de sortie, ouFileFlushsi le fichier doit rester ouvert longtemps. - Écriture à chaque tick : les accès disque sont lents comparés au calcul. Accumulez en mémoire et écrivez à intervalles réguliers ou sur événement.
Quand le volume de données grossit ou que vous avez besoin de filtres et d’agrégations, une base SQLite devient plus adaptée qu’une série de fichiers CSV.
Questions fréquentes
Où MQL5 enregistre-t-il mes fichiers CSV ?
Dans le dossier MQL5\Files du répertoire de données du terminal, accessible par Fichier puis Ouvrir le dossier des données. Pendant un backtest, ils sont écrits dans le dossier MQL5\Files de l’agent de test. Avec FILE_COMMON, ils vont dans le dossier commun Terminal\Common\Files.
Pourquoi mon CSV s’affiche-t-il mal dans le tableur ?
Sans FILE_ANSI, MQL5 écrit le texte en Unicode, et le séparateur par défaut est la tabulation. Ajoutez FILE_ANSI avec CP_UTF8, choisissez le point-virgule comme séparateur pour un tableur français et vérifiez les options d’import.
Peut-on lire un fichier situé ailleurs sur le disque ?
Non, pas avec les fonctions de fichiers MQL5 : elles sont limitées au bac à sable. Copiez le fichier dans MQL5\Files ou dans le dossier commun.
Comment ajouter des lignes sans effacer le fichier ?
Ouvrez-le avec FILE_READ|FILE_WRITE|FILE_CSV, déplacez le pointeur en fin de fichier avec FileSeek(handle,0,SEEK_END), puis écrivez avec FileWrite.
- Programmation orientée objet : classes
- Héritage et polymorphisme
- La bibliothèque standard
- Matrices et vecteurs
- Modèles ONNX dans MQL5
- Le module Python MetaTrader5
- Bases de données SQLite
- WebRequest et API externes
- Importer des DLL
- Le calendrier économique en MQL5
- Profiler et optimiser son code
- Versionner son code (MQL5 Algo Forge)
- Publier un produit sur le Market MQL5
