MQL5 テクニカル指標
CopyBuffer()
- できること
- インジケーターのハンドルから値を配列に読み出す
- 対応
- MQL5
CopyBuffer() とは
MQL5 で、iMA()・iRSI()・iCustom() などで作ったインジケーターのハンドルから、指定したバッファの値を配列にコピーする関数です。MQL5 でインジケーターの値を読むときは、ほぼ必ずこの関数を使います。
CopyBuffer() の書式と引数
引数の組み合わせが違う 3 通りの書き方があります。
int CopyBuffer(
int indicator_handle,
int buffer_num,
int start_pos,
int count,
double &buffer[]
)
int CopyBuffer(
int indicator_handle,
int buffer_num,
datetime start_time,
int count,
double &buffer[]
)
int CopyBuffer(
int indicator_handle,
int buffer_num,
datetime start_time,
datetime stop_time,
double &buffer[]
)| 引数 | 型 | 省略時 | 説明 |
|---|---|---|---|
indicator_handle | int | 必須 | iMA() などが返したハンドル。 |
buffer_num | int | 必須 | バッファの番号（0 から）。MACD なら 0 がメイン、1 がシグナル。 |
start_pos | int | 必須 | 読み始めるバーの位置（0 が現在のバー、1 が確定したひとつ前のバー）。 |
count | int | 必須 | 読む本数。 |
buffer | double &[] | 必須 | 値を受け取る配列。 |
start_time | datetime | 必須 | 読み始める時刻。 |
stop_time | datetime | 必須 | 読み終える時刻。 |
戻り値
コピーできた本数。失敗したら -1。
CopyBuffer() の使い方（コード例）
int hMa = INVALID_HANDLE;
int OnInit()
{
hMa = iMA(_Symbol, PERIOD_CURRENT, 20, 0, MODE_EMA, PRICE_CLOSE);
return hMa == INVALID_HANDLE ? INIT_FAILED : INIT_SUCCEEDED;
}
void OnTick()
{
double ma[];
ArraySetAsSeries(ma, true); // ma[0] を新しいほうにする
int n = CopyBuffer(hMa, 0, 0, 3, ma); // 現在・1本前・2本前
if(n < 3)
{
Print("まだ値がありません n=", n, " error=", GetLastError());
return;
}
Print("EMA 現在=", ma[0], " 1本前=", ma[1], " 2本前=", ma[2]);
}MetaEditor でコンパイルできることを確認済みです。
CopyBuffer() の注意点
- 配列は、既定では 0 番が最も古いバーです。start_pos=1, count=2 でコピーすると、buffer[0] が2本前、buffer[1] が1本前になります。ArraySetAsSeries(buffer, true) にしておくと buffer[0] が新しいほう（1本前）になります。
- インジケーターを作った直後は計算が終わっておらず、-1 が返ることがあります（エラー4806）。戻り値を確認し、足りなければ次のティックで読み直します。
- 読み出す位置 start_pos は、MQL4 の shift と同じ数え方です（0 が最新）。
MQL4 と MQL5 の違い
MQL4 にはありません。MQL4 では iMA(…, shift) のように、インジケーター関数が値を直接返します。
