---
title: AddC
description: "常量与向量中的每个元素相加。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_hmpp_06_0050.html
sourcePath: /source/zh/kunpengboostkithistory/240RC2/accel/kunpengaccel_hmpp_06_0050.html
indexId: dfcb51e125b95ca938bc7455033eacf46b0aed4ccbe522ec215fa56faf9990ee77
---
# AddC

常量与向量中的每个元素相加。

函数接口声明如下：

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

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

  HmppResult HMPPS_AddC_32fc(const Hmpp32fc *src, Hmpp32fc val, Hmpp32fc *dst, int32_t len);

  HmppResult HMPPS_AddC_64fc(const Hmpp64fc *src, Hmpp64fc val, Hmpp64fc *dst, int32_t len);

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

  HmppResult HMPPS_AddC_16u_S(const uint16_t *src, uint16_t val, uint16_t *dst, int32_t len, double scale);

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

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

  HmppResult HMPPS_AddC_64s_S(const int64_t *src, int64_t val, int64_t *dst, int32_t len, double scale, HmppRoundMode rndMode);

  HmppResult HMPPS_AddC_16sc_S(const Hmpp16sc *src, Hmpp16sc val, Hmpp16sc *dst, int32_t len, double scale);

  HmppResult HMPPS_AddC_32sc_S(const Hmpp32sc *src, Hmpp32sc val, Hmpp32sc *dst, int32_t len, double scale);

  HmppResult HMPPS_AddC_64u_S(const uint64_t *src, uint64_t val, uint64_t *dst, int32_t len, double scale, HmppRoundMode rndMode);

- 整型数的原址操作：
  HmppResult HMPPS_AddC_16s_I(int16_t val, int16_t *srcDst, int32_t len);

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

  HmppResult HMPPS_AddC_64f_I(double val, double *srcDst, int32_t len);

  HmppResult HMPPS_AddC_32fc_I(Hmpp32fc val, Hmpp32fc *srcDst, int32_t len);

  HmppResult HMPPS_AddC_64fc_I(Hmpp64fc val, Hmpp64fc *srcDst, int32_t len);

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

  HmppResult HMPPS_AddC_16u_IS(uint16_t val, uint16_t_t *srcDst, int32_t len, double scale);

  HmppResult HMPPS_AddC_16s_IS(int16_t val, int16_t *srcDst, int32_t len, double scale);

  HmppResult HMPPS_AddC_32s_IS(int32_t val, int32_t *srcDst, int32_t len, double scale);

  HmppResult HMPPS_AddC_16sc_IS(Hmpp16sc val, Hmpp16sc *srcDst, int32_t len, double scale);

  HmppResult HMPPS_AddC_32sc_IS(Hmpp32sc val, Hmpp32sc *srcDst, int32_t len, double scale);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源向量的指针。 | 非空 | 输入 |
| val | 固定值。 | 不限，视数据类型而定 | 输入 |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| srcDst | 指向原址操作向量的指针。 | 非空 | 输入/输出 |
| len | 向量长度。 | (0, INT\_MAX] | 输入 |
| scale | 缩放因数。 | (0,INF)且输入为2n | 输入 |
| rndMode | 舍入模式。 | HMPP\_RND\_ZERO、HMPP\_RND\_NEAR、HMPP\_RND\_FINANCIAL | 输入 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src、dst、srcDst这几个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | len小于或等于0。 |
| HMPP\_STS\_SCALE\_ERR | scale不在(0,INF)范围内或输入为NAN。 |


#### 示例

```
#define BUFFER_SIZE_T 10
void AddCExample(void)
{
uint8_t src[BUFFER_SIZE_T] = {0, 1, 3, 5, 7, 10, 254, 255, 20, 50};
uint8_t dst[BUFFER_SIZE_T] = {0, 0, 0, 0, 0, 0, 0, 0, 0, 0};
uint8_t val = 1;
double scale = 2.0;
int32_t i;
HmppResult result = HMPPS_AddC_8u_S(src, val, dst, BUFFER_SIZE_T, scale);
printf("result = %d \n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
printf("dst =");
for (i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %d ", dst[i]);
}
printf("\n");
}
```

运行结果：

```
result = 0
dst = 0  1  2  3  4  6  128  128  10  26
```