newid

Description:
Allocates a fresh id for a series of rolls.
Input:
none
Output:
id hash, where both the id and hash are in hexadecimal and 40 digits long.

checkhash

Description:
Returns the roll hash for a given id.
Input:
id
The id number of the roll hash being requested.
Output:
hash, the roll hash.

checkbuf

Description:
Checks how full the buffer of random bits is.
Input:
none
Output:
n%, where n is an integer in the range [0,100]. Presently, 100% will always be returned.

randnum

Description:
Generates random integers.
Input:
min
An integer in the range [-1000000000,1000000000]. This is the minimum random integer which will be generated. The default minimum is 1. min must be less than max.
max
An integer in the range [-1000000000,1000000000]. This is the maximum random integer which will be generated. The default maximum is 100. max must be greater than min.
num
An integer in the range [1,10000]. This is the number of random integers to generate. The default is 100.
col
An integer in the range [1,10000]. This is the number of columns in which to print the random integers requested. The default number of columns is 5.
id
A 40-digit hexadecimal id number. This is the id number of the roll hash to update with the results of this request. The default is not to use an id.
Output:
A space-seperated list of random integers in the requested range, with the requested number of random integers per line.

randseq

Description:
Generates random permutations of an integer sequence.
Input:
min
An integer in the range [-1000000000,1000000000]. This is low end of the range to be permuted. There is no default minimum. min must be less than max, and the range must not exceed 10000 elements.
max
An integer in the range [-1000000000,1000000000]. This is the high end of the range to be permuted. There is no default maximum. max must be greater than min, and the range must not exceed 10000 elements.
col
An integer in the range [1,10000]. This is the number of columns in which to print the random integers requested. The default number of columns is 1.
id
A 40-digit hexadecimal id number. This is the id number of the roll hash to update with the results of this request. The default is not to use an id.
Output:
A space-separated list of integers which is a permutation of [min,max], with the requested number of integers per line.

randxbm

Description:
Generates random XBM bitmaps.
Input:
width
An integer in the range [1,512]. This is the width in pixels of the bitmap to be generated. The default width is 64.
height
An integer in the range [1,512]. This is the height in pixels of the bitmap to be generated. The default height is 64.
id
A 40-digit hexadecimal id number. This is the id number of the roll hash to update with the results of this request. The default is not to use an id.
Output:
A random XBM bitmap of the requested width and height.

randbyte

Description:
Generates random bytes.
Input:
nbytes
An integer in the range [1,16384]. This is the number of random bytes to be generated. The default is 256.
format
One of {f,h,d,o,b}. This is the format in which the bytes are to be printed, either in hexadecimal (h), decimal (d), octal (o), binary (b), or as raw bytes in a binary file (f) of MIME type application/octet-stream.
col
An integer in the range [1,16384]. This is the number of columns in which to print the random bytes requested. The default number of columns depends on the format: 16 for hexadecimal, decimal, and octal; and 8 for binary. col is ignored when the format is raw.
id
A 40-digit hexadecimal id number. This is the id number of the roll hash to update with the results of this request. The default is not to use an id.
Output:
A space-separated list of random bytes in the requested base, or a binary file, depending on the requested format.

randroll

Description:
Generates random die rolls specified in Bones dice-rolling language.
Input:
exp
An expression in the Bones dice-rolling language. See the Bones documentation for details.
num
An integer in the range [1,1000]. This is the number of times to evaluate the given expression. The default is 1.
col
An integer in the range [0,4294967295]. This is the number of collumns in which to print the die roll requested. If 0 is specified, then all rolls will be printed on one line, which is the default.
showexp
true or false. This determines whether a canonical version of the given expression is prepended to the output. The default is true.
id
A 40-digit hexadecimal id number. This is the id number of the roll hash to update with the results of this request. The default is not to use an id.
Output:
An (optional) canonical version of the given expression, followed by a space-separated list of rolls arranged in the requested number of columns.