gmp_lib.mpz_urandomb Method

GMP Native Interface for .NET

previous page next page
gmp_libmpz_urandomb Method
Generate a uniformly distributed random integer in the range 0 to 2^n - 1, inclusive.

Namespace:  Math.Gmp.Native
Assembly:  Math.Gmp.Native (in Math.Gmp.Native.dll) Version: 1.0.0.0 (1.0.0.0)
Syntax
Copy
public static void mpz_urandomb(
	mpz_t rop,
	gmp_randstate_t state,
	mp_bitcnt_t n
)
Public Shared Sub mpz_urandomb ( 
	rop As mpz_t,
	state As gmp_randstate_t,
	n As mp_bitcnt_t
)
public:
static void mpz_urandomb(
	mpz_t^ rop, 
	gmp_randstate_t^ state, 
	mp_bitcnt_t n
)
static member mpz_urandomb : 
        rop : mpz_t * 
        state : gmp_randstate_t * 
        n : mp_bitcnt_t -> unit

Parameters

rop
Type: Math.Gmp.Nativempz_t
The result integer.
state
Type: Math.Gmp.Nativegmp_randstate_t
The random number generator state.
n
Type: Math.Gmp.Nativemp_bitcnt_t
The operand integer.
Remarks

The variable state must be initialized by calling one of the gmp_randinit functions (GNU MP - Random State Initialization) before invoking this function.

The random number functions of GMP come in two groups; older function that rely on a global state, and newer functions that accept a state parameter that is read and modified. Please see the GNU MP - Random Number Functions for more information on how to use and not to use random number functions.

Examples
Copy
// Create, initialize, and seed a new random number generator.
gmp_randstate_t state = new gmp_randstate_t();
gmp_lib.gmp_randinit_mt(state);
gmp_lib.gmp_randseed_ui(state, 100000U);

// Create, initialize, and set the value of rop to 0.
mpz_t rop = new mpz_t();
gmp_lib.mpz_init(rop);

// Generate a random integer in the range [0, (2^50)-1].
gmp_lib.mpz_urandomb(rop, state, 50);

// Free all memory occupied by state and rop.
gmp_lib.gmp_randclear(state);
gmp_lib.mpz_clear(rop);
' Create, initialize, and seed a new random number generator.
Dim state As New gmp_randstate_t()
gmp_lib.gmp_randinit_mt(state)
gmp_lib.gmp_randseed_ui(state, 100000UI)

' Create, initialize, and set the value of rop to 0.
Dim rop As New mpz_t()
gmp_lib.mpz_init(rop)

' Generate a random integer in the range [0, (2^50)-1].
gmp_lib.mpz_urandomb(rop, state, 50)

' Free all memory occupied by state and rop.
gmp_lib.gmp_randclear(state)
gmp_lib.mpz_clear(rop)

No code example is currently available or this language may not be supported.

No code example is currently available or this language may not be supported.

See Also
previous page start next page