LOG1P - Linux手册页

时间:2019-08-20 18:00:48  来源:igfitidea点击:

Linux程序员手册 第3部分
更新日期: 2017-09-15

名称

log1p,log1pf,log1pl-1加参数的对数

语法

#include <math.h>

double log1p(double x);
float log1pf(float x);
long double log1pl(long double x);

Link with -lm.

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

log1p():

_ISOC99_SOURCE || _POSIX_C_SOURCE>= 200112L || _XOPEN_SOURCE>= 500 || / *自glibc 2.19起:* / -_DEFAULT_SOURCE || / * Glibc版本
log1pf(),

log1pl():

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

说明

这些函数返回的值等于

log (1 + x)

即使x的值接近零,也可以以准确的方式计算结果。

返回值

成功执行后,这些函数将返回(1 + x)的自然对数。

如果x是NaN,则返回NaN。

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

如果x为-1,则发生极点错误,并且函数分别返回-HUGE_VAL,-HUGE_VALF或-HUGE_VALL。

如果x小于-1(包括负无穷大),则会发生域错误,并返回NaN(不是数字)。

错误说明

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

可能会发生以下错误:

Domain error: xis less than -1
errno设置为EDOM(但请参阅BUGS)。引发了无效的浮点异常(FE_INVALID)。
Pole error: xis -1
errno设置为ERANGE(但请参阅BUGS)。产生了除零浮点异常(FE_DIVBYZERO)。

属性

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

InterfaceAttributeValue
log1p(),log1pf(),log1pl()Thread safetyMT-Safe

遵循规范

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

BUGS

在2.22版之前,发生域错误时,glibc实现未将errno设置为EDOM。

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

另外参见

exp(3),expm1(3),log(3)

出版信息

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