---
title: RandGauss
description: "产生给定均值、标准差的符合正态分布随机序列。"
url: https://www.hikunpeng.com/document/detail/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0156.html
sourcePath: /source/zh/kunpengboostkithistory/2300/accel/kunpengaccel_hmpp_06_0156.html
indexId: 4521d7d9cffc5dcfd81999060eee851ac0cea12864d61c88b362b46fef91bcb275
---
# RandGauss

产生给定均值、标准差的符合正态分布随机序列。

函数接口声明如下：

- 初始化操作：
  HmppResult HMPPS_RandGaussInit_8u(HmppsRandGaussPolicy_8u **policy, uint8_t mean, uint8_t stdDev, uint32_t seed);

  HmppResult HMPPS_RandGaussInit_16s(HmppsRandGaussPolicy_16s **policy, int16_t mean, int16_t stdDev, uint32_t seed);

  HmppResult HMPPS_RandGaussInit_32f(HmppsRandGaussPolicy_32f **policy, float mean, float stdDev, uint32_t seed);

  HmppResult HMPPS_RandGaussInit_64f(HmppsRandGaussPolicy_64f **policy, double mean, double stdDev, uint32_t seed);

- 主函数操作：
  HmppResult HMPPS_RandGauss_8u(uint8_t *dst, int32_t len, HmppsRandGaussPolicy_8u *policy)；

  HmppResult HMPPS_RandGauss_16s(int16_t *dst, int32_t len, HmppsRandGaussPolicy_16s *policy)；

  HmppResult HMPPS_RandGauss_32f(float *dst, int32_t len, HmppsRandGaussPolicy_32f *policy)；

  HmppResult HMPPS_RandGauss_64f(double *dst, int32_t len, HmppsRandGaussPolicy_64f *policy);

- 释放内存操作：
  HmppResult HMPPS_RandGaussRelease_8u(HmppsRandGaussPolicy_8u *policy)；

  HmppResult HMPPS_RandGaussRelease_16s(HmppsRandGaussPolicy_16s *policy)；

  HmppResult HMPPS_RandGaussRelease_32f(HmppsRandGaussPolicy_32f *policy)；

  HmppResult HMPPS_RandGaussRelease_64f(HmppsRandGaussPolicy_64f *policy)；


#### 参数

| 参数名 | 描述 | 取值范围 | 输入/输出 |
| --- | --- | --- | --- |
| dst | 指向目的向量的指针。 | 非空 | 输出 |
| len | 向量长度。 | (0,INT\_MAX] | 输入 |
| mean | 均值。 | 视类型而定 | 输入 |
| stdDev | 标准差。 | 视类型而定 | 输入 |
| seed | 随机数种子。 | 视类型而定 | 输入 |
| policy | 产生随机序列参数结构体。 | 非空 | 输入/输出 |


#### 返回值

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


#### 错误码

| 错误码 | 描述 |
| --- | --- |
| HMPP\_STS\_NULL\_PTR\_ERR | dst这个入参中存在空指针。 |
| HMPP\_STS\_SIZE\_ERR | len小于或等于0。 |
| HMPP\_STS\_MALLOC\_FAILED | 所需的额外内存申请失败。 |


#### 示例

```
#define BUFFER_SIZE_T 10
int main()
{
float dst[BUFFER_SIZE_T];
int32_t i;
float mean = 1;
float stdDev = 1;
float seed = 0;
HmppsRandGaussPolicy_32f *policy = NULL;
HmppResult result;
result = HMPPS_RandGaussInit_32f(&policy, mean, stdDev, seed);
if (result != HMPP_STS_NO_ERR)
{
return;
}
result = HMPPS_RandGauss_32f(dst, BUFFER_SIZE_T, policy);
printf("result = %d \ndst =", result);
for (i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %f    ", dst[i]);
}
HMPPS_RandGaussRelease_32f(policy);
return 0;
}
```

运行结果：

```
result = 0
dst = 0.839658  0.516040  0.405604  0.981364  2.000319  -0.703950  0.667630  1.412678  1.724619  1.078169
```