中文
注册
我要评分
文档获取效率
文档正确性
内容完整性
文档易理解
在线提单
论坛求助

Mean

函数接口声明如下:

HmppResult HMPPS_AggMean_16s(const int16_t *src, int32_t len, int8_t *nullAddr, bool *overflow, double *sum, int64_t *count);

HmppResult HMPPS_AggMean_32s(const int32_t *src, int32_t len, int8_t *nullAddr, bool *overflow, double *sum, int64_t *count);

HmppResult HMPPS_AggMean_64s(const int64_t *src, int32_t len, int8_t *nullAddr, bool *overflow, double *sum, int64_t *count);

HmppResult HMPPS_AggMean_64f(const double *src, int32_t len, int8_t *nullAddr, bool *overflow, double *sum, int64_t *count);

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

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

参数

参数名

描述

取值范围

输入/输出

src

指向源向量的指针。

非空

输入

len

向量长度。

(0,INT_MAX]

输入

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 <stdint.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;
    int64_t count;
    bool overflow;
    HmppResult result = HMPPS_AggMean_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.000000, count = 7, overflow = 0