RandUniform
产生给定均值、标准差的均匀分布随机序列。
函数接口声明如下：
- 初始化操作：
HmppResult HMPPS_RandUniformInit_8u(HmppsRandUniformPolicy_8u** policy, uint8_t low, uint8_t high, uint32_t seed);
HmppResult HMPPS_RandUniformInit_16s(HmppsRandUniformPolicy_16s** policy, int16_t low, int16_t high, uint32_t seed);
HmppResult HMPPS_RandUniformInit_32f(HmppsRandUniformPolicy_32f** policy, float low, float high, uint32_t seed);
HmppResult HMPPS_RandUniformInit_64f(HmppsRandUniformPolicy_64f** policy, double low, double high, uint32_t seed);
- 主函数操作：
HmppResult HMPPS_RandUniform_8u(uint8_t* dst, int32_t len, HmppsRandUniformPolicy_8u* policy);
HmppResult HMPPS_RandUniform_16s(int16_t* dst, int32_t len, HmppsRandUniformPolicy_16s* policy);
HmppResult HMPPS_RandUniform_32f(float* dst, int32_t len, HmppsRandUniformPolicy_32f* policy);
HmppResult HMPPS_RandUniform_64f(double* dst, int32_t len, HmppsRandUniformPolicy_64f* policy);
- 释放内存操作：
HmppResult HMPPS_RandUniformRelease_8u(HmppsRandGaussPolicy_8u* policy);
HmppResult HMPPS_ RandUniformRelease_16s(HmppsRandGaussPolicy_16s* policy);
HmppResult HMPPS_ RandUniformRelease_32f(HmppsRandGaussPolicy_32f* policy);
HmppResult HMPPS_ RandUniformRelease_64f(HmppsRandGaussPolicy_64f* policy);
参数
参数名 |
描述 |
取值范围 |
输入/输出 |
|---|---|---|---|
dst |
指向目的向量的指针。 |
非空 |
输出 |
len |
向量长度。 |
(0,INT_MAX] |
输入 |
low |
最小值 |
视类型而定 |
输入 |
high |
最大值 |
视类型而定 |
输入 |
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 low = 1.0;
float high = 1000.0;
float seed = 0;
HmppsRandUniformPolicy_32f *policy = NULL;
HmppResult result;
result = HMPPS_RandUniformInit_32f(&policy, low, high, seed);
if (result != HMPP_STS_NO_ERR)
{
return;
}
result = HMPPS_RandUniform_32f(dst, BUFFER_SIZE_T, policy);
printf("result = %d \ndst =", result);
for (i = 0; i < BUFFER_SIZE_T; i++) {
printf(" %f ", dst[i]);
}
HMPPS_RandUniformRelease_32f(policy);
return 0;
}
运行结果：
result = 0 dst = 171.657196 750.152100 97.275284 870.594727 577.726196 786.013489 692.501953 369.397522 874.030151 745.349976