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で高値や安値の転換点を記録していくと、時刻・価格・表示する文字と、関連する変数がどんどん増えて、管理しきれなくなった人も多いはずです。

結論から言うと、関連する値を何組も持ち回るならユーザー定義型でまとめ、1組だけの単純な記録なら個別の変数のままで十分です。

この記事では、ユーザー定義型の仕組み・作り方・参照の落とし穴・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。

Pine Scriptのユーザー定義型と個別の変数の違いをまとめたインフォグラフィック
目次

ユーザー定義型とは、どんな仕組みなのか?

まずは、ユーザー定義型の役割と、基本の作り方を整理します。

関連する値を、1つの型にまとめる

TradingViewの公式ドキュメントによると、Pine Scriptのオブジェクトは、ユーザー定義型の実体です。ユーザー定義型は、さまざまな種類の値を持つ項目を、1つにまとめた、自分で決める型です。

  • 自分で決める型のこと
  • 種類の違う値をまとめられる

宣言は、typeキーワードで行う

公式ドキュメントでは、ユーザー定義型の宣言には、typeというキーワードを使うと説明されています。たとえば、転換点という型を作り、時刻と価格という2つの項目を持たせる、といった使い方です。

  • typeキーワードで宣言する
  • 項目に時刻や価格などを持たせる

実体は、newで作る

公式ドキュメントによると、オブジェクトは、型の名前に付くnewという組み込みの方法で作ります。項目の値は、順番で渡す方法と、名前を指定して渡す方法があります。まだ中身がない入れ物は、naのオブジェクトとして用意できます。

  • 型の名前.newで作る
  • 順番か名前で値を渡せる

※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。

項目の初期値と、書き換えは、どうなるのか?

ここでは、項目の初期値の決め方と、あとから値を書き換える方法を、順番に確認します。

初期値は、型の宣言の中で決められる

公式ドキュメントでは、項目の初期値は、型の宣言の中で、イコールで決められると説明されています。newで作るときに、その項目の値を渡さなければ、決めておいた初期値が入ります。

  • 宣言の中で初期値を決める
  • 渡さなければ初期値が入る

項目の値は、あとから書き換えられる

公式ドキュメントによると、オブジェクトの項目の値は、:=という再代入の記号で、変えられます。転換点の価格が更新されたときに、その項目だけを書き換える、といった使い方ができます。

  • :=で項目の値を書き換えられる
  • 必要な項目だけ更新できる

変数の数で、違いを数えてみる

直近の5つの転換点を覚えるとして、1つの転換点に、時刻・価格・文字・色の4つの値があると仮定します。個別の変数なら、5×4=20個の変数です。ユーザー定義型なら、型を1つ宣言して、実体を5つ作るだけで、持ち回る名前は5つになります。

書き方 持ち回る名前の数
個別の変数 20個(5つ×4項目)
ユーザー定義型 5個(実体が5つ)

※転換点5つ、1つあたり4項目という仮定にもとづく、筆者の計算例です。

varとvaripは、オブジェクトにどう働くのか?

足をまたいで値を残す指定との関係を、確認します。

varは、すべての項目にまとめて効く

公式ドキュメントでは、オブジェクトにvarを付けると、そのオブジェクトのすべての項目に、自動で適用されると説明されています。足をまたいで残したい転換点のオブジェクトは、varを付けて宣言しましょう。

  • varはすべての項目に自動で効く
  • 足をまたいで残せる

varipは、項目ごとに付ける必要がある

公式ドキュメントによると、varipは、オブジェクト全体には自動で適用されず、項目ごとに付ける必要があります。リアルタイムの途中の更新まで残したい項目だけに、varipを付ける形です。

varとvaripの違いは、Pine Scriptのvarとvaripを比べた記事で整理しています。

  • varipは項目ごとに付ける
  • オブジェクト全体には効かない

項目が多いほど、書き分けの手間が増える

項目が4つあるオブジェクトで、一部だけを途中の更新まで残したいなら、その項目にだけ、varipを付けます。残す項目と残さない項目を、はっきり分けて書けるのは、ユーザー定義型ならではの整理しやすさです。

  • 残す項目と残さない項目を分けて書ける
  • 整理しやすい

