random
Utilities for generating random values in Koto.
At the core of the module is the Rng
type, which is a seedable random
number generator. Each thread has access to a generator with a randomly
selected seed, or unique generators can be created with random.generator
.
bool
|| -> Bool
Generates a random bool using the current thread's generator.
Example
# Seed the thread Rng so that we get predictable results
random.seed 99
random.bool
# -> false
random.bool
# -> true
generator
|| -> Rng
Creates an Rng
with a randomly generated seed.
|Number| -> Rng
Creates an Rng
with a specified seed.
Example
rng = random.generator 99
rng.pick
# -> 3
rng.bool
# -> false
number
|| -> Number
Generates a random number using the current thread's generator.
The number will be a floating point value in the range from 0 up to but not including 1.
Example
# Seed the thread Rng so that we get predictable results
random.seed 123
# Print random floats up to 3 decimal places
print ''
# -> 0.853
print ''
# -> 0.168
pick
|Value| -> Value
Selects a random value from the input using the current thread's generator.
- If the input is a list or a tuple, a randomly selected element will be returned.
- If the input is a map, then a tuple containing the key and value of a randomly selected entry will be returned.
- If the input is a range, then the result will be an integer within the given range.
Example
# Seed the thread Rng so that we get predictable results
random.seed -1
random.pick
# -> 99
random.pick 10..20
# -> 14
random.pick
# -> ('bar', 99)
seed
|Number| -> Null
Seeds the current thread's generator so that it produces predictable results.
Example
from iterator import generate
from random import pick, seed
# Returns a tuple containing three numbers from 1 to 10
pick_3 = || generate.to_tuple
seed 1
pick_3
# -> (5, 3, 8)
seed 2
pick_3
# -> (6, 9, 3)
seed 1
pick_3
# -> (5, 3, 8)
Rng
Rng
is the random
module's core random generator.
The ChaCha algorithm with 8 rounds from the rand_chacha
crate is used to
generate random values.
See the implementation's docs for more information.
Rng.bool
See random.bool.
Rng.number
See random.number.
Rng.pick
See random.pick.
Rng.seed
See random.seed.