---
title: log
description: "计算以自然对数e为底的对数值。"
url: https://www.hikunpeng.com/document/detail/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0187.html
sourcePath: /source/zh/kunpenghpcs/hpckit/devg/kunpengaccel_kml_0187.html
indexId: 501952553560d51f4109662d2e609e0e3dca94f88ba9dc180febb85a0fe6339661
---
# log

计算以自然对数e为底的对数值。

#### 接口定义

C interface：

float logf(float x);

double log(double x);

double log_18(double x);

long double logl(long double x);

log_18仅在高精度版本中提供。


Fortran interface：

RES = LOGF(X);

RES = LOG(X);


#### 参数

| 参数名 | 类型 | 描述 | 输入/输出 |
| --- | --- | --- | --- |
| x | 在logf中，x是单精度浮点类型。 在log和log\_18中，x是双精度浮点类型。 在logl中，x是长双精度浮点类型。 | 表示输入数据的浮点值。 | 输入 |


#### 返回值

- 返回以e为底x的对数函数值y，y ∈ (-INF, +INF)。
- 输入x为±0，返回-∞。
- 输入x为1，返回+0。
- 输入x为负数，返回nan。
- 输入x为-∞，返回nan。
- 输入x为+∞，返回+∞。
- 输入x为nan，返回nan。


#### 依赖

C: "km.h"


#### 示例

C interface：

```
double pi = acos(-1); 
    // typical usage 
    double x1 = pi/2, x2 = 2.0, x3 = 125, x4 = 5; 
    // special handling 
    double a = 0.0, b = INFINITY, c = -INFINITY, d = NAN, e = 1.0; 
    // print result 
    printf("base-5 logarithm of 125 = %.15f\n", log(x3)/log(x4)); 
    printf("log(1.0) = %.15f\n", log(e)); 
    printf("log(pi/2) = %.15f\n", log(x1)); 
    printf("log(2.0) = %.15f\n", log(x2)); 
    printf("log(0.0) = %.15f\n", log(a)); 
    printf("log(INFINITY) = %.15f\n", log(b)); 
    printf("log(-INFINITY) = %.15f\n", log(c)); 
    printf("log(NAN) = %.15f\n", log(d)); 
    /* 
     *  base-5 logarithm of 125 = 3.000000000000000 
     *  log(1.0) = 0.000000000000000 
     *  log(pi/2) = 0.451582705289455 
     *  log(2.0) = 0.693147180559945 
     *  log(+0.0) = -inf 
     *  log(INFINITY) = inf 
     *  log(-INFINITY) = nan 
     *  log(NAN) = nan 
     * 
     * */
```

Fortran interface：

```
REAL(8) :: X = 2
PRINT*,  LOG(X)
!
! OUTPUT
!     0.693147180559945
!
```