MQL4MQL5 時系列データ（バー・価格）
CopyRates()
- できること
- 複数のバーの4本値・時刻・出来高をまとめて配列に取得する
- 対応
- MQL4・MQL5
CopyRates() とは
指定した本数（または期間）のバーのデータ（時刻・始値・高値・安値・終値・出来高・スプレッド）を、MqlRates 構造体の配列にまとめてコピーする関数です。
CopyRates() の書式と引数
引数の組み合わせが違う 3 通りの書き方があります。
int CopyRates(
string symbol_name,
ENUM_TIMEFRAMES timeframe,
int start_pos,
int count,
MqlRates &rates_array[]
)
int CopyRates(
string symbol_name,
ENUM_TIMEFRAMES timeframe,
datetime start_time,
int count,
MqlRates &rates_array[]
)
int CopyRates(
string symbol_name,
ENUM_TIMEFRAMES timeframe,
datetime start_time,
datetime stop_time,
MqlRates &rates_array[]
)| 引数 | 型 | 省略時 | 説明 |
|---|---|---|---|
symbol_name | string | 必須 | 銘柄名。 |
timeframe | ENUM_TIMEFRAMES | 必須 | 時間足。 |
start_pos | int | 必須 | 取得を始めるバーの位置（0 が現在のバー）。 |
count | int | 必須 | 取得する本数。 |
rates_array | MqlRates &[] | 必須 | データを受け取る MqlRates の配列。サイズは自動で調整されます。 |
start_time | datetime | 必須 | 取得を始める時刻（その時刻以前の最も近いバーから）。 |
stop_time | datetime | 必須 | 取得を終える時刻。 |
戻り値
コピーできた本数。失敗したら -1。
CopyRates() の使い方（コード例）
MQL4・MQL5 共通
MqlRates r[];
ArraySetAsSeries(r, true); // r[0] を最新のバーにする
int n = CopyRates(_Symbol, PERIOD_CURRENT, 0, 10, r);
if(n < 10)
Print("データ不足 n=", n, " error=", GetLastError());
else
Print("1本前 ", TimeToString(r[1].time), " O=", r[1].open, " H=", r[1].high, " L=", r[1].low, " C=", r[1].close);OnTick()・OnStart() などの関数の中に書いて使う例です。MetaEditor でコンパイルできることを確認済みです。
CopyRates() の注意点
- コピーされた配列は、既定では 0 番が最も古いバーです。0 番を最新にしたいときは、先に ArraySetAsSeries(配列, true) を呼んでおきます。
- 戻り値が要求した本数より少ないことがあります。必ず戻り値を確認します。
