C#のDouble.IsNegativeInfinity()メソッドとは？使い方とサンプルコードを解説

C#のDouble.IsNegativeInfinity()メソッドは、指定された数値が負の無限大（Negative Infinity）と評価されるかどうかを示すbool値を返す静的メソッドです。数値計算において、除算などで発生する無限大の値を判定したい場合に役立ちます。

構文

このメソッドの構文は以下の通りです。

public static bool IsNegativeInfinity (double val);

引数のvalには、判定対象となる倍精度浮動小数点数（double）を指定します。値が負の無限大であればtrue、そうでなければfalseが返されます。

使用例1：NaNの場合

まず、0.0を0で割った結果（NaN）に対してこのメソッドを使用する例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        double d = 0.0/0;
        Console.WriteLine("Double Value = "+d);
        Console.WriteLine("HashCode of Double Value = "+d.GetHashCode());
        TypeCode type = d.GetTypeCode();
        Console.WriteLine("TypeCode of Double Value = "+type);
        Console.WriteLine("Positive Infinity? = "+Double.IsInfinity(d));
        Console.WriteLine("Check whether the specified value is NaN? = "+Double.IsNaN(d));
        Console.WriteLine("Does the value evaluate to negative infinity? = "+Double.IsNegativeInfinity(d));
    }
}

出力結果

上記のコードを実行すると、以下のような出力が得られます。

Double Value = NaN
HashCode of Double Value = -524288
TypeCode of Double Value = Double
Positive Infinity? = False
Check whether the specified value is NaN? = True
Does the value evaluate to negative infinity? = False

この例では、0.0/0の結果は「非数（NaN）」となるため、IsNegativeInfinity()メソッドはFalseを返しています。また、IsNaN()メソッドはTrueを返すことから、この値がNaNであることが確認できます。

使用例2：負の無限大の場合

次に、-1.0を0.0で割った結果（負の無限大）に対してこのメソッドを使用する例を見てみましょう。

using System;
public class Demo {
    public static void Main(){
        double d = -1.0/0.0;
        Console.WriteLine("Double Value = "+d);
        Console.WriteLine("HashCode of Double Value = "+d.GetHashCode());
        TypeCode type = d.GetTypeCode();
        Console.WriteLine("TypeCode of Double Value = "+type);
        Console.WriteLine("Positive Infinity? = "+Double.IsInfinity(d));
        Console.WriteLine("Check whether the specified value is NaN? = "+Double.IsNaN(d));
        Console.WriteLine("Does the value evaluate to negative infinity? = "+Double.IsNegativeInfinity(d));
    }
}

出力結果

上記のコードを実行すると、以下のような出力が得られます。

Double Value = -∞
HashCode of Double Value = -1048576
TypeCode of Double Value = Double
Positive Infinity? = True
Check whether the specified value is NaN? = False
Does the value evaluate to negative infinity? = True

この例では、-1.0/0.0の結果は負の無限大（-∞）となるため、IsNegativeInfinity()メソッドはTrueを返しています。なお、Double.IsInfinity()メソッドは正負どちらの無限大でもTrueを返す点に注意してください。

まとめ

• Double.IsNegativeInfinity()メソッドは、指定したdouble型の値が負の無限大かどうかを判定します。
• 負の無限大の場合はtrue、NaNや通常の数値、正の無限大の場合はfalseを返します。
• 0による除算の結果などを安全にチェックし、エラー処理に活用できます。