You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

69 lines
2.8 KiB

Functions:
chance (fraction-chance ...)
Returns T if the chance was met, NIL if not.
weighted (weights &key (default nil) ...)
Takes a list in this format:
((value-one . 0.25)
(value-two . 0.50)
(value-three . 0.25))
And calculates the result as chances. The values of the alist should total 1, if they are less than one and the chance is not met, return `default`.
shuffle! (sequence ...)
Shuffle a sequence in place.
Returns the sequence.
within (sequence ...)
Returns a random element in this sequence.
within-set (sequence value)
Set a random element in `sequence` to `value`.
Can be used like: (setf (within seq) value)
range (start end &key (integral nil) ...)
Returns a random number in the inclusive range of `start` to `end`.
If `integral` is not NIL, round to an integer.
All the above functions (except within-set() can take the key parameter `provider`, which defaults to cl-rng:*default-randomness-provider*.
Parameters:
*default-precision*
The default precision of the default randomness provider. Defaults to 1.
*default-randomness-provider*
The default `provider` for the above functions. Should be a function with a lambda list that resembles those of `urandom` and `crandom` functions. Defaults to cl-rng:crandom
Module `urandom`:
urandom (&key (limit 1.0) (precision 1) (transform nil))
Get a random value from /dev/urandom, between 0 and 1 inclusive `precision` times. Multiply its average by `limit`, and transform it by `transform` (if `transform` is not NIL) and return.
urandom-range (range &key (limit 1.0) (precision 1) (transform nil))
Apply `urandom` function to a sequence in place.
urandom-bytes (len &key (transform #'identity) (type :vector))
Get `len` bytes from /dev/urandom and return them as a vector if type is :VECTOR, otherwise a list. Apply `transform` to each element.
Module `crandom` (requires FFI):
crandom (&key (limit 1.0) (precision 1) (transform #'identity))
Get a cryptographically secure random floating point number (64 bit) between 0 and 1 from FFI `precision` times, multiply its average by `limit`, apply `transform` to it and return. If FFI fails, return NIL.
crandom-range (range &key (limit 1.0) (precision 1) (transform #'identity))
Apply `crandom` to a sequence in place.
crandom-bytes (len &key (transform #'identity) (type :vector))
Get `len` cryptographically secure bytes from FFI, apply `transform` to each, collect to vector if type is :VECTOR, list otherwise.
If FFI fails, return NIL.
----
To use crandom, run sudo make install. (installs to /usr/local/lib and /usr/lib)
Prebuilt binary signed with https://flanchan.moe/flanchan.asc (2d6b35bb0e22b00e3adfb0b4f9171923fc8bd0be01f47f89bdbbedd759c36b82)
To build dependencies yourself run:
make build && sudo make install
(requires Rust)