---
title: Add
description: "向量与向量相加。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0049.html
sourcePath: /source/zh/kunpengboostkithistory/240RC1/accel/kunpengaccel_hmpp_06_0049.html
indexId: 5d196af8daeee289269c6fa5a9019c5077d2cfefaca4360cb4bedbf33c98386177
---
# Add

向量与向量相加。

函数接口声明如下：

- 整型数的操作：
  HmppResult HMPPS_Add_8u16u(const uint8_t *src1, const uint8_t *src2, uint16_t *dst, int32_t len);

  HmppResult HMPPS_Add_16u(const uint16_t *src1, const uint16_t *src2, uint16_t *dst, int32_t len);

  HmppResult HMPPS_Add_32u(const uint32_t *src1, const uint32_t *src2, uint32_t *dst, int32_t len);

  HmppResult HMPPS_Add_16s(const int16_t *src1, const int16_t *src2, int16_t *dst, int32_t len);

- 整型与浮点数的操作：
  HmppResult HMPPS_Add_16s32f(const int16_t *src1, const int16_t *src2, float *dst, int32_t len);

- 浮点数的操作：
  HmppResult HMPPS_Add_32f(const float *src1, const float *src2, float *dst, int32_t len);

  HmppResult HMPPS_Add_64f(const double *src1, const double *src2, double *dst, int32_t len);

  HmppResult HMPPS_Add_32fc(const Hmpp32fc *src1, const Hmpp32fc *src2, Hmpp32fc *dst, int32_t len);

  HmppResult HMPPS_Add_64fc(const Hmpp64fc *src1, const Hmpp64fc *src2, Hmpp64fc *dst, int32_t len);

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

  HmppResult HMPPS_Add_16u_S(const uint16_t *src1, const uint16_t *src2, uint16_t *dst, int32_t len, double scale);

  HmppResult HMPPS_Add_16s_S(const int16_t *src1, const int16_t *src2, int16_t *dst, int32_t len, double scale);

  HmppResult HMPPS_Add_32s_S(const int32_t *src1, const int32_t *src2, int32_t *dst, int32_t len, double scale);

  HmppResult HMPPS_Add_64s_S(const int64_t *src1, const int64_t *src2, int64_t *dst, int32_t len, double scale);

  HmppResult HMPPS_Add_16sc_S(const Hmpp16sc *src1, const Hmpp16sc *src2, Hmpp16sc *dst, int32_t len, double scale);

  HmppResult HMPPS_Add_32sc_S(const Hmpp32sc *src1, const Hmpp32sc *src2, Hmpp32sc *dst, int32_t len, double scale);

- 整型数的原址操作：
  HmppResult HMPPS_Add_32u_I(const uint32_t *src, uint32_t *srcDst, int32_t len);

  HmppResult HMPPS_Add_16s_I(const int16_t *src, int16_t *srcDst, int32_t len);

  HmppResult HMPPS_Add_16s32s_I(const int16_t *src, int32_t *srcDst, int32_t len);

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

  HmppResult HMPPS_Add_64f_I(const double *src, double *srcDst, int32_t len);

  HmppResult HMPPS_Add_32fc_I(const Hmpp32fc *src, Hmpp32fc *srcDst, int32_t len);

  HmppResult HMPPS_Add_64fc_I(const Hmpp64fc *src, Hmpp64fc *srcDst, int32_t len);

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

  HmppResult HMPPS_Add_16u_IS(const uint16_t *src, uint16_t *srcDst, int32_t len, double scale);

  HmppResult HMPPS_Add_16s_IS(const int16_t *src, int16_t *srcDst, int32_t len, double scale);

  HmppResult HMPPS_Add_32s_IS(const int32_t *src, int32_t *srcDst, int32_t len, double scale);

  HmppResult HMPPS_Add_16sc_IS(const Hmpp16sc *src, Hmpp16sc *srcDst, int32_t len, double scale);

  HmppResult HMPPS_Add_32sc_IS(const Hmpp32sc *src, Hmpp32sc *srcDst, int32_t len, double scale);


#### 参数

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


#### 返回值

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


#### 错误码

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


#### 示例

```
#define BUFFER_SIZE_T 9
void AddExample(void)
{
uint32_t src1[BUFFER_SIZE_T] = {1598181665, 1446829146, 2752624014, 2171200733, 2676378769, 1078554841, 1318511000, 2592925506, 2518880388};
uint32_t src2[BUFFER_SIZE_T] = {422526272, 1563791282, 1664517688, 1278844750, 1984585164, 1554125489, 1115993496, 1182866132, 2965039412};
uint32_t dst[BUFFER_SIZE_T] = {0};
HmppResult result = HMPPS_Add_32u(src1, src2, dst, BUFFER_SIZE_T);
printf("result = %d\n", result);
if (result != HMPP_STS_NO_ERR) {
return;
}
printf("\ndst = ");
for (int32_t i = 0; i < BUFFER_SIZE_T; i++) {
printf("%d ", dst[i]);
}
}
```

运行结果：

```
result = 0
dst = 2020707937 -1284346868 -1 -844921813 -1 -1662286966 -1860462800 -519175658 -1
```