この記事を開いてくださったこと、心から感謝しています。べき乗の計算をしたいときと、平方根を求めたいときで、MathPowとMathSqrtのどちらを使えばよいのか迷っている人も、きっと多いはずです。
結論から言うと、好きな指数でべき乗を求めたいときはMathPow、平方根を求めたいときはMathSqrtです。公式の説明では、MathPowは底と指数の2つを受け取り、MathSqrtは1つの値を受け取って平方根を返します。
また、確認した公式ページに書かれていない点もありました。たとえば、MathPowで底が負のときの動きや、エラーコードです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、負の値の扱い、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
MathPowとMathSqrtは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。渡す値の数と、計算の自由度が違います。
MathPowは、底と指数を渡してべき乗を求める関数である
MathPowは、底と指数の2つを渡す関数です。公式の形は、double型の値を2つ受け取り、double型の値を返すものとして載っています。戻り値は、底を、指定した指数で累乗した値です。
公式には、MathPowの代わりにpowという名前も使える、という説明があります。指数を自由に変えられるため、2乗にも3乗にも使えます。
- 底と指数の2つを渡す
- 底を指数で累乗した値が、戻り値になる
- powという別名も使える
たとえば、指数を入力値にして、乗数を変えながら結果を比べたいときに便利です。公式のサンプルも、指数を入力値にして、結果の変化を見る作りになっています。
MathSqrtは、1つの値を渡して平方根を求める関数である
MathSqrtは、1つの値を渡す関数です。戻り値は、その値の平方根です。公式には、MathSqrtの代わりにsqrtも使える、という説明があります。
引数の説明は「正の数値」となっています。一方で、戻り値の説明には、負の値を渡すとNaNが返る、と書かれています。NaNは、不定の値を表す特別な値です。
- 1つの値を渡す
- 平方根が、戻り値になる
- 負の値を渡すと、NaNが返る
- sqrtという別名も使える
平方根に目的が決まっているなら、MathSqrtのほうが、引数が少なく書き間違いも起きにくい、という見方もできます。この点は、公式には書かれていない、筆者の読み取りです。
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | MathPow | MathSqrt |
|---|---|---|
| 引数の数 | 2つ(底と指数) | 1つ(値) |
| 戻り値 | 底の累乗 | 平方根 |
| 別名 | pow | sqrt |
| 負の値の扱い | 記載なし | NaNが返る |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
負の値や特別な値は、どう扱われるのか?
2つの関数で、最も気をつけたいのは、通常の範囲から外れた値を渡したときの扱いです。公式の記載の差が、はっきり出る部分でもあります。
MathSqrtは、負の値でNaNを返すと書かれている
公式には、MathSqrtに負の値を渡すと、NaNが返ると書かれています。この説明があるため、負の値が入る可能性があるときは、戻り値をそのまま使わず、確認してから使う、という考え方ができます。
- 負の値を渡すと、NaNが返る
- 戻り値の確認が、役に立つ
- 0を渡したときの説明は、記載なし
NaNを返す仕組みは、計算が続けられないことを、呼び出した側に伝える一つの方法です。ただし、NaNを判定する関数の使い方は、これらのページには載っていないため、別の資料で確かめる必要があります。
引数の説明は「正の数値」ですが、0を渡してよいのかどうかは、文章には書かれていません。サンプルの出力例には、0の平方根として0が載っていますが、これは出力例の中の話です。
MathPowには、特別な値の説明が見当たらない
MathPowのページには、底が負のときや、指数が小数のときの動きについての説明がありません。0を0乗したときや、結果が大きくなりすぎたときの動きも、記載なしです。
- 底が負のときは、記載なし
- 0の0乗は、記載なし
- 結果が大きくなりすぎたときは、記載なし
記載がない以上、実際の動きは、自分の環境で確かめるしかありません。使う予定の値の範囲で、小さな確認用のスクリプトを作って、結果を表示してから組み込むと安心です。
どちらにも、エラーコードの説明はない
2つのページには、エラーが起きたときのコードの説明はありません。エラーを取得する関数は、サンプルの画面保存の処理の中に出てきますが、関数そのものの説明ではありません。
- エラーコードは、記載なし
- 無限大を渡したときは、記載なし
- NaNを渡したときは、記載なし
公式サンプルは、どう読めばよいのか?
公式ページには、どちらにも、グラフを描くサンプルが載っています。ここでは、サンプルが何をしているのかを、順に整理します。
MathPowのサンプルは、0から10までの値を累乗している
MathPowのサンプルでは、0から10までの11個の値を持つベクトルを用意します。そして、指数の入力値(初期値は2)で、すべての値を累乗し、結果をグラフに描きます。
サンプルの末尾のコメントには、結果の例が載っています。指数が2のとき、0、1、4、9、16、25、36、49、64、81、100と並ぶ形です。これは、コメントとして載っている出力例です。
実際に表示された画面の記録ではない点には、注意が必要です。数値を丸める関数は、MathFloorとMathCeilの記事で扱っています。
- 0から10までの値を用意する
- 指数の入力値で累乗する
- 結果をグラフに描く
指数を変えると、グラフの曲線の形も変わります。数値の並びだけでなく、形でも変化を確かめられるのが、サンプルの工夫と言えます。
なお、サンプルでは、関数にベクトルを渡していますが、ページに載っている関数の形は、数値を2つ受け取るものだけです。ベクトル用の形が説明されているわけではない点は、覚えておくとよいでしょう。
MathSqrtのサンプルは、同じ値の平方根を求めている
MathSqrtのサンプルも、0から10までの11個の値を持つベクトルを用意し、すべての値の平方根を求めて、グラフに描きます。入力値はなく、平方根に固定された作りです。
末尾のコメントの出力例には、0、1、1.414…、1.732…、2、と続く値が載っています。これも、コメントの出力例です。MathPowのサンプルとの違いは、指数の入力値があるかどうかだけで、ほかの部分はほぼ同じ作りです。
- 0から10までの値を用意する
- 平方根を求める
- 結果をグラフに描く
サンプルから分かることと、分からないこと
サンプルから読み取れるのは、値の並びに対して、累乗や平方根を求める基本の使い方です。一方で、負の値や特別な値を渡したときの動きは、サンプルからは読み取れません。
- 分かる:0から10までの累乗と平方根の例
- 分からない:負の値のときのMathPowの動き
- 分からない:エラーのときの動き
どう使い分ければよいのか?
指数を自由に変えたいならMathPow、平方根を求めたいならMathSqrtです。ただし、特別な値を渡す可能性があるときは、どちらも自分の環境で確かめてから使うのが安心です。
指数を変えたいなら、MathPowを選ぶ
2乗や3乗など、指数を自由に変えたいときは、MathPowが向いています。サンプルのように、指数を入力値にしておくと、あとから変えやすくなります。
FX口座・ツールの比較一覧もあわせて確認してみてください。
平方根を求めたいなら、MathSqrtを選ぶ
平方根を求めたいときは、MathSqrtが向いています。引数が1つで、負の値のときにNaNが返ることも、公式に書かれています。値の範囲が不確かなときは、戻り値を確認すると安心です。
- 平方根を求めたい
- 引数は、1つだけ
- 負の値では、NaNが返る
ほかの数値関数と組み合わせるときは、順番を考える
累乗や平方根の結果を、さらに別の関数で処理する場合は、どの順番で処理するかで、結果が変わる可能性があります。2つの値から大きいほうや小さいほうを選ぶ関数は、MathMaxとMathMinの記事で整理しています。
- 処理の順番を決めておく
- 順番を変えると、結果が変わる可能性がある
- 結果は、表示して確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、小さな数値を使って確かめるのが安心です。
まずは、小さな数値で結果を表示する
最初は、2や3、4のような、小さな数値を用意して、MathPowで累乗を、MathSqrtで平方根を求め、結果を表示します。公式のサンプルの出力例と、見比べてみるのも一つの方法です。
- 2、3、4など、小さな数値を用意する
- 累乗と平方根の結果を表示する
- 出力例と見比べる
表示した結果は、使った環境や設定で変わる可能性があります。入力した値と、表示された結果を、セットでメモに残しておくと、あとで見返すときに役立ちます。
次に、負の値を渡して動きを確かめる
次に、負の値を渡して、結果を表示します。MathSqrtでは、公式の説明どおりにNaNが返るかどうかを、MathPowでは、どう動くのかを、自分の目で確かめます。
- 負の値を渡す
- MathSqrtでNaNが返るか確かめる
- MathPowの動きを確かめる
最後に、使う範囲の値で確かめる
最後に、使う予定の値の範囲で、動きを確かめます。結果が大きくなりすぎる可能性があるなら、その場合の動きも、先に試しておくと安心です。









- まず、小さな数値で結果を表示する
- 次に、負の値で動きを確かめる
- 最後に、使う範囲の値で確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
MathPowで、底が負のときはどうなるのか?
確認した公式ページには、書かれていません。記載なしなので、自分の環境で、実際に試してから使うのが安心です。
- 公式には、記載なし
- 自分の環境で確かめる
MathSqrtで、負の値を渡すとどうなるのか?
公式には、NaNが返ると書かれています。NaNは、不定の値を表すもので、そのまま計算に使うと、結果が意図しないものになる可能性があります。
- NaNが返ると、公式に書かれている
- 戻り値を確認してから使うと安心
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のMathPowとMathSqrt、好きな指数で何乗でも計算できる自由さと平方根に特化した負の値のときのNaNの分かりやすさどっちを使う?」
指数を自由に変えるならMathPow、平方根を求めるならMathSqrtです。どちらも、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










