fpclassify

类型

div_tldiv_tlldiv_timaxdiv_t (C99)(C99)

float_tdouble_t (C99)(C99)
_Decimal32_t_Decimal64_t (C23)(C23)

函数

基本操作

abslabsllabsimaxabs (C99)(C99)
fabs
divldivlldivimaxdiv (C99)(C99)

fmod
remainder (C99)
remquo (C99)
fma (C99)
fdim (C99)
nannanfnanlnandN (C99)(C99)(C99)(C23)

最大值/最小值操作

fmax (C99)
fmaximum (C23)
fmaximum_mag (C23)
fmaximum_num (C23)
fmaximum_mag_num (C23)

fmin (C99)
fminimum (C23)
fminimum_mag (C23)
fminimum_num (C23)
fminimum_mag_num (C23)

指数函数

exp
exp10 (C23)
exp2 (C99)
expm1 (C99)
exp10m1 (C23)
exp2m1 (C23)

log
log10
log2 (C99)
log1plogp1 (C99)(C23)
log10p1 (C23)
log2p1 (C23)

幂函数

sqrt
cbrt (C99)
rootn (C23)
rsqrt (C23)

hypot (C99)
compound (C23)
pow
pown (C23)
powr (C23)

三角函数和双曲函数

sin
cos
tan
asin
acos
atan
atan2
sinpi (C23)
cospi (C23)
tanpi (C23)

asinpi (C23)
acospi (C23)
atanpi (C23)
atan2pi (C23)
sinh
cosh
tanh
asinh (C99)
acosh (C99)
atanh (C99)

误差函数和伽马函数

erf (C99)
erfc (C99)

lgamma (C99)
tgamma (C99)

最接近整数的浮点运算

ceil
floor
roundlroundllround (C99)(C99)(C99)
roundeven (C23)
trunc (C99)

nearbyint (C99)
rintlrintllrint (C99)(C99)(C99)
fromfpfromfpxufromfpufromfpx (C23)(C23)(C23)(C23)

浮点操作函数

ldexp
frexp
scalbnscalbln (C99)(C99)
ilogbllogb (C99)(C23)
logb (C99)

modf
nextafternexttoward (C99)(C99)
nextupnextdown (C23)(C23)
copysign (C99)
canonicalize (C23)

缩窄操作

fadd (C23)
fsub (C23)
fmul (C23)

fdiv (C23)
ffma (C23)
fsqrt (C23)

量子和量子指数函数

quantizedN (C23)
samequantumdN (C23)

quantumdN (C23)
llquantexpdN (C23)

十进制重新编码函数

encodedecdN (C23)
decodedecdN (C23)

encodebindN (C23)
decodebindN (C23)

全序和有效载荷函数

totalorder (C23)
getpayload (C23)

setpayload (C23)
setpayloadsig (C23)

分类

fpclassify (C99)
iscanonical (C23)
isfinite (C99)
isinf (C99)
isnan (C99)
isnormal (C99)
signbit (C99)
issubnormal (C23)
iszero (C23)

isgreater (C99)
isgreaterequal (C99)
isless (C99)
islessequal (C99)
islessgreater (C99)
isunordered (C99)
issignaling (C23)
iseqsig (C23)

宏常量

特殊浮点值

HUGE_VALFHUGE_VALHUGE_VALLHUGE_VALDN

(C99)(C99)(C23)

INFINITYDEC_INFINITY (C99)(C23)
NANDEC_NAN (C99)(C23)

参数和返回值

FP_ILOGB0FP_ILOGBNAN (C99)(C99)
FP_INT_UPWARDFP_INT_DOWNWARDFP_INT_TOWARDZEROFP_INT_TONEARESTFROMZEROFP_INT_TONEAREST (C23)(C23)(C23)(C23)(C23)

FP_LLOGB0FP_LLOGBNAN (C23)(C23)
FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99)(C99)(C99)(C99)(C99)

错误处理

MATH_ERRNOMATH_ERRNOEXCEPT

(C99)(C99)

math_errhandling (C99)

快速操作指示器

FP_FAST_FMAFFP_FAST_FMA (C99)(C99)
FP_FAST_FADDFP_FAST_FADDLFP_FAST_DADDLFP_FAST_DMADDDN (C23)(C23)(C23)(C23)
FP_FAST_FMULFP_FAST_FMULLFP_FAST_DMULLFP_FAST_DMMULDN (C23)(C23)(C23)(C23)
FP_FAST_FFMAFP_FAST_FFMALFP_FAST_DFMALFP_FAST_DMFMADN (C23)(C23)(C23)(C23)

FP_FAST_FMALFP_FAST_FMADN (C99)(C23)
FP_FAST_FSUBFP_FAST_FSUBLFP_FAST_DSUBLFP_FAST_DMSUBDN (C23)(C23)(C23)(C23)
FP_FAST_FDIVFP_FAST_FDIVLFP_FAST_DDIVLFP_FAST_DMDIVDN (C23)(C23)(C23)(C23)
FP_FAST_FSQRTFP_FAST_FSQRTLFP_FAST_DSQRTLFP_FAST_DMSQRTDN (C23)(C23)(C23)(C23)

[编辑]

在头文件 `<math.h>` 中定义
#define fpclassify(arg) /* 实现定义 */		(自 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)

[编辑] 另请参阅

isfinite (C99)	检查给定数字是否具有有限值 (函数宏) [编辑]
isinf (C99)	检查给定数字是否为无穷大 (函数宏) [编辑]
isnan (C99)	检查给定数字是否为 NaN (函数宏) [编辑]
isnormal (C99)	检查给定数字是否为正规数 (函数宏) [编辑]
C++ 文档 for fpclassify

编译器支持
语言
头文件
类型支持
程序实用工具
可变参数函数支持
错误处理
动态内存管理
字符串库
算法
数值
日期和时间实用工具
输入/输出支持
本地化支持
并发支持 (C11)
技术规范
符号索引

常用数学函数
浮点环境 (C99)
伪随机数生成
复数运算 (C99)
类型通用数学 (C99)

cppreference.com

命名空间

变体

视图

操作