Namespaces
Variants

isnan

From cppreference.net
< c ‎ | numeric ‎ | math
Common mathematical functions
Functions
Basic operations
(C99)
(C99)
(C99)
(C99) (C99) (C99) (C23)
Maximum/minimum operations
Exponential functions
Power functions
Trigonometric and hyperbolic functions
Nearest integer floating-point
(C99) (C99) (C99)
(C23) (C23) (C23) (C23)
Floating-point manipulation
Narrowing operations
(C23)
(C23)
(C23)
(C23)
(C23)
(C23)
Quantum and quantum exponent
Decimal re-encoding functions
Total order and payload functions
Classification
Error and gamma functions
(C99)
(C99)
(C99)
(C99)
Types
Macro constants
Special floating-point values
Arguments and return values
Error handling
Fast operation indicators
定義済みヘッダー <math.h>
#define isnan(arg) /* implementation defined */
(C99以降)

与えられた浮動小数点数 arg が非数(NaN)値であるかどうかを判定します。このマクロは整数値を返します。

FLT_EVAL_METHOD は無視されます:引数がその型よりも広い範囲や精度で評価された場合でも、まずその意味的な型に変換され、分類はそれに基づいて行われます(これは、評価型がNaNをサポートしているが、意味的な型がサポートしていない場合に重要です)。

目次

パラメータ

arg - 浮動小数点値

戻り値

arg が NaN の場合、非ゼロの整数値、 0 それ以外の場合。

注記

異なる符号ビットとペイロードを持つ多くの異なるNaN値が存在します。詳細は nan を参照してください。

NaN値はそれ自体または他のNaN値と決して等しく比較されません。NaNのコピーはそのビットパターンを変更する可能性があります。

浮動小数点値がNaNであるかどうかをテストする別の方法は、それを自分自身と比較することです: bool is_nan ( double x ) { return x ! = x ; }

#include <float.h>
#include <math.h>
#include <stdio.h>
int main(void)
{
    printf("isnan(NAN)         = %d\n", isnan(NAN));
    printf("isnan(INFINITY)    = %d\n", isnan(INFINITY));
    printf("isnan(0.0)         = %d\n", isnan(0.0));
    printf("isnan(DBL_MIN/2.0) = %d\n", isnan(DBL_MIN / 2.0));
    printf("isnan(0.0 / 0.0)   = %d\n", isnan(0.0 / 0.0));
    printf("isnan(Inf - Inf)   = %d\n", isnan(INFINITY - INFINITY));
}

出力例:

isnan(NAN)         = 1
isnan(INFINITY)    = 0
isnan(0.0)         = 0
isnan(DBL_MIN/2.0) = 0
isnan(0.0 / 0.0)   = 1
isnan(Inf - Inf)   = 1

参考文献

  • C23規格 (ISO/IEC 9899:2024):
  • 7.12.3.4 isnanマクロ (p: TBD)
  • C17規格 (ISO/IEC 9899:2018):
  • 7.12.3.4 isnanマクロ (p: TBD)
  • C11規格 (ISO/IEC 9899:2011):
  • 7.12.3.4 isnanマクロ (p: 236-237)
  • C99規格 (ISO/IEC 9899:1999):
  • 7.12.3.4 isnanマクロ (p: 217)

関連項目

(C99) (C99) (C99)
NaN(非数)を返す
(関数)
指定された浮動小数点値を分類する
(関数マクロ)
指定された数値が有限値を持つかどうかをチェックする
(関数マクロ)
(C99)
指定された数値が無限大かどうかをチェックする
(関数マクロ)
指定された数値が正規化数かどうかをチェックする
(関数マクロ)
2つの浮動小数点値が非順序かどうかをチェックする
(関数マクロ)