型にまとめると、名前の付け方も整理できる

個別の変数では、転換点1の時刻、転換点1の価格、というように、名前が長くなりがちです。型にまとめれば、項目の名前は、時刻や価格のように、短く済みます。どの転換点の項目かは、オブジェクトの名前で分かります。

名前がそろうと、あとからコードを読み返したときに、意味をつかみやすくなります。数か月後の自分にも、親切な書き方です。

  • 項目の名前が短くなる
  • 読み返したときに意味をつかみやすい

代入とコピーで、何に気をつけるのか?

オブジェクトならではの、参照の落とし穴を確認します。

代入すると、同じ実体を指すことになる

公式ドキュメントでは、Pineのオブジェクトは、参照で代入されると説明されています。たとえば、転換点2に転換点1を代入すると、2つの名前が、同じ実体を指します。片方の項目を書き換えると、もう片方にも反映されます。

  • 代入は同じ実体を指すことになる
  • 片方の書き換えがもう片方にも反映される

copyは、浅いコピーを作る

公式ドキュメントによると、組み込みのcopyは、オブジェクトの浅いコピーを作ります。ふつうの値の項目は、別々の値になりますが、ラベルや線などの項目は、元と同じ実体を指したままです。

  • copyは浅いコピー
  • ラベルや線は元と同じ実体を指す

完全に分けたいなら、項目も明示的にコピーする

公式ドキュメントでは、完全に別のものにしたいときは、ラベルなどの項目も、自分でコピーする必要があると説明されています。コピーしたつもりで、元のラベルまで動かしてしまう失敗を、防げます。

方法 ふつうの値の項目 ラベルなどの項目
代入 同じ実体を指す 同じ実体を指す
copy(浅いコピー) 別々になる 同じ実体を指す
項目も明示的にコピー 別々になる 別々になる

※公式ドキュメントの説明をもとにした整理です。

配列などと、どう組み合わせるのか?

複数のオブジェクトを管理する、基本の形を確認します。

配列に、オブジェクトを入れられる

公式ドキュメントによると、配列や行列、マップといったコレクションは、ユーザー定義型のオブジェクトへの参照を持てます。転換点の型の配列を作れば、直近の10個の転換点を、まとめて管理できます。

配列そのものの考え方は、Pine Scriptの配列と変数の履歴参照を比べた記事で整理しています。

  • 配列にオブジェクトを入れられる
  • 直近の転換点をまとめて管理できる

10個の転換点なら、変数の数が大きく変わる

1つの転換点に4項目で、10個を持つと、個別の変数なら40個です。ユーザー定義型の配列なら、配列が1つで済みます。数が増えるほど、整理のしやすさの差は、広がります。

  • 個別の変数なら40個
  • 配列なら1つで済む

※転換点10個、1つあたり4項目という仮定にもとづく、筆者の計算例です。

メソッドで、型に処理を結びつけられる

公式ドキュメントの例では、型を最初の引数に取るメソッドを作り、オブジェクトの名前に続けて、呼び出す書き方が紹介されています。型に関係する処理を、まとめて持てるため、コードの置き場所が、はっきりします。

ただし、このページでは、メソッドの詳しい決まりまでは、説明されていません。使うときは、メソッドの項目を、あわせて確認しましょう。

  • 型に処理を結びつけられる
  • 詳しい決まりはメソッドの項目で確認する

型には、使えない名前がある

公式ドキュメントでは、整数、小数、文字列、真偽値、色の名前は、ユーザー定義型の名前には使えないと説明されています。型の名前は、中身が伝わる、固有の名前を付けましょう。

  • 基本の型の名前は使えない
  • 中身が伝わる名前を付ける

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

ここでは、場面ごとに、どちらを選ぶとよいかの目安を整理します。

1組だけなら、個別の変数で十分

直近の高値の価格だけを覚えるなど、1つか2つの値だけなら、個別の変数のままで十分です。型を宣言する手間が省けて、書き方も、そのまま素直です。

