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

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.

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

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\Files du répertoire de données du terminal (menu Fichier, Ouvrir le dossier des données).
  • En test : le dossier MQL5\Files de 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 commun Terminal\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 | :

DrapeauRôle
FILE_READouverture en lecture
FILE_WRITEouverture en écriture (le contenu existant est remplacé)
FILE_CSVfichier texte structuré en champs séparés
FILE_TXTfichier texte simple, sans séparateur par défaut
FILE_ANSItexte encodé sur un octet selon la page de code
FILE_SHARE_READautorise la lecture simultanée par d’autres programmes
FILE_COMMONdossier 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 utilisant FILE_COMMON pour 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_READ cô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_COMMON si 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 FileClose dans tous les chemins de sortie, ou FileFlush si 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.

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.