【MQL5】FileWriteStruct関数について

uint  FileWriteStruct(
  int          file_handle,       // ファイルハンドル
  const void&  struct_object,    // 構造体インスタンスへのリンク
  int          size=-1           // 書かれるバイト数
  );

//--- スクリプトの起動時に入力パラメータのウィンドウを表示する
#property script_show_inputs

//--- 端末からデータを受け取るパラメータを定義
input string         InpSymbolName="EURUSD";           // 分析対象の通貨ペアを指定
input ENUM_TIMEFRAMES InpSymbolPeriod=PERIOD_H1;       // 分析対象の時間軸を指定
input datetime       InpDateStart=D'2013.01.01 00:00'; // コピーするデータの開始日を指定

//--- データをファイルに書き込むためのパラメータを定義
input string         InpFileName="EURUSD.txt";         // 書き込み対象のファイル名
input string         InpDirectoryName="Data";          // 保存先のディレクトリ名

//--- ローソク足データを格納するための構造体を定義
struct candlesticks
 {
  double            open;  // ローソク足の始値
  double            close; // ローソク足の終値
  double            high;  // ローソク足の高値
  double            low;   // ローソク足の安値
  datetime          date;  // ローソク足の日付
 };

//--- スクリプトプログラムのエントリーポイントとなる関数
void OnStart()
 {
  //--- 現在のサーバー時刻を取得
  datetime     date_finish=TimeCurrent();
  
  //--- バッファー（データを一時保存する配列）のサイズを格納する変数を宣言
  int          size;
  
  //--- 各種データ（時間、価格）を格納するバッファーを配列として宣言
  datetime     time_buff[];   // ローソク足の時間を格納する配列
  double       open_buff[];   // ローソク足の始値を格納する配列
  double       close_buff[];  // ローソク足の終値を格納する配列
  double       high_buff[];   // ローソク足の高値を格納する配列
  double       low_buff[];    // ローソク足の安値を格納する配列
  
  //--- 構造体の配列を宣言し、後でローソク足データを格納する
  candlesticks cand_buff[];
  
  //--- エラーコードをリセット
  ResetLastError();
  
  //--- 指定範囲内のローソク足の時間をコピー
  if(CopyTime(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,time_buff)==-1)
    {
    //--- 時間データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("時間データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }
  
  //--- 指定範囲内のローソク足の高値をコピー
  if(CopyHigh(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,high_buff)==-1)
    {
    //--- 高値データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("高値データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }
  
  //--- 指定範囲内のローソク足の安値をコピー
  if(CopyLow(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,low_buff)==-1)
    {
    //--- 安値データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("安値データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }
  
  //--- 指定範囲内のローソク足の始値をコピー
  if(CopyOpen(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,open_buff)==-1)
    {
    //--- 始値データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("始値データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }
  
  //--- 指定範囲内のローソク足の終値をコピー
  if(CopyClose(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,close_buff)==-1)
    {
    //--- 終値データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("終値データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }

  //--- 時間データの配列のサイズを取得
  size=ArraySize(time_buff);
  
  //--- 構造体の配列のサイズを変更し、ローソク足データを保存できるようにする
  ArrayResize(cand_buff,size);
  
  //--- 各ローソク足データを構造体配列に格納
  for(int i=0;i<size;i++)
    {
     cand_buff[i].open=open_buff[i];     // 始値を構造体に格納
     cand_buff[i].close=close_buff[i];   // 終値を構造体に格納
     cand_buff[i].high=high_buff[i];     // 高値を構造体に格納
     cand_buff[i].low=low_buff[i];       // 安値を構造体に格納
     cand_buff[i].date=time_buff[i];     // 時間データを構造体に格納
    }
 
  //--- ファイルを開き、構造体配列を書き込む準備をする（ファイルが存在しない場合は自動で作成）
  ResetLastError();
  int file_handle=FileOpen(InpDirectoryName+"//"+InpFileName,FILE_READ|FILE_WRITE|FILE_BIN|FILE_COMMON);
  
  //--- ファイルが正常に開けた場合の処理
  if(file_handle!=INVALID_HANDLE)
    {
    //--- ファイルが正常に開かれたことをエキスパートログに出力
    PrintFormat("%s ファイルが書き込み用に開かれました",InpFileName);
    PrintFormat("ファイルパス: %s\\Files\\",TerminalInfoString(TERMINAL_COMMONDATA_PATH));
    
    //--- 書き込まれたバイト数をカウントするための変数を準備
    uint counter=0;
    
    //--- 構造体配列をループし、各データをファイルに書き込む
    for(int i=0;i<size;i++)
        counter+=FileWriteStruct(file_handle,cand_buff[i]);  // 各ローソク足のデータをバイナリファイルに書き込む
    
    //--- 書き込まれたバイト数とファイル名をエキスパートログに出力
    PrintFormat("%d バイトの情報が %s ファイルに書き込まれました",counter,InpFileName);
    
    //--- 総バイト数が正しいかを検証し、結果をエキスパートログに出力
    PrintFormat("合計バイト数: %d * %d * %d = %d, %s",size,5,8,size*5*8,size*5*8==counter ? "正しい" : "エラー");
    
    //--- ファイルを閉じる
    FileClose(file_handle);
    PrintFormat("データが書き込まれ、%s ファイルは閉じられました",InpFileName);
    }
  else
    {
    //--- ファイルが開けなかった場合のエラーメッセージを出力
    PrintFormat("%s ファイルを開けませんでした。エラーコード = %d",InpFileName,GetLastError());
    }
 }

//--- スクリプトの起動時に入力パラメータのウィンドウを表示する
#property script_show_inputs

//--- 端末からデータを受け取るパラメータを定義
input string         InpSymbolName="EURUSD";           // 分析対象の通貨ペアを指定
input ENUM_TIMEFRAMES InpSymbolPeriod=PERIOD_H1;       // 分析対象の時間軸を指定
input datetime       InpDateStart=D'2013.01.01 00:00'; // コピーするデータの開始日を指定

//--- データをファイルに書き込むためのパラメータを定義
input string         InpFileName="EURUSD.txt";         // 書き込み対象のファイル名
input string         InpDirectoryName="Data";          // 保存先のディレクトリ名

//--- ローソク足データを格納するための構造体を定義
struct candlesticks
 {
  double            open;  // ローソク足の始値
  double            close; // ローソク足の終値
  double            high;  // ローソク足の高値
  double            low;   // ローソク足の安値
  datetime          date;  // ローソク足の日付
 };

//--- スクリプトプログラムのエントリーポイントとなる関数
void OnStart()
 {
  //--- 現在のサーバー時刻を取得
  datetime     date_finish=TimeCurrent();
  
  //--- バッファー（データを一時保存する配列）のサイズを格納する変数を宣言
  int          size;
  
  //--- 各種データ（時間、価格）を格納するバッファーを配列として宣言
  datetime     time_buff[];   // ローソク足の時間を格納する配列
  double       open_buff[];   // ローソク足の始値を格納する配列
  double       close_buff[];  // ローソク足の終値を格納する配列
  double       high_buff[];   // ローソク足の高値を格納する配列
  double       low_buff[];    // ローソク足の安値を格納する配列
  
  //--- 構造体の配列を宣言し、後でローソク足データを格納する
  candlesticks cand_buff[];
  
  //--- エラーコードをリセット
  ResetLastError();

 //--- 指定範囲内のローソク足の時間をコピー
  if(CopyTime(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,time_buff)==-1)
    {
    //--- 時間データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("時間データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }
  
  //--- 指定範囲内のローソク足の高値をコピー
  if(CopyHigh(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,high_buff)==-1)
    {
    //--- 高値データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("高値データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }
  
  //--- 指定範囲内のローソク足の安値をコピー
  if(CopyLow(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,low_buff)==-1)
    {
    //--- 安値データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("安値データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }
  
  //--- 指定範囲内のローソク足の始値をコピー
  if(CopyOpen(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,open_buff)==-1)
    {
    //--- 始値データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("始値データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }
  
  //--- 指定範囲内のローソク足の終値をコピー
  if(CopyClose(InpSymbolName,InpSymbolPeriod,InpDateStart,date_finish,close_buff)==-1)
    {
    //--- 終値データの取得に失敗した場合のエラーメッセージを出力
    PrintFormat("終値データの取得に失敗しました。エラーコード = %d",GetLastError());
    return;  // 処理を終了
    }

//--- 時間データの配列のサイズを取得
  size=ArraySize(time_buff);
  
  //--- 構造体の配列のサイズを変更し、ローソク足データを保存できるようにする
  ArrayResize(cand_buff,size);
  
  //--- 各ローソク足データを構造体配列に格納
  for(int i=0;i<size;i++)
    {
     cand_buff[i].open=open_buff[i];     // 始値を構造体に格納
     cand_buff[i].close=close_buff[i];   // 終値を構造体に格納
     cand_buff[i].high=high_buff[i];     // 高値を構造体に格納
     cand_buff[i].low=low_buff[i];       // 安値を構造体に格納
     cand_buff[i].date=time_buff[i];     // 時間データを構造体に格納
    }
 
  //--- ファイルを開き、構造体配列を書き込む準備をする（ファイルが存在しない場合は自動で作成）
  ResetLastError();
  int file_handle=FileOpen(InpDirectoryName+"//"+InpFileName,FILE_READ|FILE_WRITE|FILE_BIN|FILE_COMMON);

  //--- ファイルが正常に開けた場合の処理
  if(file_handle!=INVALID_HANDLE)
    {
    //--- ファイルが正常に開かれたことをエキスパートログに出力
    PrintFormat("%s ファイルが書き込み用に開かれました",InpFileName);
    PrintFormat("ファイルパス: %s\\Files\\",TerminalInfoString(TERMINAL_COMMONDATA_PATH));
    
    //--- 書き込まれたバイト数をカウントするための変数を準備
    uint counter=0;
    
    //--- 構造体配列をループし、各データをファイルに書き込む
    for(int i=0;i<size;i++)
        counter+=FileWriteStruct(file_handle,cand_buff[i]);  // 各ローソク足のデータをバイナリファイルに書き込む
    
    //--- 書き込まれたバイト数とファイル名をエキスパートログに出力
    PrintFormat("%d バイトの情報が %s ファイルに書き込まれました",counter,InpFileName);
    
    //--- 総バイト数が正しいかを検証し、結果をエキスパートログに出力
    PrintFormat("合計バイト数: %d * %d * %d = %d, %s",size,5,8,size*5*8,size*5*8==counter ? "正しい" : "エラー");
    
    //--- ファイルを閉じる
    FileClose(file_handle);
    PrintFormat("データが書き込まれ、%s ファイルは閉じられました",InpFileName);
    }

  else
    {
    //--- ファイルが開けなかった場合のエラーメッセージを出力
    PrintFormat("%s ファイルを開けませんでした。エラーコード = %d",InpFileName,GetLastError());
    }
 }