blob: 3286f8f2ecb154f241ec355a519b43f5457eb470 (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
|
/*
* File: random.h
* --------------
* This file exports functions for generating pseudorandom numbers.
*/
#ifndef _random_h
#define _random_h
/*
* Function: randomInteger
* Usage: int n = randomInteger(low, high);
* ----------------------------------------
* Returns a random integer in the range <code>low</code> to
* <code>high</code>, inclusive.
*/
int randomInteger(int low, int high);
/*
* Function: randomReal
* Usage: double d = randomReal(low, high);
* ----------------------------------------
* Returns a random real number in the half-open interval
* [<code>low</code> .. <code>high</code>). A half-open
* interval includes the first endpoint but not the second, which
* means that the result is always greater than or equal to
* <code>low</code> but strictly less than <code>high</code>.
*/
double randomReal(double low, double high);
/*
* Function: randomChance
* Usage: if (randomChance(p)) ...
* -------------------------------
* Returns <code>true</code> with the probability indicated by <code>p</code>.
* The argument <code>p</code> must be a floating-point number between
* 0 (never) and 1 (always). For example, calling
* <code>randomChance(.30)</code> returns <code>true</code> 30 percent
* of the time.
*/
bool randomChance(double p);
/*
* Function: setRandomSeed
* Usage: setRandomSeed(seed);
* ---------------------------
* Sets the internal random number seed to the specified value. You
* can use this function to set a specific starting point for the
* pseudorandom sequence or to ensure that program behavior is
* repeatable during the debugging phase.
*/
void setRandomSeed(int seed);
#endif
|
