MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. Pine Scriptのマップと配列、名前を目印に値を出し入れできる便利さと順番に集計できる分かりやすさどっちを選ぶ?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

Pine Scriptのマップと配列、名前を目印に値を出し入れできる便利さと順番に集計できる分かりやすさどっちを選ぶ?

2026 11/17
PR
FX自動売買と人工知能
2026年11月17日
Pine Scriptのマップと配列の違い

この記事を開いてくださったこと、心から感謝しています。Pine Scriptで複数の通貨ペアの値を覚えておきたいとき、配列に入れて番号で管理するか、名前ごとに値を引き出せる仕組みを使うか、迷った人も多いはずです。

結論から言うと、順番に並べて集計したいなら配列、名前を目印に値を出し入れしたいならマップが向いています。

この記事では、マップの仕組み・キーと値の決まり・上限・配列との違い・使い分けを整理し、自分に合う選び方まで踏み込んでまとめます。

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つほどの、小さなマップで、入れて、取り出して、上書きする動きを確かめましょう。仕組みがつかめてから、通貨ペアの数を増やすのが、無理のない進め方です。

Kenichi
Kenichi
2つのキーで試してから増やしたら、上書きやnaの動きがよく分かりました。小さく試すのが一番ですね。

チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。

  • 2つのキーで動きを確かめる
  • 慣れてから数を増やす

実際に、どう使い分ければいいのか?

ここでは、よくある場面ごとに、マップと配列のどちらを選ぶとよいかの目安をまとめます。

名前で引き出すなら、マップ

通貨ペアの名前や、設定の名前など、名前を目印にして値を出し入れしたいなら、マップが向いています。更新も、同じキーに入れ直すだけで済みます。

設定の名前で値を引き出せるようにしたら、コードが読みやすくなって、あとから直すのも楽になりました。
  • 名前を目印に値を出し入れできる
  • 更新は同じキーに入れ直すだけ

順番に並べて集計するなら、配列

時間の順に並べた値を、まとめて集計したいなら、配列が向いています。入れ替えながら持つ書き方や、並べ替えも、配列の得意な分野です。

  • 順番に意味がある集計に向く
  • 並べ替えも配列が得意

併用すると、両方のよさを使える

通貨ペアの名前をキーに、直近の値の配列を持つ、といった併用もできます。ただし、マップは配列を直接持てないため、ユーザー定義型で包む形になります。まずは、単純な使い方から、試しましょう。

まずは単純なマップから使い始めて、必要になってから組み合わせるようにしたら、無理なく覚えられました。
  • 併用は型で包む形になる
  • まずは単純な使い方から試す

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

キーに使えるのは、文字列だけなのか?

文字列だけではありません。公式ドキュメントでは、基本の型や列挙型など、値の型であれば、キーにできると説明されています。ただし、このページでは、基本の型の一覧までは、確認できていません。

  • 値の型ならキーにできる
  • 一覧は公式ドキュメントで確認する

配列とマップで、処理の速さは違うのか?

公式ドキュメントの読んだ範囲では、速さの比較は、確認できませんでした。この記事では、速さの優劣は断定しません。最新の公式ドキュメントで、確かめましょう。

  • 速さの比較は確認できなかった
  • 最新の公式ドキュメントで確かめる

まとめ:「Pine Scriptのマップと配列、名前を目印に値を出し入れできる便利さと順番に集計できる分かりやすさどっちを選ぶ?」

名前で値を引き出したいならマップ、順番に集計したいなら配列が向いています。マップの上限は5万組で、配列より早く届く点に気をつけましょう。

  • 名前で引き出すならマップ
  • 順番に集計するなら配列
  • マップの上限は5万組

入れ物の違いが分かると、データの整理が少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • TradingView Pine Script公式ドキュメント(Maps)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • Pine Scriptのユーザー定義型と個別の変数、関連する値をひとまとめにできる整理しやすさとそのまま書ける手軽さどっちを選ぶ?
  • Pine Scriptのstr.formatとプラスでの連結、数値の見た目まで整えられる便利さと短く素直に書ける簡単さどっちを選ぶ?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
    2026年11月17日
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
    2026年11月17日
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    2026年11月17日
  • MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    MQL5のMQLInfoIntegerとTerminalInfoInteger、動かしているプログラム自身の状態を調べられる確かさと端末全体の環境を調べられる幅広さどっちを選ぶ?
    2026年11月17日
  • MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    MQL5のSendMailとSendFTP、文章をメールで届けられる手軽さとファイルをFTPサーバーへ送れる便利さどっちを選ぶ?
    2026年11月17日
  • MQL5のExpertRemoveとIsStoppedの比較
    MQL5のExpertRemoveとIsStopped、自分からプログラムを終わらせられる主導権と外からの終了の合図に気づける安心感どっちを選ぶ?
    2026年11月17日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5のiBarShiftとiTimeの比較
    MQL5のiBarShiftとiTime、時刻から足の番号をすぐ探せる便利さと番号から足の開始時刻を取り出せる素直さどっちを選ぶ?
  • MQL5のBarsとSeriesInfoIntegerの比較
    MQL5のBarsとSeriesInfoInteger、期間を指定して本数をすぐ数えられる手軽さと履歴の始まりや同期の状態まで確かめられる確かさどっちを選ぶ?
  • MQL5のMarketBookAddとMarketBookGetの比較
    MQL5のMarketBookAddとMarketBookGet、板情報の購読を始めて更新の知らせを受け取れる準備の確かさと今の板の中身をそのまま配列で読める手軽さどっちを選ぶ?
  • MQL5のTerminalInfoStringとMQLInfoStringの比較
    MQL5のTerminalInfoStringとMQLInfoString、端末の場所や名前を知る頼もしさとプログラム自身の名前と置き場所を知る確かさどっちを選ぶ?
  • MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
    MQL5のCopyTicksとCopyTicksRange、開始時刻と件数でまとめて取れる手軽さと期間を区切ってきっちり取れる確かさどっちを選ぶ?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次