Cubrt

计算每个元素的三次方根。公式为： $\text{[math]}$ 。

对于含有scale参数的计算接口，公式为： $\text{[math]}$ 。

函数接口声明如下：

HmppResult HMPPS_Cubrt_32f(const float *src, float *dst, int32_t len);

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

参数

参数名	描述	取值范围	输入/输出
src	指向源向量的指针。	非空	输入
dst	指向计算结果的指针。	非空	输出
len	向量长度。	(0,INT_MAX]	输入
scale	缩放因数。	(0,INF)且输入为2^n	输入

返回值

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

错误码

错误码	描述
HMPP_STS_NULL_PTR_ERR	src、dst这两个入参中存在空指针。
HMPP_STS_SIZE_ERR	len小于或等于0。
HMPP_STS_SCALE_ERR	scale不在(0,INF)范围内或输入为nan。

注意

scale参数取值应在-16到16之间，否则计算结果未定义。

示例

#define BUFFER_SIZE_T 10

int main()
{
    float src[BUFFER_SIZE_T] = {1.28, 4.53, 8.79, 4.23, 2.18, 9.69, 5.34, 8.03, 1.90, 8.76};
    float dst[BUFFER_SIZE_T];
    (void)HMPPS_Zero_32f(dst, BUFFER_SIZE_T); // 数组初始化，将dst所有元素初始化为0.

    HmppResult result = HMPPS_Cubrt_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");

    return 0;
}

运行结果：

result = 0
dst = 1.09 1.65 2.06 1.62 1.30 2.13 1.75 2.00 1.24 2.06

父主题： 基础与通用运算