---
title: Powx
description: "计算源向量中每个元素的恒定幂次方。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0125.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0125.html
indexId: b1989c25e2eb1985fe8a0880bd5d4cdf8958cb068211816841ee4798c8045f7f77
---
# Powx

计算源向量中每个元素的恒定幂次方。

函数接口声明如下：

HmppResult HMPPS_Powx_32f_A11(const float *src, const float constValue, float *dst, int32_t len)；

HmppResult HMPPS_Powx_32f_A21(const float *src, const float constValue, float *dst, int32_t len)；

HmppResult HMPPS_Powx_32f_A24(const float *src, const float constValue, float *dst, int32_t len)；

HmppResult HMPPS_Powx_64f_A26(const double *src, const double constValue, double *dst, int32_t len)；

HmppResult HMPPS_Powx_64f_A50(const double *src, const double constValue, double *dst, int32_t len)；

HmppResult HMPPS_Powx_64f_A53(const double *src, const double constValue, double *dst, int32_t len)；

HmppResult HMPPS_Powx_32fc_A11(const Hmpp32fc *src, const Hmpp32fc constValue, Hmpp32fc *dst, int32_t len)；

HmppResult HMPPS_Powx_32fc_A21(const Hmpp32fc *src, const Hmpp32fc constValue, Hmpp32fc *dst, int32_t len)；

HmppResult HMPPS_Powx_32fc_A24(const Hmpp32fc *src, const Hmpp32fc constValue, Hmpp32fc *dst, int32_t len)；

#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源向量的指针。 | 非空 | 输入 |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| len | 向量长度。 | (0, INT\_MAX] | 输入 |
| constValue | 幂运算的指数。 | 不限，视类型而定 | 输入 |


#### 返回值

- 成功：返回HMPP_STS_NO_ERR。
- 警告：返回HMPP_STS_DOMAIN或HMPP_STS_SINGULARITY。
- 失败：返回错误码。


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src、dst这两个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | len小于或等于0。 |
| HMPP\_STS\_DOMAIN | 告警，向量中存在小于0的元素且指数constValue为小数。 |
| HMPP\_STS\_SINGULARITY | 告警，向量中存在等于0的元素且指数constValue为负数。 |


#### 示例

```
#define  BUFFER_SIZE_T 5
void PowxExample()
{
float src[BUFFER_SIZE_T] = {1, 2.5, 3.3, 1, 5};
float constValue = 2;
float dst[BUFFER_SIZE_T];
HMPPS_Zero_32f(dst, BUFFER_SIZE_T); // 数组初始化，将dst所有元素初始化为0。
HmppResult result = HMPPS_Powx_32f_A11(src, constValue, dst, BUFFER_SIZE_T);
if (result == HMPP_STS_NO_ERR) {
printf("dst = ");
for (int32_t i = 0; i < BUFFER_SIZE_T; i++) {
printf("%.2f ", dst[i]);
}
printf("\n");
}
}
```

运行结果：

```
dst = 1.00 6.25 10.89 1.00 25.00
```