この記事を開いてくださったこと、心から感謝しています。小数を整数にそろえたいとき、下の整数にするのか、上の整数にするのか、迷っている人も、きっと多いはずです。
結論から言うと、小数以下を下へそろえたいときはMathFloor、上へそろえたいときはMathCeilです。公式サンプルでは、0.1のときに、MathFloorは0、MathCeilは1を返しています。
また、確認した公式ページに書かれていない点もありました。たとえば、マイナスの数を渡したときの動きや、桁が非常に大きい数の扱いです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
MathFloorとMathCeilは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも引数はdouble型の数がひとつで、整数の値にそろえる関数です。
MathFloorは、下側の最も近い整数を返す関数である
MathFloorは、渡した数以下で、いちばん大きい整数を返します。公式では「下から最も近い整数」と説明されています。戻り値の型は、double型です。
公式サンプルでは、0.1から3.1まで0.1ずつ増やした数を渡しています。0.1から0.9までは0、1.0から1.9までは1、2.0から2.9までは2、3.0と3.1は3が表示されます。
- 引数は、double型の数がひとつ
- 戻り値は、渡した数以下で最大の整数
- 0.1から0.9までは、0になる
つまり、MathFloorは、数直線の上で、左側にあるいちばん近い整数を選ぶ関数と考えると、イメージしやすくなります。公式の文章に、この説明はありませんが、定義の言い換えとして理解できます。
MathCeilは、上側の最も近い整数を返す関数である
MathCeilは、渡した数以上で、いちばん小さい整数を返します。公式では「上から最も近い整数」と説明されています。戻り値の型は、こちらもdouble型です。
同じ条件のサンプルでは、0.1から1.0までは1、1.1から2.0までは2、2.1から3.0までは3、3.1は4と表示されます。ちょうど整数のときは、その整数がそのまま返ります。
- 引数は、double型の数がひとつ
- 戻り値は、渡した数以上で最小の整数
- 整数のときは、そのままの値
同じ考え方で、MathCeilは、数直線の上で、右側にあるいちばん近い整数を選ぶ関数です。2つは、鏡のような関係になっていて、小数の部分があるときだけ、結果が1だけ違います。
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | MathFloor | MathCeil |
|---|---|---|
| そろえる向き | 下の整数 | 上の整数 |
| 0.1を渡したとき | 0 | 1 |
| 3.1を渡したとき | 3 | 4 |
| マイナスの数 | 記載なし | 記載なし |
| エラーコード | 記載なし | 記載なし |
※公式の説明とサンプルをもとにした、筆者の整理です。
MathFloorは、どんな場面で使うのか?
MathFloorは、小数の部分を下へそろえたいときの選択肢です。公式の説明から、動き方を確認します。
0.1も0.9も、同じ0になる
サンプルの結果を見ると、0.1から0.9までは、すべて0になります。小数の部分がどれだけあっても、下の整数にそろうという動きです。
公式の文には、別の書き方として、floorという名前でも使えるという注記があります。どちらを使っても、同じ関数として扱われると読み取れます。
- 小数の部分は、下へそろう
- 0.1も0.9も、結果は0
- floorという名前でも書ける
戻り値はdouble型なので、整数型で使うなら変換が必要になる
関数の形では、戻り値はdouble型です。サンプルでは、結果を整数型に変換してから、表示しています。変換が必須なのかどうかは、公式には説明がありません。
なお、サンプルでは、渡す前にNormalizeDoubleで桁をそろえています。その理由は、公式ページには書かれていません。桁をそろえる関数の使い分けは、NormalizeDoubleとMathRoundの記事で整理しています。
- 戻り値は、double型
- サンプルでは、整数型に変換している
- NormalizeDoubleを使う理由は、記載なし
マイナスの数や、特別な値の扱いは、確認できない
マイナスの数を渡したとき、たとえば-0.5ではどうなるのかは、公式のサンプルにありません。定義は「渡した数以下で最大の整数」なので、考え方は読み取れますが、結果は書かれていません。
非数や、無限大、桁が非常に大きい数のときの動きも、記載なしです。外から受け取った数を渡すときは、事前に範囲を確かめておくと安心です。
- マイナスの数の結果は、記載なし
- 非数や無限大は、記載なし
- 大きすぎる数は、記載なし
公式ページの説明は短く、サンプルも正の小数だけです。そのため、この記事で書いた内容は、公式に載っている範囲に限っています。範囲の外は、自分の環境で試した結果を、記録して使うのが安心です。
MathCeilは、どんな場面で使うのか?
MathCeilは、小数の部分を上へそろえたいときの選択肢です。公式の説明から、動き方を確認します。
0.1も1.0も、同じ1になる
サンプルの結果を見ると、0.1から1.0までは、すべて1になります。わずかでも小数の部分があれば、上の整数に進むという動きです。
MathFloorと同じく、ceilという名前でも使えるという注記があります。整数ちょうどの値は、そのまま同じ整数が返ります。
- 小数の部分は、上へそろう
- 0.1も1.0も、結果は1
- ceilという名前でも書ける
きれいに割り切れない数のときは、桁をそろえてから渡している
サンプルでは、0.1を何度も足した値を使っています。この足し方では、小数の誤差が出る可能性があるため、サンプルは、NormalizeDoubleで桁をそろえてから渡していると考えられます。
ただし、これは筆者の読み取りで、公式には理由が書かれていません。誤差が出たときの動きを確かめたいときは、自分の環境で試してください。
- サンプルは、桁をそろえてから渡している
- 理由は、公式には記載なし
- 誤差の動きは、自分で試す
MathFloorと同じく、特別な値や範囲は確認できない
MathCeilも、マイナスの数、非数、無限大、非常に大きい数については、記載なしです。エラーコードを取得できるのかどうかも、書かれていません。
- マイナスの数は、記載なし
- 非数や無限大は、記載なし
- エラーコードは、記載なし
2つの関数は、書き方も、引数の数も同じです。そのため、片方の仕様を理解できれば、もう片方も、同じ手順で確かめられます。
どう使い分ければよいのか?
下へそろえたいならMathFloor、上へそろえたいならMathCeilです。四捨五入のように、近いほうへそろえたいときは、別の関数が候補になります。
下へそろえたいなら、MathFloorを選ぶ
小数の部分を、常に下へそろえたいなら、MathFloorが向いています。0.9のようにほぼ1に近い数でも、結果は0になる点を、あらかじめ知っておく必要があります。
FX口座・ツールの比較一覧もあわせて確認してみてください。
たとえば、10.0のように、小数の部分がちょうど0の数なら、MathFloorもMathCeilも、同じ10を返します。違いが出るのは、小数の部分があるときだけです。
上へそろえたいなら、MathCeilを選ぶ
小数の部分が少しでもあれば、上へ進めたいなら、MathCeilが向いています。0.1のようにわずかな小数でも、結果は1になります。
- 上の整数にそろえたい
- 0.1でも、結果は1
- 整数ちょうどは、そのまま
どちらの向きが合うかは、使う場面で決まります。迷ったときは、結果が1ずれたときに、どちらの間違いのほうが困らないかを考えて、選ぶのもひとつの方法です。
近いほうへそろえたいなら、別の関数を検討する
2つの公式ページの本文には、四捨五入のような関数の説明は出てきません。近いほうの整数にそろえたい場合は、MathRoundなど別の関数を、あわせて確認する必要があります。
- 下へそろえるのは、MathFloor
- 上へそろえるのは、MathCeil
- 近いほうは、別の関数を確認する
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、短い数を使って確かめるのが安心です。
まずは、公式サンプルと同じ数で試す
最初は、0.1から3.1まで0.1ずつ増やした数を、2つの関数に渡して、結果を並べて表示します。0.1、1.0、3.1あたりの結果の違いを、自分の目で確かめます。
- 同じ数を、2つの関数に渡す
- 結果を、ログに表示する
- 0.1、1.0、3.1の違いを見る
次に、書かれていない数を試す
次に、-0.5や-1.2のようなマイナスの数や、とても大きい数を渡して、結果を記録します。公式に書かれていない部分なので、自分の環境での結果が、そのまま判断材料になります。
- マイナスの数を渡す
- とても大きい数を渡す
- 結果を、メモに残す
特に、マイナスの数は、下へそろえるという言葉の感覚と、結果が食い違いやすい部分です。思い込みで書かず、必ず実際の出力で確かめましょう。
最後に、使う場面に合う向きを決める
最後に、実際に使う場面で、下へそろえるのか、上へそろえるのかを決めます。向きを間違えると、結果が1ずれるため、小さな数で必ず確認しておきましょう。









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










