---
title: Ln
description: "计算向量中每个元素的自然对数。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0064.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0064.html
indexId: 887ee7bdd6d650cfa049ad8a4acd28a22c4dd49ffdacf35187db02c3ee1260ff77
---
# Ln

计算向量中每个元素的自然对数。

函数接口声明如下：

- 浮点数的操作：
  HmppResult HMPPS_Ln_32f(const float* src, float* dst, int32_t len);

  HmppResult HMPPS_Ln_64f(const double* src, double* dst, int32_t len);

- 浮点数的原址操作：
  HmppResult HMPPS_Ln_32f_I(float* srcDst, int32_t len);

  HmppResult HMPPS_Ln_64f_I(double* srcDst, int32_t len);

- 有缩放的整型数操作：
  HmppResult HMPPS_Ln_16s_S(const int16_t* src, int16_t* dst, int32_t len, double scale);

  HmppResult HMPPS_Ln_32s_S(const int32_t* src, int32_t* dst, int32_t len, double scale);

- 有缩放的整型数原址操作：
  HmppResult HMPPS_Ln_16s_IS(int16_t* srcDst, int32_t len, double scale);

  HmppResult HMPPS_Ln_32s_IS(int32_t* srcDst, int32_t len, double scale);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源向量的指针。 | 非空 | 输入 |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| srcDst | 指向原址操作向量的指针。 | 非空 | 输入/输出 |
| len | 向量长度。 | (0, INT\_MAX] | 输入 |
| scale | 缩放因数。 | (0,INF)且输入为2^n | 输入 |


#### 返回值

- 成功：返回HMPP_STS_NO_ERR。
- 失败：返回错误码。


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src、dst、srcDst这几个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | len小于或等于0。 |
| HMPP\_STS\_LN\_NEG\_ARG | 真数为负数。 |
| HMPP\_STS\_LN\_ZERO\_ARG | 真数为0。 |
| HMPP\_STS\_SCALE\_ERR | scale不在(0,INF)范围内或输入为nan。 |
| HMPP\_STS\_SINGULARITY | src中至少有一个元素等于0。 |
| HMPP\_STS\_DOMAIN | src中至少有一个元素小于0。 |


#### 示例

```
#define BUFFER_SIZE_T 10
void LnExample(void)
{
float src[BUFFER_SIZE_T] = {6.17, 6.13, 0.70, 9.23, 3.71, 6.13, 0.90, 10.21, 0.70, 1.12};
float dst[BUFFER_SIZE_T];
(void)HMPPS_Zero_32f(dst, BUFFER_SIZE_T); // 数组初始化，将dst所有元素初始化为0.
HmppResult result = HMPPS_Ln_32f(src, dst, BUFFER_SIZE_T);
printf("result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
printf("dst =");
for (int32_t i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %.2f", dst[i]);
}
printf("\n");
}
```

运行结果：

```
result = 0
dst = 1.82 1.81 -0.36 2.22 1.31 1.81 -0.11 2.32 -0.36 0.11
```