この記事を開いてくださったこと、心から感謝しています。Pine Scriptで複数の通貨ペアの値を覚えておきたいとき、配列に入れて番号で管理するか、名前ごとに値を引き出せる仕組みを使うか、迷った人も多いはずです。
結論から言うと、順番に並べて集計したいなら配列、名前を目印に値を出し入れしたいならマップが向いています。
この記事では、マップの仕組み・キーと値の決まり・上限・配列との違い・使い分けを整理し、自分に合う選び方まで踏み込んでまとめます。
Pine Scriptのマップとは、どんな仕組みなのか?
まずは、マップの基本と、配列との大きな違いを整理します。
キーと値の組みで、データを保存する
TradingViewの公式ドキュメントによると、Pine Scriptのマップは、データをキーと値の組みで保存する集まりです。たとえば、「USDJPY」というキーに、「150.250」という値を結びつけて、持っておけます。
- キーと値の組みで保存する
- 名前を目印に値を結びつけられる
値は、番号ではなくキーで取り出す
公式ドキュメントでは、配列や行列が番号で値を取り出すのに対して、マップは、キーで値を取り出すと説明されています。「3番目の値」ではなく、「USDJPYの値」と指定できるのが、大きな違いです。
宣言は、キーと値の種類を決めて書く
公式ドキュメントによると、マップの宣言では、キーの種類と値の種類を決めます。たとえば、キーが文字列で、値が小数のマップなら、その2つの種類を指定して作ります。varを付ければ、足をまたいで、持ち続けられます。
- キーと値の種類を決めて宣言する
- varで足をまたいで持てる
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
キーと値には、どんな決まりがあるのか?
ここでは、キーと値に使える型の決まりと、同じキーを入れたときの動きを、順番に確認します。
キーは、値の型でなければならない
公式ドキュメントでは、マップのキーは、基本の型や列挙型などの、値の型である必要があると説明されています。参照の型のIDは、キーにできませんが、値としては、入れられます。
- キーは値の型だけ
- 参照の型は値としてなら入れられる
キーは重複できず、同じキーに入れると上書きされる
公式ドキュメントによると、キーは1つしか存在できません。同じキーで、新しい値を入れると、前の値が置き換わります。更新したいときは、同じキーに入れ直すだけで済みます。
ないキーを調べると、naが返る
公式ドキュメントでは、存在しないキーで値を取ろうとすると、naが返ると説明されています。キーがあるかを、先に確かめたいときは、専用の関数が用意されています。naの扱いは、先に決めておきましょう。
| やりたいこと | マップの動き |
|---|---|
| 同じキーに値を入れる | 前の値が置き換わる |
| ないキーの値を取る | naが返る |
| キーの有無を確かめる | 専用の関数を使う |
※公式ドキュメントの説明をもとにした整理です。
上限は、配列とどう違うのか?
マップに入れられる数には、上限があります。配列と比べながら、その決まりを順番に確認します。
キーと値の組みは、最大5万組まで
公式ドキュメントによると、マップが持てるキーと値の組みは、最大5万組です。配列や行列と同じく、要素の合計は10万個までですが、マップは、組みの数で、5万組が上限になります。
- キーと値の組みは最大5万組
- 要素の合計は10万個まで
足ごとに1組ずつ増やすと、何年で届くのか
1時間足で、1本ごとに1組ずつ追加し続けるとします。平日24時間取引なら、1週間で120本です。5万組に届くのは、50,000÷120で、約416.7週間、およそ8年の計算です。配列の10万個なら、約16年です。
| 入れ物 | 上限 | 1時間足で1本ごとに追加した場合 |
|---|---|---|
| 配列 | 10万個 | 約16年 |
| マップ | 5万組 | 約8年 |
※平日24時間取引・1週間で120本という仮定にもとづく、筆者の計算例です。
マップは、配列の半分で上限に届く
同じ数を追加し続けると、マップは配列の半分の期間で、上限に届きます。長い期間のチャートで、足ごとに追加し続ける使い方は、避けて、必要な分だけに絞りましょう。
- 上限は配列の半分
- 足ごとに追加し続ける使い方は避ける
キーと値は、どのように取り出すのか?
マップから値を取り出す方法には、いくつかの種類があります。便利な関数と書き方を、順番に確認します。
キーがあるかを、先に確かめてから使う
公式ドキュメントによると、キーがあるかを確かめる専用の関数が、用意されています。ないキーで値を取るとnaが返るため、naのまま計算に使うと、思わぬ結果になる場合があります。先にキーの有無を確かめる習慣をつけると、安心です。
たとえば、通貨ペアの値を取り出す前に、そのキーが入っているかを確かめれば、入れ忘れにも気づけます。
- 専用の関数でキーの有無を確かめる
- naのまま計算に使わない
キーだけ、値だけを配列で取り出せる
公式ドキュメントでは、マップのキーの一覧や、値の一覧を、新しい配列として取り出す関数が、用意されていると説明されています。取り出した配列を変えても、元のマップは変わりません。
配列の集計関数と組み合わせれば、値の平均などを求められます。配列の考え方は、Pine Scriptの配列と変数の履歴参照を比べた記事で整理しています。
- キーや値を配列で取り出せる
- 取り出した配列を変えても元は変わらない
入れた順番は、内部で保たれる
公式ドキュメントによると、マップは、キーと値の組みを入れた順番を、内部で保っています。値だけを置き換えても、位置は変わりません。一度取り除いて入れ直すと、位置が最後に変わります。
ループでは、キーと値の両方を取り出せる
公式ドキュメントでは、for…inの形で、キーと値の両方を、入れた順番に取り出す書き方が勧められています。すべての通貨ペアの値を、順に調べたいときに便利です。
- キーと値の両方を取り出せる
- 入れた順番どおりに調べられる
配列と比べると、何が便利で、何が不便か?
通貨ペアの値を持つ場面を例にして、配列と比べた便利な点と、不便な点を確かめます。
通貨ペアごとの値を持つなら、マップが分かりやすい
8つの通貨ペアの、最新の値を覚えるとします。配列なら、「1番目がユーロドル、2番目がドル円」と、番号と通貨ペアの対応を、自分で覚えておく必要があります。マップなら、キーに通貨ペアの名前を使えるため、対応表がいりません。
| 方法 | 8つの通貨ペアの値を出し入れするには |
|---|---|
| 配列 | 番号と通貨ペアの対応(8個)を覚える |
| マップ | 通貨ペアの名前をそのまま使う |
※通貨ペアが8つという仮定にもとづく、筆者の整理です。
順番に集計するなら、配列が向いている
直近10本の終値の平均や、並べ替えなど、順番に意味がある集計は、配列が向いています。マップは、キーで引き出すのが得意で、順序に基づく計算は、配列に取り出してから行う形になります。

