この記事を開いてくださったこと、心から感謝しています。Pine Scriptで高値や安値の転換点を記録していくと、時刻・価格・表示する文字と、関連する変数がどんどん増えて、管理しきれなくなった人も多いはずです。
結論から言うと、関連する値を何組も持ち回るならユーザー定義型でまとめ、1組だけの単純な記録なら個別の変数のままで十分です。
この記事では、ユーザー定義型の仕組み・作り方・参照の落とし穴・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。
ユーザー定義型とは、どんな仕組みなのか?
まずは、ユーザー定義型の役割と、基本の作り方を整理します。
関連する値を、1つの型にまとめる
TradingViewの公式ドキュメントによると、Pine Scriptのオブジェクトは、ユーザー定義型の実体です。ユーザー定義型は、さまざまな種類の値を持つ項目を、1つにまとめた、自分で決める型です。
- 自分で決める型のこと
- 種類の違う値をまとめられる
宣言は、typeキーワードで行う
公式ドキュメントでは、ユーザー定義型の宣言には、typeというキーワードを使うと説明されています。たとえば、転換点という型を作り、時刻と価格という2つの項目を持たせる、といった使い方です。
実体は、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を比べた記事で整理しています。
項目が多いほど、書き分けの手間が増える
項目が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つか2つの値なら変数で十分
- 型を宣言する手間が省ける
何組も持ち回るなら、ユーザー定義型
転換点を何個も記録して、それぞれに時刻や価格、表示する文字を持たせるなら、ユーザー定義型が向いています。関連する値が、ひとまとまりになり、コードを読みやすく保てます。


迷ったら、変数が増えてきた時点で切り替える
最初から型を作る必要はありません。関連する変数が、5つ以上に増えて、名前の管理が大変になってきた時点で、ユーザー定義型への切り替えを、検討しましょう。
- 変数が増えてきたら切り替える
- 最初から無理に型を作らない
書くときに、確認したいことは何か?
型を使ったコードを書いたあとに、動きが意図どおりかを確かめる手順を、順番にまとめます。
コピーしたつもりで、同じ実体を指していないか見る
コピーしたあとに、片方を書き換えて、もう片方も変わってしまったら、代入で同じ実体を指している可能性があります。copyを使ったか、項目も明示的にコピーしたかを、確かめましょう。
- 代入かcopyかを確かめる
- ラベルなどの項目の扱いを見る
- 片方を書き換えて動きを確認する
naのオブジェクトの扱いに、気をつける
公式ドキュメントによると、naのオブジェクトを、入れ物として用意できます。まだ実体がない状態で、項目を読もうとすると、エラーになる場合があるため、実体ができたかを、先に確かめましょう。
- 実体ができたかを先に確かめる
- naの状態で項目を読まない
チャートツールの選び方も、あわせて考える
型を使った書き方は、MT5のプログラミング言語とは、考え方が異なる部分があります。チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- ツールごとに書き方の考え方が違う
- 違いを知ると取り組みやすい
小さな型から、試してみる
最初は、2つの項目だけの、小さな型で試すと、仕組みがつかみやすくなります。慣れてから、項目を増やしたり、配列と組み合わせたりすると、無理なく進められます。



- 2項目の小さな型から始める
- 慣れたら項目や配列を足す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
オブジェクトの数に、上限はあるのか?
公式ドキュメントのこのページでは、オブジェクトの最大の数は、説明されていません。実際の上限は、スクリプト全体の制限などに影響される場合もあるため、最新の公式ドキュメントで、確かめましょう。
オブジェクトにも、1つ前の足の値を参照できるのか?
公式ドキュメントのこのページでは、オブジェクトの履歴参照については、説明されていません。使いたいときは、配列などと組み合わせて、自分で管理する形を、検討しましょう。
- このページには説明がない
- 配列などで自分で管理する形を検討する
まとめ:「Pine Scriptのユーザー定義型と個別の変数、関連する値をひとまとめにできる整理しやすさとそのまま書ける手軽さどっちを選ぶ?」
何組も持ち回るならユーザー定義型、1組だけなら個別の変数が向いています。代入は同じ実体を指す点と、varipが項目ごとに必要な点に、気をつけましょう。
型の使い方が分かると、コードを整える作業が少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










