閉じる

C#でdouble.IsNaNを使って非数（NaN）を正しく判定する方法と注意点

広告

C#で数値計算を伴うプログラムを開発していると、計算結果が期待通りにならないケースに遭遇することがあります。

特に浮動小数点数（doubleやfloat）を扱う場合、ゼロ除算や不正な演算の結果として「非数（NaN: Not a Number）」が発生することがあります。

このNaNは非常に特殊な性質を持っており、通常の比較演算子では正しく判定することができません。

本記事では、C#でNaNを判定するための標準的な手法であるdouble.IsNaNの使い方から、実務で役立つ注意点までを詳しく解説します。

2026年現在の.NET環境においても、数値演算の堅牢性を高めるためにこの知識は欠かせない要素となっています。

目次 [ close ]
  1. NaN（非数）とは何か？
  2. なぜ「==」演算子では判定できないのか
  3. double.IsNaNメソッドの基本的な使い方
    1. 単一の値に対する判定
    2. float（単精度浮動小数点数）の場合
  4. コレクションとNaNの挙動の違い
  5. ジェネリック数学（Generic Math）におけるNaN判定
  6. NaNを判定する際の注意点とベストプラクティス
    1. IsFiniteメソッドとの併用
    2. データベースのNULLとの違い
    3. JSONシリアライズの挙動
  7. まとめ

NaN（非数）とは何か？

NaNは「Not a Number」の略称であり、数学的に定義できない計算結果を表現するために使用されます。

C#のdouble型やfloat型は、IEEE 754という浮動小数点数演算に関する国際規格に準拠しています。

この規格において、計算不能な状態を示す特別な値としてNaNが定義されています。

具体的には、以下のような計算を行った際にNaNが発生します。

  • 0.0 を 0.0 で除算する。
  • 無限大（Infinity）から無限大を引く。
  • 負の数に対して平方根（Math.Sqrt）を求める。
  • 無限大に 0 を掛ける。

これらの計算は例外（Exception）をスローするのではなく、値としてNaNを返却するため、プログラムが止まらずに計算が継続されてしまう点に注意が必要です。

なぜ「==」演算子では判定できないのか

NaNの最も特徴的かつ厄介な性質は、「自分自身を含め、どの値とも等しくない」という点です。

通常、ある変数 x が double.NaN であるかを確認しようとして x == double.NaN と記述したくなりますが、これは常に false を返します。

以下のコードでその挙動を確認してみましょう。

C#
// NaNの発生
double value = 0.0 / 0.0;

// 直接比較の罠
if (value == double.NaN)
{
    Console.WriteLine("これは表示されません。");
}

// 自分自身との比較
if (value != value)
{
    Console.WriteLine("NaNは自分自身とも等しくありません。");
}
実行結果
NaNは自分自身とも等しくありません。

このように、== 演算子による比較は意図した通りに機能しません。

この性質は、プログラミング初心者が陥りやすいミスの一つとして知られています。

そのため、C#では専用の判定メソッドである double.IsNaN が用意されています。

double.IsNaNメソッドの基本的な使い方

NaNを安全かつ確実に判定するためには、double.IsNaN 静的メソッドを使用します。

このメソッドは、引数に渡された値がNaNである場合にのみ true を返します。

単一の値に対する判定

最も基本的な使い方は、if 文などの条件式で直接呼び出す方法です。

C#
double result = Math.Sqrt(-1.0); // 負の数の平方根はNaN

if (double.IsNaN(result))
{
    Console.WriteLine("計算結果は非数（NaN）です。");
}
else
{
    Console.WriteLine($"計算結果は {result} です。");
}
実行結果
計算結果は非数（NaN）です。

このメソッド内部では、ビットパターンのチェックが行われており、IEEE 754規格に基づいた正確な判定が保証されています。

float（単精度浮動小数点数）の場合

float 型を扱っている場合は、同様に float.IsNaN メソッドを使用します。

double.IsNaN に float を渡すと暗黙的にキャストされますが、基本的には型に合わせたメソッドを使用するのがベストプラクティスです。

コレクションとNaNの挙動の違い

NaNの扱いで注意が必要なのは、== 演算子と Equals メソッドで挙動が異なる場合がある点です。