- 順番に意味がある集計は配列
- 名前で引き出すならマップ
公式ドキュメントに、選び方の決まりはない
公式ドキュメントのこのページには、マップと配列のどちらを選ぶべきかという、はっきりした指針は、書かれていません。違いは、キーで取り出すか、番号で取り出すかです。目的に合わせて、選びましょう。
- 明確な選び方の指針はない
- 取り出し方の違いで選ぶ
書くときに、気をつけたいことは何か?
マップを使うときに、つまずきやすい点と、注意したい決まりを、順番にまとめます。
コピーは、浅いコピーになる
公式ドキュメントによると、マップのコピーは、浅いコピーで、コピーに加えた変更は、元の組みに影響しません。
ただし、値が参照の型のときは、同じ実体を指したままになるため、完全に分けたいなら、値も1つずつコピーします。ユーザー定義型の参照の考え方は、Pine Scriptのユーザー定義型と個別の変数を比べた記事で整理しています。
マップの中に、別のコレクションは直接入れられない
公式ドキュメントでは、マップは、ほかのコレクションを、直接は保存できないと説明されています。配列を値にしたいときは、ユーザー定義型で包む形になります。入れ物の入れ子は、少し手間がかかります。
- ほかのコレクションは直接入れられない
- ユーザー定義型で包む形になる
入れたキーと値を、あとで確かめやすくする
マップの中身は、そのままでは、チャートに見えません。動きがおかしいと感じたときは、一時的に、キーの一覧や組みの数を表示して、確かめましょう。入れ忘れや、キーの書き間違いに、気づきやすくなります。
キーの書き方は、大文字と小文字を含めて、そろえておくのが無難です。書き方がずれると、別のキーとして扱われるためです。
- キーの一覧や組みの数を表示して確かめる
- キーの書き方をそろえておく
最初は、小さなマップで試す
最初は、キーが2つほどの、小さなマップで、入れて、取り出して、上書きする動きを確かめましょう。仕組みがつかめてから、通貨ペアの数を増やすのが、無理のない進め方です。


チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。
- 2つのキーで動きを確かめる
- 慣れてから数を増やす
実際に、どう使い分ければいいのか?
ここでは、よくある場面ごとに、マップと配列のどちらを選ぶとよいかの目安をまとめます。
名前で引き出すなら、マップ
通貨ペアの名前や、設定の名前など、名前を目印にして値を出し入れしたいなら、マップが向いています。更新も、同じキーに入れ直すだけで済みます。



- 名前を目印に値を出し入れできる
- 更新は同じキーに入れ直すだけ
順番に並べて集計するなら、配列
時間の順に並べた値を、まとめて集計したいなら、配列が向いています。入れ替えながら持つ書き方や、並べ替えも、配列の得意な分野です。
- 順番に意味がある集計に向く
- 並べ替えも配列が得意
併用すると、両方のよさを使える
通貨ペアの名前をキーに、直近の値の配列を持つ、といった併用もできます。ただし、マップは配列を直接持てないため、ユーザー定義型で包む形になります。まずは、単純な使い方から、試しましょう。



よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
キーに使えるのは、文字列だけなのか?
文字列だけではありません。公式ドキュメントでは、基本の型や列挙型など、値の型であれば、キーにできると説明されています。ただし、このページでは、基本の型の一覧までは、確認できていません。
- 値の型ならキーにできる
- 一覧は公式ドキュメントで確認する
配列とマップで、処理の速さは違うのか?
公式ドキュメントの読んだ範囲では、速さの比較は、確認できませんでした。この記事では、速さの優劣は断定しません。最新の公式ドキュメントで、確かめましょう。
まとめ:「Pine Scriptのマップと配列、名前を目印に値を出し入れできる便利さと順番に集計できる分かりやすさどっちを選ぶ?」
名前で値を引き出したいならマップ、順番に集計したいなら配列が向いています。マップの上限は5万組で、配列より早く届く点に気をつけましょう。
入れ物の違いが分かると、データの整理が少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










