Linux程序员手册 第3部分
更新日期： 2020-06-09

名称

expm1，expm1f，expm1l-指数减1

语法

#include <math.h>

double expm1(double x);
float expm1f(float x);
long double expm1l(long double x);

Link with -lm.

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

expm1()：

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || _XOPEN_SOURCE>= 500 || / *自glibc 2.19起：* / -_DEFAULT_SOURCE || / * Glibc版本

expm1l():

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || / *自glibc 2.19起：* / -_DEFAULT_SOURCE || / * Glibc版本

说明

这些函数返回的值等于

exp(x) - 1

即使x的值接近零，也以一种准确的方式计算结果-由于两个几乎相等的数字相减，exp(x)-1可能不准确。

返回值

成功执行后，这些函数将返回exp(x)-1。

如果x是NaN，则返回NaN。

如果x为+0(-0)，则返回+0(-0)。

如果x为正无穷大，则返回正无穷大。

如果x为负无穷大，则返回-1。

如果结果溢出，则会发生范围错误，并且这些函数将分别返回-HUGE_VAL，-HUGE_VALF或-HUGE_VALL。

错误说明

有关如何确定调用这些函数时是否发生错误的信息，请参见math_error(7)。

可能会发生以下错误：

Range error, overflow

errno设置为ERANGE(但请参阅BUGS)。引发了一个溢出浮点异常(FE_OVERFLOW)。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

C99，POSIX.1-2001，POSIX.1-2008。

BUGS

在glibc 2.17之前，在某些架构(例如x86，但不是x86_64)上，expm1()针对某些较大的负x值(函数结果接近-1)提出了虚假的下溢浮点异常，

在大约glibc 2.11版之前，expm1()除了预期的溢出异常之外，还提出了虚假的无效浮点异常，并返回了NaN而不是正无穷大。对于一些较大的正x值，

在2.11版之前，发生范围错误时，glibc实现未将errno设置为ERANGE。

另外参见

exp(3)，log(3)，log1p(3)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。