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

父主题： 基础与通用运算