函数
<cmath> <ctgmath>

log1p

     double log1p  (double x);      float log1pf (float x);long double log1pl (long double x);
     double log1p (double x);      float log1p (float x);long double log1p (long double x);     double log1p (T x);           // additional overloads for integral types
计算对数加一
返回一加 x自然对数

x 的量级很小时,logp1 可能比 log(1+x) 更精确。

头文件 <tgmath.h> 提供了此函数的类型通用宏版本。
此头文件 (<cmath>) 为整数类型提供了额外的重载:这些重载在计算前有效地将 x 转换为 double(为任何整数类型T 定义)。

参数

x
要计算其对数的值。
如果参数小于 -1,则会发生定义域错误

返回值

(1+x)自然对数
如果 x 小于 -1,会导致定义域错误
如果 x-1,可能会导致极点错误(取决于库的实现)。

如果发生定义域错误
- 并且 math_errhandling 设置了 MATH_ERRNO:全局变量 errno 会被设置为 EDOM
- 并且 math_errhandling 设置了 MATH_ERREXCEPT:将引发 FE_INVALID

如果发生极点错误
- 并且 math_errhandling 设置了 MATH_ERRNO:全局变量 errno 被设置为 ERANGE
- 并且 math_errhandling 设置了 MATH_ERREXCEPT:将引发 FE_DIVBYZERO

示例

1
2
3
4
5
6
7
8
9
10
11
12
/* log1p example */
#include <stdio.h>      /* printf */
#include <math.h>       /* log1p */

int main ()
{
  double param, result;
  param = 1.0;
  result = log1p (param);
  printf ("log1p (%f) = %f.\n", param, result );
  return 0;
}

输出

log1p (1.000000) = 0.693147


另见