これは、List<T> や Dictionary<TKey, TValue> などのコレクションで要素を検索する際に影響します。

比較方法NaN vs NaN の結果主な用途
== 演算子false一般的な数値比較
double.IsNaN()true正確なNaN判定
object.Equals()trueコレクション内の同一性確認
EqualityComparer<double>.Defaulttrueジェネリックな比較

例えば、List<double>.Contains(double.NaN) を呼び出すと、内部では Equals 系のメソッドが使用されるため、true が返されます。

一方で、独自のループで == を使って検索すると false になり、バグの原因となります。

混乱を避けるためにも、明示的な判定には必ず double.IsNaN を使うよう徹底しましょう。

ジェネリック数学（Generic Math）におけるNaN判定

現代的なC#（.NET 7以降、および2026年現在の最新バージョン）では、ジェネリック数学（Generic Math）が広く普及しています。

特定の型（doubleやfloat）に依存せず、数値型全般を扱うライブラリを作成する場合、INumberBase<TSelf> インターフェースの静的抽象メンバーを利用できます。

C#
using System.Numerics;

public static void CheckIsNumber<T>(T value) where T : INumberBase<T>
{
    if (T.IsNaN(value))
    {
        Console.WriteLine($"{typeof(T).Name} 型の値は NaN です。");
    }
    else
    {
        Console.WriteLine($"{typeof(T).Name} 型の値は有効な数値または無限大です。");
    }
}

// 呼び出し例
CheckIsNumber(double.NaN);
CheckIsNumber(float.NaN);

このように記述することで、double.IsNaN や float.IsNaN を個別に呼び出す必要がなくなり、コードの再利用性が大幅に向上します。

2026年の開発現場では、高度な計算モジュールを設計する際にこの手法が標準的に用いられています。

NaNを判定する際の注意点とベストプラクティス

double.IsNaN を活用する上で、知っておくべき周辺知識がいくつかあります。

IsFiniteメソッドとの併用

数値が「計算可能な有効な範囲内であるか」を一括で確認したい場合は、double.IsFinite メソッドが便利です。

IsFinite は、値が NaN でもなく、かつ無限大（Infinity）でもない 場合に true を返します。

バリデーション処理では、!double.IsNaN(val) と書くよりも double.IsFinite(val) と書くほうが、意図が明確になる場合が多いです。

データベースのNULLとの違い

SQL Serverなどのデータベースにおける NULL と、C#の double.NaN は概念が異なります。

データベースの NULL は「値が存在しない」ことを示しますが、NaN は「計算結果が定義できない」という状態を示します。

データベースから浮動小数点数を取得する際、値が未入力であることを NaN で表現するか、double?（Nullable型）の null で表現するかは、設計方針によって異なります。

一般的には、欠損値には null を使い、計算エラーの結果には NaN を使うという使い分けが推奨されます。

JSONシリアライズの挙動

Web APIなどで System.Text.Json を使用して NaN を含むオブジェクトをシリアライズする場合、デフォルト設定では例外が発生することがあります。

JSON標準規格では NaN や Infinity が定義されていないためです。

これらを許可するには、JsonSerializerOptions の NumberHandling プロパティを設定する必要があります。

C#
var options = new JsonSerializerOptions
{
    // NaN, Infinity, -Infinity を文字列としてシリアライズすることを許可
    NumberHandling = JsonNumberHandling.AllowNamedFloatingPointLiterals
};

string json = JsonSerializer.Serialize(double.NaN, options);
Console.WriteLine(json); // "NaN" と出力される

まとめ

C#において、浮動小数点数の NaN（非数）は、通常の数値とは異なる特殊なルールに従って動作します。

== 演算子では決して判定できないという性質は、バグの温床になりやすいため、常に double.IsNaN メソッドを使用する習慣をつけましょう。

また、現代的なC#開発では、IsFinite による一括チェックや、ジェネリック数学を用いた抽象的な判定方法も非常に有効です。

計算処理の各ステップで適切に NaN 判定を挟むことにより、予期せぬ計算結果が連鎖して最終的な出力が壊れてしまう事態を防ぐことができます。

本記事で紹介したテクニックを活用し、より堅牢で信頼性の高い数値計算プログラムを実装してください。

URLをコピーしました！