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.