この記事を開いてくださったこと、心から感謝しています。MQL5でインジケーターの値を取り出そうとして、CopyBufferの呼び方がいくつもあり、どれを選ぶか迷った人も多いはずです。
結論から言うと、直近の数本の値を手早く取りたいなら位置と本数で指定する方法、時刻で範囲をはっきり決めたいなら日時で指定する方法が向いています。
ただし、日時で指定したときの数え方や、時刻の合わせ方は、確認したMQL5公式ページに書かれていませんでした。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、3つの呼び方・数え方・仮の例・使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
CopyBufferは、そもそも何をする関数なのか?
まずは、公式リファレンスでの説明と、3つの呼び方の違いを整理します。
インジケーターのバッファから、値を配列に取り出す
MQL5公式リファレンスによると、CopyBufferは、あるインジケーターの指定したバッファのデータを、必要な量だけ取得する関数です。最初の2つの引数は、インジケーターのハンドルと、バッファの番号です。
ハンドルは、iMAのような、対応するインジケーター関数が返す値です。取り出した値は、最後の引数の配列に入ります。
- インジケーターのバッファから値を取る
- 最初の引数はハンドル
- 次の引数はバッファの番号
呼び方は、3種類ある
公式リファレンスには、同じ名前で3つの呼び方が載っています。1つ目は開始位置と本数、2つ目は開始日時と本数、3つ目は開始日時と終了日時で指定する方法です。
どれも、戻り値は整数で、最後の引数は取り出し先の配列です。
戻り値は、取り出せた数か、-1である
公式リファレンスによると、戻り値は、取り出せたデータの数です。エラーのときは-1が返ります。呼び出したあとは、この値を確かめてから、配列を使いましょう。
たとえば、3本を求めて2本しか返らなかったときは、足りない分を、そのまま使わないように気をつけましょう。本数の確認を入れておくと、計算の抜けに早く気づけます。
- 成功したら取り出せた数が返る
- エラーのときは-1が返る
- 戻り値を確かめてから使う
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
3つの呼び方を、表で比べる
公式リファレンスの説明をもとに、違いを表にまとめます。選ぶときの目安として使ってください。
| 項目 | 開始位置と本数 | 開始日時と本数 | 開始日時と終了日時 |
|---|---|---|---|
| 範囲の決め方 | 位置と本数 | 時刻と本数 | 時刻と時刻 |
| 開始の基準 | 0が現在の足 | 最初の要素の足の時刻 | 最初の要素の足の時刻 |
| 終わりの基準 | 本数 | 本数 | 最後の要素の足の時刻 |
| 数え方の細かい説明 | あり | 記載なし | 記載なし |
※公式リファレンスの説明をもとにした、筆者の整理です。
位置と本数で指定すると、どう取れるのか?
次に、一番よく使われる、開始位置と本数で指定する方法を見ていきます。
0は現在の足で、過去へ向かって数える
公式リファレンスによると、開始位置からの数え方は、現在から過去に向かって行われます。開始位置が0なら、現在の足の値を指します。
たとえば、0から3本と指定すれば、現在の足と、そのひとつ前、ふたつ前の足の値が対象です。直近の数本を取りたいときに、分かりやすい指定です。
- 現在から過去へ数える
- 開始位置0は現在の足
- 直近の数本を取りやすい
配列の向きに関わらず、古い順に入る
公式リファレンスによると、取り出し先の配列が時系列として扱われるかどうかに関わらず、データは、最も古い要素が、配列の先頭に入る形でコピーされます。
ただし、ArraySetAsSeriesが、取り出した結果の見え方をどう変えるかについては、確認したページに詳しい説明がありませんでした。使う前に、添え字の向きを確かめましょう。
公式の例は、位置0から必要な数だけ取る
公式リファレンスの例は、別のインジケーターのバッファの値を、自分のバッファに入れる書き方です。CopyBufferには、ハンドル、バッファ番号0、開始位置0、必要な本数、取り出し先の配列を渡しています。
この例は、開始位置と本数で指定する、1つ目の呼び方にあたります。戻り値が0以下なら、処理をやめる書き方も添えられています。
- 開始位置0から取り出す
- 戻り値が0以下なら処理をやめる
日時で指定すると、どう取れるのか?
続いて、日時で指定する2つの呼び方を見ていきます。
開始日時と本数で、起点を時刻で決める
公式リファレンスによると、開始日時は、最初の要素に対応する足の時刻です。位置で数える方法と違い、起点を、時刻ではっきり決められます。
ただし、本数が、開始日時から過去へ向かうのか、未来へ向かうのかは、確認したページに記載がありませんでした。
- 起点を時刻で決められる
- 最初の要素の足の時刻を渡す
- 本数の向きは記載なし
開始日時と終了日時で、範囲を時刻で決める
公式リファレンスによると、終了日時は、最後の要素に対応する足の時刻です。範囲の両端を、時刻で決められるため、特定の期間の値だけを取り出したいときに向いています。
時刻の合わせ方は、記載なし
確認したページには、渡した時刻に足がない場合に、どう扱われるかの説明が、ありませんでした。市場が閉まっている時間や、足が欠けている日時を渡すときは、公式の最新情報や、実際の動きを、必ず確かめてください。
- 足がない時刻の扱いは記載なし
- 市場の休みの扱いも記載なし
- 実際の動きを確かめてから使う
仮の例で比べると、どう違って見えるのか?
ここでは、筆者が決めた仮の前提で、2つの方法の違いを考えます。
例の前提を、そろえる
1時間足のチャートで、10時、11時、12時、13時の4本の足が並んでいると仮定します。現在の足は13時とし、移動平均のバッファの値を取り出すものとします。
- 1時間足で10時から13時の4本
- 現在の足は13時
- 移動平均のバッファを取り出す
※筆者が設定した仮の前提による例です。実際の結果を示すものではありません。
位置と本数なら、直近の3本が取れる
開始位置0、本数3と指定すると、現在の足の13時と、そのひとつ前の12時、ふたつ前の11時の3本が対象になります。取り出された配列では、11時の値が先頭に入ると、公式の説明から読み取れます。
- 対象は13時、12時、11時
- 先頭に入るのは最も古い11時の値
日時なら、10時から12時の3本を指せる
開始日時を10時、終了日時を12時と指定すると、筆者は、10時、11時、12時の3本が対象になると読み取っています。ただし、時刻の合わせ方は、公式のページに記載がないため、筆者の解釈です。
| 指定の仕方 | 対象になる足(仮) | 決める基準 |
|---|---|---|
| 位置0・本数3 | 13時・12時・11時 | 現在からの数え方 |
| 10時から12時 | 10時・11時・12時 | 時刻 |
| 対象の違い | 現在の足を含むか | 基準が位置か時刻か |
※仮の数字にもとづく、筆者の例です。日時指定の対象は、公式の定義ではなく、筆者の解釈です。
新しい足が増えると、位置指定は中身が変わる
14時の足が新しくできると、位置0は14時の足を指すようになります。つまり、同じ指定でも、取り出される足が、時間とともに変わります。時刻で指定すれば、決めた足を、そのまま指し続けられます。
- 位置指定は時間とともに中身が変わる
- 時刻指定は決めた足を指し続ける
どう使い分ければよいのか?
2つの方法の特徴をふまえて、目的別の使い分けを考えます。
直近の値を使うなら、位置と本数が向いている
売買の条件に、直近の数本の値を使うなら、位置と本数が向いています。足の取得方法の比較は、CopyRatesとiCloseの比較記事で整理しています。
位置で数える書き方は、足が増えても同じ指定のまま使えるため、毎回の処理に組み込みやすいのが利点です。迷ったら、まずはこちらから試しましょう。
- 直近の数本を使いたい
- 書き方を短くしたい
- 現在の足を基準にしたい
決めた期間の値なら、日時が向いている
過去の特定の期間の値を取り出して調べたいなら、日時で指定する方法が向いています。基準が時刻なので、あとから読み返したときも、対象の範囲が分かりやすくなります。
処理を動かす頻度の考え方は、OnTickとOnTimerの比較記事で整理しています。
日時で指定する場合は、渡す時刻が、足の始まりの時刻になっているかを、事前に確かめておくと安心です。確認したページには、この点の説明がありませんでした。
データが用意できていない場合に、備える
公式リファレンスによると、EAやスクリプトから要求したとき、データが用意できていなければ、サーバーからの取得や、ローカルの履歴からの作成が始まります。その時点で用意できた数が、戻り値になります。
一方、インジケーターの中から要求したときは、データが用意できていなければ、すぐに-1が返り、取得や作成だけが始まると説明されています。どちらの場合も、戻り値の確認が欠かせません。
FX口座・ツールの比較一覧もあわせて確認してみてください。
- EAでは用意できた数が返る
- インジケーターではすぐ-1が返る
- 戻り値を必ず確認する
小さく試して、動きを確かめる
いきなり大きなEAで試さず、短いスクリプトで、位置指定と日時指定を並べて試しましょう。取り出された数と、配列の中身をログに出すと、違いがよく分かります。









- 短いスクリプトで並べて試す
- 取り出した数と中身を確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
取り込める本数に、上限はあるのか?
確認した公式ページには、チャートの最大バー数や、処理の速さに関する説明が、ありませんでした。上限や速さは、実際の環境で確かめてください。
配列の大きさは、あらかじめ決めておくべきか?
公式リファレンスによると、取り出す量が分からないときは動的配列が勧められています。量が分かっているときは、余計なメモリを使わないよう、固定の大きさの配列のほうがよいと説明されています。
- 量が不明なら動的配列
- 量が分かっていれば固定の配列
この記事の例は、実際の結果なのか?
いいえ、筆者が決めた仮の前提にもとづく例です。実際の動きや、将来の結果を示すものではありません。
- 仮の前提による例
- 実際の動きとは異なる場合がある
まとめ:「MQL5のCopyBufferの位置指定と日時指定、現在の足から数えて手早く取れる素直さと時刻で範囲を決められる明確さどっちを選ぶ?」
直近の数本を手早く取りたいなら位置と本数、決めた期間を時刻ではっきり指したいなら日時が向いています。どちらも、戻り値を確かめる書き方を、忘れずに添えましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