1つの値だけなら、そのまま変数で書くのが一番楽でした。必要になってから整理すれば間に合います。
  • 1つか2つの値なら変数で十分
  • 型を宣言する手間が省ける

何組も持ち回るなら、ユーザー定義型

転換点を何個も記録して、それぞれに時刻や価格、表示する文字を持たせるなら、ユーザー定義型が向いています。関連する値が、ひとまとまりになり、コードを読みやすく保てます。

Kenichi
Kenichi
転換点を型にまとめたら、変数の名前で迷わなくなって、コードがずっと読みやすくなりました。
  • 関連する値がひとまとまりになる
  • コードを読みやすく保てる

迷ったら、変数が増えてきた時点で切り替える

最初から型を作る必要はありません。関連する変数が、5つ以上に増えて、名前の管理が大変になってきた時点で、ユーザー定義型への切り替えを、検討しましょう。

  • 変数が増えてきたら切り替える
  • 最初から無理に型を作らない

書くときに、確認したいことは何か?

型を使ったコードを書いたあとに、動きが意図どおりかを確かめる手順を、順番にまとめます。

コピーしたつもりで、同じ実体を指していないか見る

コピーしたあとに、片方を書き換えて、もう片方も変わってしまったら、代入で同じ実体を指している可能性があります。copyを使ったか、項目も明示的にコピーしたかを、確かめましょう。

  1. 代入かcopyかを確かめる
  2. ラベルなどの項目の扱いを見る
  3. 片方を書き換えて動きを確認する

naのオブジェクトの扱いに、気をつける

公式ドキュメントによると、naのオブジェクトを、入れ物として用意できます。まだ実体がない状態で、項目を読もうとすると、エラーになる場合があるため、実体ができたかを、先に確かめましょう。

  • 実体ができたかを先に確かめる
  • naの状態で項目を読まない

チャートツールの選び方も、あわせて考える

型を使った書き方は、MT5のプログラミング言語とは、考え方が異なる部分があります。チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。

ツールごとに書き方の考え方が違うと知ってから、書き換えるときに構えず取り組めるようになりました。
  • ツールごとに書き方の考え方が違う
  • 違いを知ると取り組みやすい

小さな型から、試してみる

最初は、2つの項目だけの、小さな型で試すと、仕組みがつかみやすくなります。慣れてから、項目を増やしたり、配列と組み合わせたりすると、無理なく進められます。

2項目の小さな型から試したら、仕組みがよく分かりました。少しずつ広げるのが一番だと実感しています。
  • 2項目の小さな型から始める
  • 慣れたら項目や配列を足す

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

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

オブジェクトの数に、上限はあるのか?

公式ドキュメントのこのページでは、オブジェクトの最大の数は、説明されていません。実際の上限は、スクリプト全体の制限などに影響される場合もあるため、最新の公式ドキュメントで、確かめましょう。

  • このページには上限の記載がない
  • 最新の公式ドキュメントで確かめる

オブジェクトにも、1つ前の足の値を参照できるのか?

公式ドキュメントのこのページでは、オブジェクトの履歴参照については、説明されていません。使いたいときは、配列などと組み合わせて、自分で管理する形を、検討しましょう。

  • このページには説明がない
  • 配列などで自分で管理する形を検討する

まとめ:「Pine Scriptのユーザー定義型と個別の変数、関連する値をひとまとめにできる整理しやすさとそのまま書ける手軽さどっちを選ぶ?」

何組も持ち回るならユーザー定義型、1組だけなら個別の変数が向いています。代入は同じ実体を指す点と、varipが項目ごとに必要な点に、気をつけましょう。

  • 何組もならユーザー定義型
  • 1組なら個別の変数
  • 代入は同じ実体を指す

型の使い方が分かると、コードを整える作業が少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

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

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

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • Pine Scriptの配列と変数の履歴参照、直近の値をまとめて集計できる便利さと少ない本数を素直に書ける分かりやすさどっちを選ぶ?
  • Pine Scriptのマップと配列、名前を目印に値を出し入れできる便利さと順番に集計できる分かりやすさどっちを選ぶ?

この記事を書いた人

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と人工知能の力.

目次