vRngUniformBits32
vRngUniformBits32
Generates uniformly distributed bits in 32-bit chunks.
Syntax
status
=
viRngUniformBits32
(
method
,
stream
,
n
,
r
);
Include Files
- mkl.h
Input Parameters
Name | Type | Description |
|---|---|---|
method | const MKL_INT | Generation method; the specific value is
|
stream | VSLStreamStatePtr | Pointer to the stream state structure |
n | const MKL_INT | Number of random values to be generated |
Output Parameters
Name | Type | Description |
|---|---|---|
r | unsigned int* | Vector of n 32-bit random integer numbers with uniform bit distribution. |
Description
The
vRngUniformBits32
function generates uniformly distributed bits in 32-bit chunks. Unlike vRngUniformBits
, which provides the output of underlying integer recurrence and does not guarantee uniform distribution across bits, vRngUniformBits32
is designed to ensure each bit in the 32-bit chunk is uniformly distributed. See VS Notes for details.Product and Performance Information
|
|---|
Performance varies by use, configuration and other factors. Learn more at
www.Intel.com/PerformanceIndex.
Notice revision #20201201
|
Return Values
- VSL_ERROR_OK, VSL_STATUS_OK
- Indicates no error, execution is successful.
- VSL_ERROR_NULL_PTR
- streamis aNULLpointer.
- VSL_RNG_ERROR_BAD_STREAM
- streamis not a valid random stream.
- VSL_RNG_ERROR_BRNG_NOT_SUPPORTED
- BRNG is not supported by the function.
- VSL_RNG_ERROR_NONDETERM_NRETRIES_EXCEEDED
- Number of retries to generate a random number by using non-deterministic random number generator exceeds threshold.
- VSL_RNG_ERROR_ARS5_NOT_SUPPORTED
- ARS-5 random number generator is not supported on the CPU running the application.