---
title: Mean
description: "函数接口声明如下："
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2200/accel/kunpengaccel_hmpp_06_0264.html
sourcePath: /source/zh/kunpengboostkithistory/2200/accel/kunpengaccel_hmpp_06_0264.html
indexId: 5060e56a9a60318456acff22d0d9ebe51e3b308637e79f4a9b84bf0a8a38758075
---
# Mean

函数接口声明如下：

- 直接获得平均值的操作：
  HmppResult HMPPS_Mean_16s(const int16_t *src, int32_t len, int16_t *mean);

  HmppResult HMPPS_Mean_32s(const int32_t *src, int32_t len, int32_t *mean);

- 获得加和与个数的操作：
  HmppResult HMPPS_Mean_64s(const int64_t *src, int32_t len, int8_t *nullAddr, bool *overflow, double *sum, int32_t *count);

  HmppResult HMPPS_Mean_decimal128(const HmppDecimal128 *src, int32_t len, int8_t *nullAddr, bool *overflow, HmppDecimal128 *sum, int32_t *count);


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| src | 指向源向量的指针。 | 非空 | 输入 |
| len | 向量长度。 | (0,INT\_MAX] | 输入 |
| mean | 指向平均值结果的指针。 | 非空 | 输出 |
| nullAddr | 指向空地址的指针。 若nullAddr为空指针，表示src向量中所有元素都参与计算。 否则，当nullAddr[i]=0时，src[i]参与计算（i表示索引）。 | 无要求，可以为空 | 输入 |
| overflow | 指向溢出标志位的指针。 | 非空 | 输出 |
| sum | 指向求和结果的指针。 | 非空 | 输出 |
| count | 指向个数结果的指针。统计有效计算元素个数，最终的平均值为sum/count。 | 非空 | 输出 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | src、mean、sum、count、overflow这几个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | len小于或等于0。 |


#### 示例

```
#include <stdio.h>
#include "hmpp.h"
#define BUFFER_SIZE_T 10
int main()
{
int64_t src[BUFFER_SIZE_T] = {1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
int8_t nullAddr[BUFFER_SIZE_T] = {0, 0, 1, 1, 0, 1, 0, 0, 0, 0};
double sum;
int32_t count;
bool overflow;
HmppResult result = HMPPS_Mean_64s(src, BUFFER_SIZE_T, nullAddr, &overflow, &sum, &count);
printf("result = %d  ", result);
if (result != HMPP_STS_NO_ERR) {
return 0;
}
printf("sum = %lf, count = %d, overflow = %d\n", sum, count, overflow);
}
```

运行结果：

```
result = 0  sum = 42, count = 7, overflow = 0
```