C#のMathF.IEEERemainder()メソッドとは？使い方をサンプルコード付きで解説

C#のMathF.IEEERemainder()メソッドは、指定された数値（被除数）を別の数値（除数）で除算した際の剰余を、IEEE 754規格に準拠した形で返します。通常の剰余演算子「%」とは計算結果が異なる場合があるため、用途に応じて使い分けることが重要です。

構文

MathF.IEEERemainder()メソッドの構文は以下のとおりです。

public static float IEEERemainder(float dividend, float divisor);

パラメータ

• dividend：割られる数（被除数）
• divisor：割る数（除数）

戻り値

IEEE 754規格に基づいて計算された剰余がfloat型で返されます。

使用例1

それでは、MathF.IEEERemainder()メソッドを使った基本的な実装例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        float val1 = 90.5f;
        float val2 = 13.5f;
        float rem = MathF.IEEERemainder(val1, val2);
        Console.WriteLine(rem);
    }
}

出力

上記のコードを実行すると、次の出力が得られます。

-4

この例では、90.5を13.5で除算した際のIEEE 754準拠の剰余として「-4」が返されています。通常の%演算子では正の値になるケースでも、IEEERemainderでは負の値になることがあります。

使用例2

続いて、別の例を確認してみましょう。

using System;
public class Demo {
    public static void Main(){
        float val1 = 0.0f;
        float val2 = 1.0f;
        float rem = MathF.IEEERemainder(val1, val2);
        Console.WriteLine(rem);
    }
}

出力

上記のコードを実行すると、次の出力が得られます。

0

0.0を1.0で除算した場合、剰余は当然ながら「0」となります。

まとめ

MathF.IEEERemainder()メソッドを使用すると、IEEE 754規格に準拠した剰余を簡単に求めることができます。このメソッドは、商が最も近い整数になるように結果が調整されるため、通常の%演算子とは符号や値が異なるケースがある点に注意してください。浮動小数点数の精密な剰余計算が必要な場面で活用するとよいでしょう。