この記事を開いてくださったこと、心から感謝しています。MathAbsとMathModは、どちらも数を整える関数ですが、何をしてくれるのか、どう使い分けるのか、迷っている人も多いはずです。
結論から言うと、MathAbsは符号を外した大きさ(絶対値)を返す関数、MathModは割り算の余りを実数で返す関数です。公式の説明でも、MathAbsは0以上の値を返し、MathModは実数の余りを返す、と書かれています。
また、確認した公式ページに書かれていない点もありました。たとえば、MathModで割る数が0のときの動きや、非数や無限大を渡したときの扱いです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、符号の扱い、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
MathAbsとMathModは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。どちらも戻り値は実数ですが、引数の数と役割が違います。
MathAbsは、符号を外した絶対値を返す関数である
MathAbsの形は、double MathAbs(double value) です。引数のvalueは、数値です。戻り値は、0以上の実数で、渡した値から符号を外した大きさにあたります。
公式には、MathAbsの代わりにfabsという名前も使える、という説明があります。引数は1つだけで、整数を渡した場合は、実数に自動で変換されて計算されます。
- 引数は、実数を1つ
- 戻り値は、0以上の実数
- fabsという別名も使える
MathModは、割り算の余りを実数で返す関数である
MathModの形は、double MathMod(double value, double value2) です。1つ目のvalueが割られる数、2つ目のvalue2が割る数です。戻り値は、割り算の余りを実数で表した値です。
公式の説明では、割られる数を、整数かける割る数に余りを足した形で表したときの、その余りが戻り値です。余りの符号は割られる数と同じで、余りの大きさは割る数の大きさより小さくなる、と書かれています。公式には、fmodという別名も使える、という説明もあります。
- 引数は、割られる数と割る数の2つ
- 戻り値は、実数の余り
- 余りの符号は、割られる数と同じ
- 余りの大きさは、割る数の大きさより小さい
- fmodという別名も使える
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | MathAbs | MathMod |
|---|---|---|
| 役割 | 符号を外した大きさを求める | 割り算の余りを実数で求める |
| 引数 | 実数が1つ | 割られる数と割る数の2つ |
| 戻り値 | 0以上の実数 | 実数の余り |
| 別名 | fabs | fmod |
| 割る数が0のとき | 該当なし | 記載なし |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
符号と余りは、どう扱われるのか?
2つの関数で、最も気をつけたいのは、符号の扱いです。公式の説明を、順に整理します。
MathAbsは、負の数を正の数にそろえる
MathAbsに負の数を渡すと、符号が外れて、0以上の値になります。たとえば、-10を渡すと、10になります。これは、公式の戻り値の説明から読み取れる動きです。
- 負の数は、符号が外れる
- 正の数は、そのまま返る
- 戻り値は、0以上の実数
一方で、非数や無限大を渡したときの動きは、確認した公式ページには書かれていません。また、マイナスの0のような特別な値の扱いも、記載がありません。
MathModは、余りの符号が割られる数と同じになる
公式の説明では、余りの符号は、割られる数と同じです。つまり、割られる数が負なら、余りも負になります。割る数が負の場合の具体例は、公式ページには載っていません。
- 余りの符号は、割られる数と同じ
- 余りの大きさは、割る数の大きさより小さい
- 割る数が負の例は、記載なし
プログラミング言語によっては、余りの符号の決まり方が違うことがあります。そのため、負の数を扱うときは、公式の説明どおりに動くかどうかを、小さな値で確かめておくと安心です。
書かれていない点は、自分で確かめる
MathModで割る数が0のときの動き、非数や無限大を渡したときの動き、計算の精度は、公式のページには書かれていません。エラーが起きたときにGetLastErrorで調べられるかどうかも、記載がありません。
- 割る数が0のとき:記載なし
- 非数や無限大を渡したとき:記載なし
- 計算の精度:記載なし
- GetLastErrorとの関係:記載なし
特に、割る数が0になる可能性がある場面では、呼ぶ前に0かどうかを確かめる流れにしておくと安心です。これは、公式の説明ではなく、筆者の注意点です。
公式サンプルは、どう読めばよいのか?
公式ページには、それぞれ短いサンプルが載っています。どちらもスクリプトで、入力した値を関数に渡し、結果を表示する作りです。
MathAbsのサンプルは、入力値の絶対値を表示している
MathAbsのサンプルでは、入力の初期値が-10に設定されています。この値をMathAbsに渡して、符号なしの整数の変数に受け取り、結果を表示します。
サンプルの文章は、入力した値と、MathAbsを使ったあとの値を並べて表示するものです。ただし、公式ページには、実際に表示される結果の例は載っていません。コードの動きから、-10に対して10が表示されると考えられますが、これは筆者の推測です。
- 入力の初期値は、-10
- MathAbsに渡して、結果を受け取る
- 入力した値と、結果を並べて表示する
- 表示の例は、公式には載っていない
なお、サンプルでは、整数の入力値が実数に自動で変換され、結果の実数が符号なしの整数に変換されています。この型の変換については、公式には説明がありません。
MathModのサンプルは、10を3で割った余りを表示している
MathModのサンプルでは、割られる数の初期値が10、割る数の初期値が3に設定されています。この2つをMathModに渡して、実数の余りを表示します。
表示の文章は、割る前の2つの数と、実数の余りを、小数点以下2桁で並べるものです。結果の例は、公式ページには載っていません。10を3で割ると、余りは1になるため、1.00と表示されると考えられますが、これも筆者の推測です。
- 割られる数は、10
- 割る数は、3
- 実数の余りを、小数点以下2桁で表示する
- 表示の例は、公式には載っていない
サンプルから分かることと、分からないこと
サンプルから読み取れるのは、入力値を関数に渡して、結果を受け取るという基本の流れです。一方で、負の数や0を渡したときの具体的な結果は、サンプルからは読み取れません。
- 分かる:関数の基本の呼び方
- 分からない:非数や無限大を渡したときの動き
- 分からない:割る数が0のときの動き
どう使い分ければよいのか?
符号を外した大きさがほしいならMathAbs、割り算の余りがほしいならMathModです。2つは、目的がまったく違うので、迷うことは少ないはずです。
差の大きさだけを見たいなら、MathAbsを選ぶ
2つの値の差が、どれくらい離れているかだけを見たいときは、差を計算してMathAbsに渡します。プラスかマイナスかに関係なく、離れている大きさだけが取り出せます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
周期や区切りで割った余りを見たいなら、MathModを選ぶ
ある値を、決まった区切りで割った余りがほしいときは、MathModを使います。たとえば、一定の間隔ごとに、どの位置にあたるかを調べる場面で使えます。
- 決まった区切りで割った余りがほしい
- 引数は、割られる数と割る数の2つ
- 割る数が0にならないよう、先に確かめる
余りではなく、整数に切り下げたり切り上げたりしたいときは、別の関数が向いています。違いは、MathFloorとMathCeilの記事で整理しています。
丸めの関数と、あわせて考える
小数の桁をそろえる処理は、また別の関数の役割です。MathAbsやMathModの結果を、決まった桁にそろえたいときは、NormalizeDoubleとMathRoundの記事も参考になります。
- 符号を外すのは、MathAbs
- 余りを求めるのは、MathMod
- 桁をそろえるのは、別の関数
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、簡単な値を使って確かめるのが安心です。
まずは、MathAbsに正の数と負の数を渡して確かめる
最初は、10と-10のような、符号だけが違う2つの値をMathAbsに渡して、同じ値が返ってくるかどうかを、自分の目で確かめます。
- 10を渡す
- -10を渡す
- 同じ値が返るか見る
次に、MathModで、正の数と負の数の余りを確かめる
次に、10を3で割る場合と、-10を3で割る場合の余りを表示します。公式の説明どおり、余りの符号が、割られる数と同じになるかどうかを確かめます。
- 10を3で割った余りを表示する
- -10を3で割った余りを表示する
- 符号が、割られる数と同じか見る
最後に、割る数が0のときを、安全な形で確かめる
最後に、割る数が0になる場合の扱いを確かめます。公式には記載がないため、呼ぶ前に0かどうかを調べる形にして、動きを確認しておくと安心です。









- まず、10と-10でMathAbsを確かめる
- 次に、余りの符号を確かめる
- 最後に、割る数が0の扱いを確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
MathModで割る数が0のとき、どうなるのか?
確認した公式ページには、書かれていません。記載なしなので、割る数が0にならないよう、呼ぶ前に確かめるのが安心です。
- 公式には、記載なし
- 呼ぶ前に、0かどうか確かめる
整数の引数を渡しても、使えるのか?
公式のサンプルでは、整数の入力値をそのまま渡しています。関数の形は、実数を受け取るものなので、整数は実数に自動で変換されると考えられます。細かい扱いは、記載がありません。
- サンプルは、整数をそのまま渡している
- 関数の形は、実数を受け取る
- 細かい扱いは、記載なし
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のMathAbsとMathMod、符号を外して大きさだけを取り出す分かりやすさと割り算の余りを実数で求める便利さどっちを使う?」
符号を外した大きさがほしいならMathAbs、割り算の余りを実数で求めたいならMathModです。割る数が0のときなど、記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










