Namespaces
Variants

    fpclassify

    From ja.cppreference.net
    < c ‎ | numeric ‎ | math
    C
    Numerics
    Common mathematical functions
    Functions
    Basic operations
    (C99)
    (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) (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
    fpclassify
    (C99)
    (C23)
    (C99)
    (C99)
    (C99)
    (C99)
    (C99)
    (C23)
    (C23)
    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 fpclassify(arg) /* implementation defined */
    		(C99以降)

    浮動小数点値 arg を以下のカテゴリに分類します：ゼロ、非正規化数、正規化数、無限大、NAN、または実装定義のカテゴリ。このマクロは整数値を返します。

    FLT_EVAL_METHOD は無視されます：引数がその型よりも広い範囲や精度で評価された場合でも、まずその意味上の型に変換され、分類はそれに基づいて行われます：通常のlong double値は、doubleに変換されたときに非正規化数になったり、 float に変換されたときにゼロになったりする可能性があります。

    目次

    パラメータ

    arg - 浮動小数点値

    戻り値

    FP_INFINITE 、 FP_NAN 、 FP_NORMAL 、 FP_SUBNORMAL 、 FP_ZERO のいずれか、または実装定義の型で、 arg のカテゴリを指定します。

    例

    このコードを実行 
    #include <float.h>
#include <math.h>
#include <stdio.h>
const char* show_classification(double x)
{
    switch(fpclassify(x))
    {
        case FP_INFINITE:  return "Inf";
        case FP_NAN:       return "NaN";
        case FP_NORMAL:    return "normal";
        case FP_SUBNORMAL: return "subnormal";
        case FP_ZERO:      return "zero";
        default:           return "unknown";
    }
}
int main(void)
{
    printf("1.0/0.0 is %s\n", show_classification(1 / 0.0));
    printf("0.0/0.0 is %s\n", show_classification(0.0 / 0.0));
    printf("DBL_MIN/2 is %s\n", show_classification(DBL_MIN / 2));
    printf("-0.0 is %s\n", show_classification(-0.0));
    printf("1.0 is %s\n", show_classification(1.0));
}

    出力: 

    1.0/0.0 is Inf
0.0/0.0 is NaN
DBL_MIN/2 is subnormal
-0.0 is zero
1.0 is normal

    参考文献

    • C23規格 (ISO/IEC 9899:2024):
    • 7.12.3.1 fpclassifyマクロ (p: TBD)
    • C17規格 (ISO/IEC 9899:2018):
    • 7.12.3.1 fpclassifyマクロ (p: TBD)
    • C11規格 (ISO/IEC 9899:2011):
    • 7.12.3.1 fpclassifyマクロ (p: 235)
    • C99規格 (ISO/IEC 9899:1999):
    • 7.12.3.1 fpclassifyマクロ (p: 216)

    関連項目

    (C99)
    		指定された数値が有限値かどうかをチェックする
    (関数マクロ)
    (C99)
    		指定された数値が無限大かどうかをチェックする
    (関数マクロ)
    (C99)
    		指定された数値がNaNかどうかをチェックする
    (関数マクロ)
    (C99)
    		指定された数値が正規化数かどうかをチェックする
    (関数マクロ)
    C++ documentation for fpclassify