この記事を開いてくださったこと、心から感謝しています。2つの数値のうち、大きいほうを選びたいのか、小さいほうを選びたいのか、MathMaxとMathMinのどちらを使えばよいのか迷っている人も、きっと多いはずです。
結論から言うと、2つの値のうち大きいほうを取りたいときはMathMax、小さいほうを取りたいときはMathMinです。公式の説明では、どちらも2つの値を受け取り、MathMaxは大きいほう、MathMinは小さいほうを返します。
また、確認した公式ページに書かれていない点もありました。たとえば、数値でない値が混ざったときの動きや、エラーコードです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、型の扱い、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
MathMaxとMathMinは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。形はほとんど同じで、返す値が逆になっています。
MathMaxは、2つの値のうち大きいほうを返す関数である
MathMaxは、1つ目の値と2つ目の値の2つを渡す関数です。公式の形は、double型の値を2つ受け取り、double型の値を返すものとして載っています。戻り値は、2つの値のうち大きいほうです。
公式には、MathMaxの代わりにfmaxという名前も使える、という説明があります。fmaxとMathMaxの動きが完全に同じかどうかまでは、書かれていません。
- 2つの値を渡す
- 大きいほうが、戻り値になる
- fmaxという別名も使える
たとえば、ある値が下がりすぎないように、下の限りを決めておきたいときに、MathMaxは役立ちます。公式に、この使い方の説明があるわけではありませんが、動きを思い浮かべるときの助けになります。
MathMinは、2つの値のうち小さいほうを返す関数である
MathMinも、2つの値を渡す関数で、形はMathMaxと同じです。戻り値は、2つの値のうち小さいほうです。MathMinの代わりにfminも使える、という説明も、MathMaxと同じように載っています。
- 2つの値を渡す
- 小さいほうが、戻り値になる
- fminという別名も使える
こちらは、ある値が大きくなりすぎないように、上の限りを決めておきたいときに役立ちます。この例えも、公式にはありませんが、動きを考えるときの手がかりになります。
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | MathMax | MathMin |
|---|---|---|
| 戻り値 | 2つのうち大きいほう | 2つのうち小さいほう |
| 別名 | fmax | fmin |
| 引数の数 | 2つ | 2つ |
| 数値でない値の扱い | 記載なし | 記載なし |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
型の扱いは、どうなっているのか?
2つの関数で、まず確認しておきたいのは、整数と小数が混ざったときの扱いです。公式のページに、短い説明が載っています。
整数のまま渡しても使える
公式には、fmaxとfminとMathMaxとMathMinは、整数型の値を、double型に変換しなくても使える、と書かれています。つまり、整数どうしを比べたいときに、わざわざ小数に直す必要はない、と読めます。
- 整数型の値も、そのまま渡せる
- double型への変換は、不要
- 整数のあつかいの細かい点は、記載なし
ただし、公式のページに載っている関数の形は、double型のものだけです。整数用の別の形があるのかどうかは、書かれていません。
型が違うときは、大きいほうの型にそろえられる
公式には、異なる型の値を渡したとき、小さいほうの型が、大きいほうの型に自動で変換される、と説明されています。戻り値の型も、大きいほうの型に合わせられます。同じ型の値を渡したときは、変換は行われません。
この説明は、関数の形がdouble型だけで載っていることと、読んだときに食い違うように見えます。ページには、この点を説明する文章はありません。実際の戻り値の型は、自分の環境で確かめておくと安心です。
- 型が違うときは、大きいほうの型にそろう
- 戻り値の型も、大きいほうに合わせられる
- 同じ型なら、変換は行われない
型に関する、記載のない点
文字列や、真偽値や、日時、列挙型を渡したときの動きは、公式には書かれていません。符号なしの整数と、符号つきの整数を混ぜたときの細かい扱いも、記載なしです。
- 文字列や真偽値は、記載なし
- 日時や列挙型は、記載なし
- 符号の有無が混ざったときは、記載なし
記載のない型で使うときは、小さな確認用のスクリプトを作って、結果を表示してから組み込むと、思わぬ食い違いを防ぎやすくなります。
公式サンプルは、どう読めばよいのか?
公式ページには、それぞれ短いサンプルが載っています。ここでは、サンプルが何をしているのかを、順に整理します。
MathMaxのサンプルは、現在の売値と移動平均を比べている
MathMaxのサンプルでは、まず期間の入力値が1より小さければ、10にそろえています。そのうえで、移動平均の窓口を作り、現在の売値と、移動平均の値を1つ取り出します。
そして、売値と移動平均の値のうち、大きいほうをMathMaxで求めて表示します。売値が移動平均より高いのか、低いのか、同じなのかも、あわせて表示する作りです。現在の売値は、シンボル情報から読み取っています。
- 期間が1より小さければ、10にそろえる
- 売値と移動平均の値を取り出す
- 大きいほうを、MathMaxで求めて表示する
サンプルのコードには、表示の処理が含まれていますが、公式ページには、実際に表示される結果は載っていません。結果は、自分の環境で確かめる必要があります。
MathMinのサンプルは、利用できるバーの数を絞っている
MathMinのサンプルでは、入力値として、必要なバーの数を受け取ります。そして、端末にあるバーの総数を取得します。総数が0なら、データがまだ作られていない、という趣旨の文章を表示します。
そのあと、総数と入力値のうち小さいほうをMathMinで求め、整数に直して使っています。総数のほうが少なければ、その旨の文章も表示します。バーの数を調べる関数は、BarsとSeriesInfoIntegerの記事にまとめました。
- バーの総数を、取得する
- 総数が0なら、その旨を表示する
- 小さいほうをMathMinで求めて使う
こちらも、表示の処理はありますが、実際の結果は、公式ページには載っていません。また、どちらのサンプルも、同じ型の値を渡しているため、型が混ざったときの変換の様子までは、確認できません。
サンプルから分かることと、分からないこと
サンプルから読み取れるのは、2つの値を比べて、片方を選ぶ、という基本の使い方です。一方で、数値でない値や、エラーのときの動きは、サンプルからは読み取れません。
- 分かる:2つの値を比べて選ぶ使い方
- 分からない:表示される結果
- 分からない:エラーのときの動き
どう使い分ければよいのか?
大きいほうを取りたいならMathMax、小さいほうを取りたいならMathMinです。ただし、どちらも、記載のない点は自分の環境で確かめてから使うのが安心です。
下の限りを決めたいなら、MathMaxを選ぶ
ある値が、決めた下の限りを下回らないようにしたいときは、その値と下の限りをMathMaxに渡すと、大きいほうが返ります。サンプルの、期間を1以上にそろえる処理も、この考え方に近いものです。
FX口座・ツールの比較一覧もあわせて確認してみてください。
上の限りを決めたいなら、MathMinを選ぶ
ある値が、決めた上の限りを超えないようにしたいときは、その値と上の限りをMathMinに渡すと、小さいほうが返ります。サンプルの、バーの数を総数までに絞る処理が、この考え方に近いものです。
- 上の限りを守りたい
- 小さいほうが返る
- サンプルではバーの数を総数までに絞っている
小数の丸めと組み合わせるときは、順番を考える
値を丸める処理と組み合わせる場合は、丸める前に比べるのか、丸めたあとに比べるのかで、結果が変わる可能性があります。丸めの違いは、NormalizeDoubleとMathRoundの記事で整理しています。
- 丸める前に比べるか、あとに比べるかを決める
- 順番を変えると、結果が変わる可能性がある
- 結果は、表示して確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、小さな数値を使って確かめるのが安心です。
まずは、小さな数値で結果を表示する
最初は、3と5のような、小さな整数を2つ用意して、MathMaxとMathMinの結果を表示します。大きいほうと小さいほうが、期待どおりに返ってくるかどうかを、自分の目で確かめます。
- 3と5など、小さな整数を用意する
- MathMaxとMathMinの結果を表示する
- 期待どおりかを確かめる
表示した結果は、使った環境や設定で変わる可能性があります。入力した値と、表示された結果を、セットでメモに残しておくと、あとで見返すときに役立ちます。
次に、型を混ぜて戻り値の型を確かめる
次に、整数と小数を混ぜて渡し、戻り値を表示します。公式の説明では、大きいほうの型にそろえられると説明されていますが、関数の形がdouble型だけで載っているため、自分の環境で確かめておくと安心です。
- 整数と小数を混ぜて渡す
- 戻り値を表示する
- 型のそろい方を確かめる
最後に、記載のない値を試す
最後に、使う予定の値の範囲で、動きを確かめます。数値でない値が混ざる可能性があるなら、その場合の動きも、先に試しておくと安心です。









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










