nan, nanf, nanl

 

C

语言

头文件

类型支持

动态内存管理

错误处理

程序工具

变参数函数支持

日期和时间工具

字符串库

算法

数值计算

输入/输出支持

本地化支持

线程支持 (C11)

原子操作 (C11)

技术规范

 

数值计算

常用数学函数

浮点环境

复数运算

伪随机数生成

泛型数学

 

常用数学函数

函数
基本运算
abslabsllabsimaxabs (C99) fabs divldivlldivimaxdiv (C99) fmod	remainder (C99) remquo (C99) fma (C99) fmax (C99) fmin (C99) fdim (C99) nannanfnanl (C99) (C99) (C99)
指数函数
exp exp2 (C99) expm1 (C99)	log log10 log1p (C99) log2 (C99)
幂函数
sqrt cbrt (C99)	hypot (C99) pow
三角及双曲函数
sin cos tan asin acos atan atan2	sinh cosh tanh asinh (C99) acosh (C99) atanh (C99)
误差及伽马函数
erf (C99) erfc (C99)	lgamma (C99) tgamma (C99)
临近整数的浮点运算
ceil floor roundlroundllround (C99) (C99) (C99)	trunc (C99) nearbyint (C99) rintlrintllrint (C99) (C99) (C99)
浮点数操作函数
ldexp scalbnscalbln (C99) (C99) ilogb (C99) logb (C99)	frexp modf nextafternexttoward (C99) (C99) copysign (C99)
分类
fpclassify (C99)
isfinite (C99)
isinf (C99)
isnan (C99)
isnormal (C99)
signbit (C99)
宏常量
HUGE_VALFHUGE_VALHUGE_VALL (C99) (C99)	FP_NORMALFP_SUBNORMALFP_ZEROFP_INFINITEFP_NAN (C99) (C99) (C99) (C99) (C99)

 

定义于头文件 <math.h>
float       nanf( const char* arg );		(C99 起)
double      nan( const char* arg );		(C99 起)
long double nanl( const char* arg );		(C99 起)

将实现定义的字符串arg转换到对应的安静NaN值，如同各自通过调用strtof、 strtod或strtold，如下：

调用nan("string")等价于调用strtod("NAN(string)", (char**)NULL);；

调用nan("")等价于调用strtod("NAN()", (char**)NULL);；

调用nan(NULL)等价于调用strtod("NAN", (char**)NULL);。

参数

arg

-

标识NaN内容的窄字符串

返回值

对应标识字符串arg的安静NaN值，或者若实现不支持安静NaN则为零。

示例

运行此代码

#include <stdio.h>
#include <math.h>
#include <stdint.h>
#include <inttypes.h>
#include <string.h>
 
int main(void)
{
    double f1 = nan("1");
    uint64_t f1n; memcpy(&f1n, &f1, sizeof f1);
    printf("nan(\"1\")   = %f (%" PRIx64 ")\n", f1, f1n);
 
    double f2 = nan("2");
    uint64_t f2n; memcpy(&f2n, &f2, sizeof f2);
    printf("nan(\"2\")   = %f (%" PRIx64 ")\n", f2, f2n);
 
    double f3 = nan("0xF");
    uint64_t f3n; memcpy(&f3n, &f3, sizeof f3);
    printf("nan(\"0xF\") = %f (%" PRIx64 ")\n", f3, f3n);
}

可能的输出：

nan("1")   = nan (7ff8000000000001)
nan("2")   = nan (7ff8000000000002)
nan("0xF") = nan (7ff800000000000f)

参阅

isnan (C99)	检查给定数是否是NaN (函数)
NAN (C99)	求值得到float类型的安静NaN (宏常量)
nanf, nan, nanl的 C++ 文档