この記事を開いてくださったこと、心から感謝しています。計算した結果が、きちんとした数になっているのか、確かめたい場面は意外と多いものです。MathIsValidNumberとMathClassifyは、そのための関数です。
結論から言うと、MathIsValidNumberは、使える実数かどうかを、真か偽で答える関数です。MathClassifyは、実数の種類を、列挙型の値で細かく返す関数です。どちらも、引数はdouble型の値を1つ受け取ります。
また、確認した公式ページに書かれていない点もありました。たとえば、float型など別の型の形、列挙型の数値そのもの、正規数の範囲の両端を含むかどうかです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、5つの種類の意味、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
MathIsValidNumberとMathClassifyは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。見ている対象は同じ実数ですが、答えの細かさが違います。
MathIsValidNumberは、使える数かどうかを真偽で返す関数である
MathIsValidNumberの形は、bool MathIsValidNumber(double number) です。引数のnumberは、確かめたい数値で、公式では「Checked numeric value」と説明されています。
公式には、実数としてきちんとした値なら真を返し、プラスやマイナスの無限大、または非数(NaN)なら偽を返す、と書かれています。説明の一文は、実数の正しさを確かめる関数、というものです。
- 引数は、確かめたいdouble型の値を1つ
- 戻り値は、真か偽
- 無限大と非数のとき、偽が返る
- float型など、ほかの型の形は、記載なし
MathClassifyは、実数の種類を列挙型で返す関数である
MathClassifyの形は、ENUM_FP_CLASS MathClassify(double value) です。引数のvalueは、種類を調べたい実数で、公式では「The real number to be checked」と説明されています。
戻り値は、ENUM_FP_CLASSという列挙型の値です。公式には、実数の種類を判定して、その結果を、この列挙型の値として返す、と書かれています。注意書きの欄は、ありません。
- 引数は、種類を調べたいdouble型の値を1つ
- 戻り値は、ENUM_FP_CLASSの値
- 種類は、全部で5つ
- 列挙型の数値そのものは、記載なし
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | MathIsValidNumber | MathClassify |
|---|---|---|
| 戻り値 | 真か偽(bool) | 種類(ENUM_FP_CLASS) |
| 引数 | double型を1つ | double型を1つ |
| 無限大と非数の区別 | できない(どちらも偽) | できる |
| 細かさ | 2択 | 5択 |
| float型などの形 | 記載なし | 記載なし |
| 注意書きの欄 | なし | なし |
※公式の説明をもとにした、筆者の整理です。
MathClassifyが返す5つの種類は、何を表すのか?
MathClassifyの特徴は、実数を5つの種類に分けて返すことです。公式のページには、それぞれの意味が、表で書かれています。
5つの種類を、一覧で整理する
公式の表の内容を、短くまとめます。数値の例は、公式の説明にあるものです。
| 種類 | 意味(公式の説明) |
|---|---|
| FP_SUBNORMAL | 最小の正規数DBL_MINより、0に近い非正規数 |
| FP_NORMAL | DBL_MIN以上、最大値までの範囲にある正規数 |
| FP_ZERO | プラスまたはマイナスの0 |
| FP_INFINITE | 型で表せない数で、プラスまたはマイナスの無限大 |
| FP_NAN | 非数 |
※公式の説明をもとにした、筆者の整理です。
公式には、DBL_MINの値が2.2250738585072014e-308、正規数の上限が1.7976931348623158e+308と書かれています。ただし、これらの境目の値を含むかどうかは、記載がありません。
- 非正規数は、DBL_MINより小さい数
- 正規数は、DBL_MINから最大値までの範囲
- 0は、プラスもマイナスも1つの種類
- 無限大も、プラスとマイナスで1つの種類
MathIsValidNumberとの関係を読み取る
MathIsValidNumberは、無限大と非数で偽を返すと書かれています。MathClassifyの5つの種類のうち、この2つに当たるのは、FP_INFINITEとFP_NANです。
公式のサンプルの出力を見ると、正規数、非正規数、0のときには、MathIsValidNumberが真を返しています。非正規数で真になる点は、ページの説明文には書かれておらず、サンプルの出力から読み取れる内容です。
| 種類 | MathIsValidNumberの結果(サンプルの出力) |
|---|---|
| FP_NAN | 偽 |
| FP_INFINITE | 偽 |
| FP_NORMAL | 真 |
| FP_SUBNORMAL | 真 |
| FP_ZERO | 真 |
※公式サンプルの出力コメントをもとにした、筆者の整理です。
書かれていない点は、自分で確かめる
このほか、確認した公式ページには、書かれていない点がいくつかありました。使う前に、自分の環境で確かめておくと安心です。
- float型など、double型以外の形:記載なし
- 列挙型の数値そのもの:記載なし
- インクルードの要否や必要なビルド:記載なし
- マイナスの0を区別するかどうか:記載なし
マイナスの0は、サンプルでは、FP_ZEROとして出力されています。ただし、符号が区別されるかどうかについての説明は、ページにはありません。
公式サンプルは、どう読めばよいのか?
2つの関数のサンプルは、どちらも短い作りです。MathIsValidNumberは数行、MathClassifyは5つのケースを並べた形になっています。
MathIsValidNumberのサンプルは、範囲外の値を確かめている
MathIsValidNumberのサンプルは、MathArcsinに2.0を渡した結果を変数に入れ、それが使える数でなければ、注意の文を表示する、という作りです。
MathArcsinは、入力が-1から1の範囲を外れると、非数を返す関数です。そのため、このサンプルは、範囲外の入力で非数が返る場面を想定した例だと読めます。ただし、出力例はページに書かれていません。
- MathArcsinに、範囲外の2.0を渡す
- 結果が使える数でなければ、注意を表示
- 出力例は、記載なし
MathArcsinの仕組みは、MathArctanとMathArctan2の記事の中でも、少し触れています。範囲外のときの動きについても、あわせて確認できます。
MathClassifyのサンプルは、5つのケースを並べている
MathClassifyのサンプルでは、非数、無限大、通常の数、非正規数、0の5つを用意し、それぞれの種類と、MathIsValidNumberの結果を、並べて表示します。
| ケース | 用意した値 | 種類 | MathIsValidNumber |
|---|---|---|---|
| 非数 | 文字列のnanから変換 | FP_NAN | 偽 |
| 無限大 | 文字列のinfから変換 | FP_INFINITE | 偽 |
| 通常の数 | 1.2345e6 | FP_NORMAL | 真 |
| 非正規数 | DBL_MINを2で割った値 | FP_SUBNORMAL | 真 |
| 0 | 0.0を-1で割った値 | FP_ZERO | 真 |
※公式サンプルのコメントの出力をもとにした、筆者の整理です。
出力は、ページ内の、ブロックコメントとして載っています。実際に実行した結果ではなく、ページに書かれている内容です。
サンプルの読み取りで注意したい点がある
MathClassifyのサンプルでは、0.0を-1で割った値が、マイナスの0として、「-0」と出力されています。ただし、なぜマイナスの符号が付くのかは、ページには説明がありません。
- 0.0を-1で割った値が、-0と出力される
- 符号が付く理由は、記載なし
- 種類としては、FP_ZEROになる
計算の結果が、まれに非数や無限大になる場面については、MathSinとMathCosの記事でも、記載のない点として整理しています。使う前に、値の確認を挟む考え方は、共通しています。
どう使い分ければよいのか?
使える数かどうかだけ分かればよいなら、MathIsValidNumberです。理由まで細かく知りたいなら、MathClassifyを選びます。目的に合わせて選びます。
使えるかどうかだけを知りたいなら、MathIsValidNumberを選ぶ
計算結果を、先へ進める前に、問題がないか確かめたいだけなら、MathIsValidNumberが手軽です。戻り値が真か偽だけなので、条件分岐に、そのまま使えます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
理由まで知りたいなら、MathClassifyを選ぶ
非数なのか、無限大なのかで、対応を分けたいときは、MathClassifyを選びます。種類ごとに、処理や表示を変えられます。ログに種類の名前を残したい場合にも向いています。
- 非数と無限大を、区別したい
- 種類の名前を、ログに残したい
- 0やとても小さい数も、区別したい
サンプルでは、EnumToStringで種類の名前を文字にして表示しています。ログに残すときの参考になります。ただし、ほかの使い方については、ページには書かれていません。
2つを組み合わせて使う方法もある
公式のサンプルのように、種類と、使えるかどうかを、並べて確認する方法もあります。まず、MathIsValidNumberで大まかに確かめ、偽のときだけ、MathClassifyで理由を調べる流れも考えられます。
これは、公式の説明そのものではなく、筆者の整理した使い方です。実際に組み込むときは、自分の環境で動きを確かめてから使ってください。
- まず、MathIsValidNumberで確かめる
- 偽のときだけ、MathClassifyで種類を調べる
- 動きは、自分の環境で確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、簡単な値を使って、スクリプトで確かめるのが安心です。
まずは、公式サンプルと同じ5つの値で確かめる
最初は、公式サンプルと同じ、5つの値を使います。非数、無限大、通常の数、非正規数、0について、種類と真偽が、ページの出力どおりになるかを、自分の目で確かめます。
- 5つの値を用意する
- 種類と真偽を並べて表示する
- ページの出力と見比べる
次に、自分の計算結果で確かめる
次に、自分のコードで計算した結果を渡して、使える数になっているかを確かめます。範囲外の入力で、非数になる関数を使う場合に、特に役に立ちます。
- 自分の計算結果を渡す
- 真偽を表示する
- 偽なら、種類も表示する
最後に、対応方法を決めておく
使えない数が見つかったときに、どう扱うかも、先に決めておくと安心です。処理を止めるのか、値を飛ばすのかは、自分のコードの目的に合わせて決めます。公式のページには、対応方法の説明は、ありません。









- まず、公式サンプルと同じ5つの値で確かめる
- 次に、自分の計算結果で確かめる
- 最後に、対応方法を決めておく
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
非数と無限大は、MathIsValidNumberで区別できるのか?
公式には、どちらの場合も偽を返す、と書かれています。区別したいときは、種類を返すMathClassifyを使います。
- MathIsValidNumberは、どちらも偽
- 区別するなら、MathClassify
0や、とても小さい数は、使えない数なのか?
公式サンプルの出力では、0も非正規数も、MathIsValidNumberが真を返しています。ただし、これはサンプルの出力から読み取れる内容で、ページの説明文には、書かれていません。
- 0は、真と出力されている
- 非正規数も、真と出力されている
- 説明文には、記載なし
float型の値も、渡せるのか?
公式に載っている形は、double型のものだけです。float型など、ほかの型の形は、記載がありません。自分の環境で確かめてから使うと安心です。
- 公式の形は、double型のみ
- ほかの型は、記載なし
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のMathIsValidNumberとMathClassify、使える数かどうかをはい・いいえで答える手軽さと種類まで細かく分けて返す詳しさどっちを使う?」
使えるかどうかだけならMathIsValidNumber、種類まで知りたいならMathClassifyです。記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










