Rand

class Rand(**kwargs)

The GRand struct is an opaque data structure. It should only be accessed through the ``g_rand_``* functions.

Constructors

class Rand
classmethod new() → Rand

Creates a new random number generator initialized with a seed taken either from /dev/urandom (if existing) or from the current time (as a fallback).

On Windows, the seed is taken from rand_s().

classmethod new_with_seed(seed: int) → Rand

Creates a new random number generator initialized with seed.

Parameters:

seed – a value to initialize the random number generator

classmethod new_with_seed_array(seed: int, seed_length: int) → Rand

Creates a new random number generator initialized with seed.

Added in version 2.4.

Parameters:

  • seed – an array of seeds to initialize the random number generator

  • seed_length – an array of seeds to initialize the random number generator

Methods

class Rand
double() → float

Returns the next random float from @``rand_`` equally distributed over the range [0..1).

double_range(begin: float, end: float) → float

Returns the next random float from @``rand_`` equally distributed over the range [begin..``end``).

Parameters:

  • begin – lower closed bound of the interval

  • end – upper open bound of the interval

free() → None

Frees the memory allocated for the Rand.

int() → int

Returns the next random guint32 from @``rand_`` equally distributed over the range [0..2^32-1].

int_range(begin: int, end: int) → int

Returns the next random int from @``rand_`` equally distributed over the range [begin..``end``-1].

Parameters:

  • begin – lower closed bound of the interval

  • end – upper open bound of the interval

set_seed(seed: int) → None

Sets the seed for the random number generator Rand to seed.

Parameters:

seed – a value to reinitialize the random number generator

set_seed_array(seed: int, seed_length: int) → None

Initializes the random number generator by an array of longs. Array can be of arbitrary size, though only the first 624 values are taken. This function is useful if you have many low entropy seeds, or if you require more then 32 bits of actual entropy for your application.

Added in version 2.4.

Parameters:

  • seed – array to initialize with

  • seed_length – length of array