この記事を開いてくださったこと、心から感謝しています。Pine Scriptで直近20本の終値の平均を出そうとして、forループで足し算を書くか、組み込み関数のta.smaを使うか、迷った人も多いはずです。
結論から言うと、平均や合計のように組み込み関数がある計算はそちらを使い、独自のルールで1本ずつ判定したいときだけforループが向いています。
この記事では、forとwhileとfor…inの違い・回数の数え方・組み込み関数との比較・使い分けを整理し、自分に合う書き方まで踏み込んでまとめます。
Pine Scriptのループには、どんな種類があるのか?
まずは、3種類のループの考え方と、使い分けの基本を整理します。
forは、回数を決めて繰り返す
TradingViewの公式ドキュメントによると、forは、回数で制御するループです。カウンターが決めた値になるまで、自動で数えながら繰り返します。「0から19まで」のように、回数がはっきりしている計算に向いています。
- 回数で制御するループ
- カウンターが自動で増える
whileは、条件を満たす間、繰り返す
公式ドキュメントでは、whileは、条件で制御するループで、繰り返しのたびに、先に条件を確かめると説明されています。カウンターを自分で更新する必要があるため、書き忘れに注意が必要です。
for…inは、配列などの中身を順に取り出す
公式ドキュメントによると、for…inは、コレクションで制御するループで、配列や行列などを順に調べるときに、よく選ばれる書き方です。要素だけを取り出す形と、番号と要素を両方取り出す形があります。
- 配列などの中身を順に取り出す
- 番号と要素の両方も取り出せる
※仕様は変更される場合があります。最新情報は必ず公式サイトでご確認ください。
forループの回数は、どう数えるのか?
回数の数え方を間違えると、計算結果がずれるため、確認します。
終わりの値も、繰り返しに含まれる
公式ドキュメントでは、最後の繰り返しは、カウンターが終わりの値に達したときに起きると説明されています。つまり、終わりの値は含まれます。たとえば、0から10までのforは、合計11回の繰り返しになります。
- 終わりの値も含まれる
- 0から10までなら11回
5本の平均なら、0から4までで数える
直近5本の終値を、足し合わせるときは、0から4までの5回です。5本ぶんなのに、0から5までと書くと、6本ぶんを足してしまいます。終わりの値が含まれる点を、頭に入れておきましょう。
| 書き方 | 繰り返しの回数 | 足す本数 |
|---|---|---|
| 0から4まで | 5回 | 5本 |
| 0から5まで | 6回 | 6本 |
※終わりの値が含まれる決まりをもとにした、筆者の計算例です。
刻みを指定すると、回数が変わる
公式ドキュメントによると、刻みの値の初期値は1で、正の値で指定します。0から10までを、2刻みにすると、0、2、4、6、8、10の6回になります。始まりが終わりより大きいときは、数が減る方向に進みます。
- 刻みの初期値は1
- 2刻みなら0から10まで6回
数が減る方向にも、進められる
公式ドキュメントによると、始まりの値が、終わりの値より大きいときは、カウンターは減る方向に進みます。たとえば、10から0までなら、10、9、8と減って、0まで進み、合計11回の繰り返しになります。
直近の足から、過去へ向かって調べたいときは、増える方向で書き、足の番号を、カウンターで指定する方法もあります。やりやすい書き方を選びましょう。
- 始まりが大きいと減る方向に進む
- 10から0までなら11回
組み込み関数と比べると、何が違うのか?
公式ドキュメントが示している、ループを避ける考え方を確認します。
公式ドキュメントも、組み込み関数を勧めている
公式ドキュメントでは、20本の平均をループで計算する例について、Pineでは、不要で非効率な方法だと説明されています。同じ計算は、ta.smaの1行で書けて、短く、はるかに効率よく同じ結果になります。
20本の平均を、チャート全体で数える
20本の平均をforで計算すると、1本の足につき、20回の繰り返しです。チャートに5,000本の足があるなら、20×5,000=100,000回の繰り返しになります。組み込み関数なら、書くのは1行です。数が多いほど、差が大きくなります。
| 書き方 | 1本あたりの繰り返し | 5,000本のチャート全体 |
|---|---|---|
| forで20本を足す | 20回 | 100,000回 |
| ta.sma | 書くのは1行 | 1行 |
※足が5,000本という仮定にもとづく、筆者の計算例です。内部の処理の回数とは異なります。
平均の本数を変えると、繰り返しの回数も変わる
平均に使う本数が増えるほど、forループの繰り返しは、本数に比例して増えます。5本なら5回、20本なら20回、50本なら50回です。足が5,000本あるチャートで数えると、次のようになります。
| 平均の本数 | 1本あたりの繰り返し | 5,000本のチャート全体 |
|---|---|---|
| 5本 | 5回 | 25,000回 |
| 20本 | 20回 | 100,000回 |
| 50本 | 50回 | 250,000回 |
※足が5,000本という仮定にもとづく、筆者の計算例です。
平均の種類の違いは、別の記事で整理している
ta.smaは、単純移動平均の関数です。単純移動平均と指数移動平均の違いは、SMAとEMAを比べた記事で整理しています。組み込み関数にも、いろいろな種類があるため、まず探してみましょう。
- ta.smaは単純移動平均
- 先に組み込み関数を探す
forループが向いているのは、どんなときか?
ループを使うほうがよい場面を、整理します。
組み込み関数にない、独自の判定をするとき
「直近10本のうち、陽線が何本あるか」「条件を満たす足が連続で何本続いたか」のような、独自の判定は、組み込み関数で書きにくいため、forループが向いています。1本ずつ調べて、数える書き方ができます。

