CGAL 5.2 - Geometric Object Generators
CGAL::Random Class Reference

#include <CGAL/Random.h>

Definition

The class Random is a random numbers generator.

It generates uniformly distributed random bool, int and double. It can be used as the random number generating function object in the STL algorithm std::random_shuffle.

Instances of Random can be seen as input streams. Different streams are independent of each other, i.e. the sequence of numbers from one stream does not depend upon how many numbers were extracted from the other streams. At each time, an instance has a state that uniquely determines the subsequent numbers being produced.

It can be very useful, e.g. for debugging, to reproduce a sequence of random numbers. This can be done by either initialising with a fixed seed, or by using the state functions as described below.

Note
A Random object is not deterministic when used by several threads at the same time, even if a fixed seed has been chosen.

Implementation

We use the boost random library function boost::rand48 to generate the random numbers.

See also
CGAL::get_default_random
Examples:
Generator/random_polygon.cpp.

Types

typedef unspecified_type State
 The State type.
 

Creation

 Random ()
 Default constructor. More...
 
 Random (unsigned int seed)
 Constructor initializing its internal state using seed. More...
 

Operations

bool get_bool ()
 returns a random bool.
 
template<int b>
int get_bits ()
 returns a random int value from the interval \([0,2^b)\). More...
 
int get_int (int lower, int upper)
 returns a random int from the interval [lower,upper).
 
double get_double (double lower=0.0, double upper=1.0)
 returns a random double from the interval [lower,upper).
 

Distributions

The following member functions are a 1-to-1 correspondence to some distributions from the boost random library.

template<typename IntType >
IntType uniform_smallint (IntType lower=0, IntType upper=9)
 returns a random IntType from the interval [lower,upper). More...
 
template<typename IntType >
IntType uniform_int (IntType lower=0, IntType upper=9)
 returns a random IntType from the interval [lower,upper). More...
 
template<typename RealType >
Realtype uniform_real (RealType lower=0.0, RealType upper=1.0)
 returns a random RealType from the interval [lower,upper). More...
 
template<typename RealType >
RealType uniform_01 ()
 returns a random RealType from the interval [0,1). More...
 
template<typename IntType >
IntType operator() (IntType upper)
 returns randomuniform_int<IntType>( 0, upper-1).
 

Seed and State Functions

unsigned int get_seed () const
 returns the seed used for initialization.
 
void save_state (State &state) const
 saves the current internal state in state.
 
void restore_state (State const &state)
 restores the internal state from state.
 

Equality Test

bool operator== (Random const &random2) const
 returns true, iff the random object and random2 have equal internal states.
 

Constructor & Destructor Documentation

◆ Random() [1/2]

CGAL::Random::Random ( )

Default constructor.

The seed is chosen based on the system time.

◆ Random() [2/2]

CGAL::Random::Random ( unsigned int  seed)

Constructor initializing its internal state using seed.

Equal values for seed result in equal sequences of random numbers.

Member Function Documentation

◆ get_bits()

template<int b>
int CGAL::Random::get_bits ( )

returns a random int value from the interval \([0,2^b)\).

This is supposed to be efficient.

◆ uniform_01()

template<typename RealType >
RealType CGAL::Random::uniform_01 ( )

returns a random RealType from the interval [0,1).

RealType can be float, double, etc.

◆ uniform_int()

template<typename IntType >
IntType CGAL::Random::uniform_int ( IntType  lower = 0,
IntType  upper = 9 
)

returns a random IntType from the interval [lower,upper).

IntType can be an integral type as int, std::ptrdiff_t, std::size_t,etc.

Warning
In contrast to get_int this function may return upper.

◆ uniform_real()

template<typename RealType >
Realtype CGAL::Random::uniform_real ( RealType  lower = 0.0,
RealType  upper = 1.0 
)

returns a random RealType from the interval [lower,upper).

RealType can be float, double, etc.

◆ uniform_smallint()

template<typename IntType >
IntType CGAL::Random::uniform_smallint ( IntType  lower = 0,
IntType  upper = 9 
)

returns a random IntType from the interval [lower,upper).

IntType can be an integral type as int, std::ptrdiff_t, std::size_t,etc.

Warning
In contrast to get_int this function may return upper.