PRNG algorithmic interface, analogous to Ruby level classes. More...

#include <random.h>

Data Fields
size_t	default_seed_bits
	Number of bits of seed numbers.

struct {

uint8_t major

uint8_t minor

}	version
	Major/minor versions of this interface.

uint16_t	flags
	Reserved flags.

rb_random_init_func *	init
	Function to initialize from uint32_t array.

rb_random_init_int32_func *	init_int32
	Function to initialize from single uint32_t.

rb_random_get_int32_func *	get_int32
	Function to obtain a random integer.

rb_random_get_bytes_func *	get_bytes
	Function to obtain a series of random bytes.

rb_random_get_real_func *	get_real
	Function to obtain a random double.

Detailed Description

PRNG algorithmic interface, analogous to Ruby level classes.

Definition at line 114 of file random.h.

Field Documentation

◆ default_seed_bits

size_t rb_random_interface_t::default_seed_bits

Number of bits of seed numbers.

Definition at line 116 of file random.h.

◆ flags

uint16_t rb_random_interface_t::flags

Reserved flags.

Definition at line 128 of file random.h.

◆ get_bytes

rb_random_get_bytes_func* rb_random_interface_t::get_bytes

Function to obtain a series of random bytes.

If your PRNG have a native method to yield arbitrary number of bytes use that to implement this. But in case you lack such things, you can do so by using rb_rand_bytes_int32()

extern rb_random_get_int32_func your_get_int32_func;
 
void
your_get_byes_func(rb_random_t *rng, void *buf, size_t len)
{
    rb_rand_bytes_int32(your_get_int32_func, rng, buf, len);
}

Definition at line 155 of file random.h.

◆ get_int32

rb_random_get_int32_func* rb_random_interface_t::get_int32

Function to obtain a random integer.

Definition at line 137 of file random.h.

◆ get_real

rb_random_get_real_func* rb_random_interface_t::get_real

Function to obtain a random double.

If your PRNG have a native method to yield a floating point random number use that to implement this. But in case you lack such things, you can do so by using rb_int_pair_to_real().

extern rb_random_get_int32_func your_get_int32_func;
 
void
your_get_real_func(rb_random_t *rng, int excl)
{
    auto a = your_get_int32_func(rng);
    auto b = your_get_int32_func(rng);
    return rb_int_pair_to_real(a, b, excl);
}

Definition at line 175 of file random.h.

◆ init

rb_random_init_func* rb_random_interface_t::init

Function to initialize from uint32_t array.

Definition at line 131 of file random.h.

◆ init_int32

rb_random_init_int32_func* rb_random_interface_t::init_int32

Function to initialize from single uint32_t.

Definition at line 134 of file random.h.

◆ major

uint8_t rb_random_interface_t::major

Definition at line 122 of file random.h.

◆ minor

uint8_t rb_random_interface_t::minor