The OpenD Programming Language

arsd.random

A random number generator that can work with std.random but does not have to.

It is designed to be reasonably good and fast, more for fun than for security.

Members

Aliases

randomInteger
alias randomInteger = uniform

Gets a random number from a uniform distribution including min and up to (but not including) max from the reasonable default generator.

Functions

bellCurve
int bellCurve(int median, int standardDeviation, int min, int max)
int bellCurve(Rng gen, int median, int standardDeviation, int min, int max)

Pick a random number off the normal (aka gaussian) distribution bell curve.

getReasonableDefaultGenerator
Rng getReasonableDefaultGenerator(ulong seed)
Rng getReasonableDefaultGenerator()

Gets a "reasonable default" random number generator, one good enough for my casual use. This is the object used by the other functions when you don't explicitly use your own generator.

randomFloat
float randomFloat()
float randomFloat(Rng gen)

Gets a random number between 0.0 and 1.0, including 0.0, but not including 1.0.

shuffle
void shuffle(T[] array)
void shuffle(Rng gen, T[] array)

Shuffles the contents of the array, in place. Assumes elements can be easily swapped. (the current implementation is an in-place Fisher-Yates algorithm)

uniform
int uniform(int min, int max)
int uniform(Rng gen, int min, int max)

Gets a random number from a uniform distribution including min and up to (but not including) max from the reasonable default generator.

weightedChoice
int weightedChoice(int[] weights)
int weightedChoice(Rng gen, int[] weights)

Returns an index of the weights, with the proportional odds given by the weights.

Interfaces

Rng
interface Rng

A simple generic interface to a random number generator.

Meta

Authors

Forked from Herringway's pcg.d file: https://github.com/Herringway/unexpected/blob/main/pcg/source/unexpected/pcg.d

Modified by Adam D. Ruppe

License

BSL-1.0

Boost Software License - Version 1.0 - August 17th, 2003

Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the "Software") to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following:

The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machine-executable object code generated by a source language processor.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.