- 独自の条件で1本ずつ判定できる
- 数える処理が書きやすい
ループの結果は、変数で受け取れる
公式ドキュメントでは、ループが途中で終わった場合は、最後に戻り値の式を評価した繰り返しの値が、返されると説明されています。ループの結果を変数で受け取りたいときは、どの時点の値が返るかを、意識して書きましょう。
- 最後に評価した値が返る
- 途中で終わるときの値に気をつける
途中で打ち切りたいときは、breakを使う
公式ドキュメントによると、breakは、その繰り返しを止めて、ループから完全に抜けます。条件を満たした時点で、これ以上調べる必要がなければ、breakで抜けると、無駄な繰り返しを減らせます。
- breakでループから抜ける
- 無駄な繰り返しを減らせる
特定の回だけ、飛ばしたいときは、continueを使う
公式ドキュメントでは、continueは、その回の残りの処理を飛ばして、次の繰り返しに進むと説明されています。条件に合わない足だけを、スキップして数えたいときに便利です。
| キーワード | 動き |
|---|---|
| break | ループから完全に抜ける |
| continue | その回を飛ばして次へ進む |
※公式ドキュメントの説明をもとにした整理です。
書くときに、気をつけたいことは何か?
ループを書くときに、つまずきやすい点と、注意したい決まりを、順番に確認します。
whileは、カウンターを増やし忘れると止まらない
公式ドキュメントでは、whileでカウンターを増やし忘れると、値が目標に届かず、ループが延々と続き、ついには実行時のエラーになると、警告されています。条件が必ず終わるかを、書いたあとに確認しましょう。
終わりの値は、繰り返しのたびに確認される
公式ドキュメントによると、forの終わりの値は、各繰り返しの最初に、そのつど評価されます。ループの中で終わりの値を変えると、あとの繰り返しに影響します。思わぬ動きを避けるため、むやみに変えないのが無難です。
- 終わりの値は毎回評価される
- ループの中で変えない
実行時間の上限にも、気をつける
ループが長すぎると、実行時間の上限を超えて、エラーになる場合があります。公式ドキュメントの本文には、具体的な時間は書かれておらず、この記事では、数字を断定しません。詳しくは、公式ドキュメントのエラーの項目で、確かめましょう。
- 長すぎるループはエラーになる場合がある
- 具体的な上限は公式ドキュメントで確認する
実際に、どう使い分ければいいのか?
ここでは、場面ごとに、どの書き方を選ぶとよいかの目安を整理します。
まず、組み込み関数で書けないかを探す
平均、合計、最高値、最安値など、よくある計算は、組み込み関数が用意されています。ループを書く前に、公式ドキュメントで、関数を探しましょう。短く、速く、読みやすいコードになります。


見つからなければ、forかfor…inで書く
組み込み関数で書けない独自の計算は、forで書きます。配列の中身を順に調べるなら、for…inが向いています。whileは、回数が事前に分からないときに、慎重に使いましょう。
- 回数が決まっていればfor
- 配列の中身を調べるならfor…in
書いたあとは、結果を組み込み関数と見比べる
ループで平均を書いた場合、ta.smaの結果と見比べると、書き方の間違いに気づけます。回数の数え方がずれていないかを、確かめる良い方法です。ストラテジーの書き方は、Pine Scriptのインジケーターとストラテジーを比べた記事でも整理しています。
チャートツールと合わせて口座も比べたい人は、FX口座・ツールの比較一覧もあわせて確認してみてください。



- 組み込み関数の結果と見比べる
- 回数のずれに気づける
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ループの中で、足の過去の値を使えるのか?
はい、使えます。カウンターを使って、closeの何本前の値、というように、過去の足の値を指定できます。公式ドキュメントの平均の例も、この書き方に沿っています。範囲を超えないよう、回数には注意しましょう。



- カウンターで過去の足を指定できる
- 範囲を超えないようにする
ループの実行時間の上限は、何秒か?
公式ドキュメントの本文では、具体的な秒数は確認できませんでした。実行時間の上限を超えるエラーが出たときは、ループの回数を減らすか、組み込み関数に置き換えられないかを、検討しましょう。
まとめ:「Pine Scriptのforループと組み込み関数ta.sma、自分で計算を組み立てる自由度と短く速く書ける手軽さどっちを選ぶ?」
よくある計算は組み込み関数、独自の判定はforループが向いています。終わりの値が繰り返しに含まれる点や、whileの更新忘れに気をつけましょう。
書き方の違いが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトにてご確認ください。










