Rex-EMoolator-docs/docs/en/reference/RAND.md

RAND

The built-in pseudo-random number generator. Available under the global name RAND from any context, and also under the alias RANDOM (see Built-in objects).

Methods

GET

INTEGER GET(INTEGER range)
INTEGER GET(INTEGER offset, INTEGER range)

Returns a pseudo-random number.

• The one-argument form returns a value from [0, range).
• The two-argument form returns a value from [offset, offset + range).

If range is less than or equal to 0, offset is returned (or 0 in the one-argument form).

Parameters

• offset — start of the range (inclusive), default 0.
• range — size of the range (the upper bound is exclusive).

Returns: the generated random value.

Examples

RANDOM^GET(100);
RANDOM^GET(VARI_TMP3);
RANDOM^GET(0, 3);

GETPLENTY

void GETPLENTY(STRING arrayName, INTEGER count, INTEGER offset, INTEGER range, BOOL onlyUnique)

Generates count pseudo-random integers from the range [offset, offset + range) and appends them to the array named arrayName. The array is not cleared before appending.

If onlyUnique is TRUE, every generated value must be different from the previously generated ones; if the requested number of unique values exceeds the range size (count > range), the method leaves the array unchanged. For count less than 1, the method also has no effect.

Parameters

• arrayName — name of the target ARRAY variable.
• count — number of elements to generate.
• offset — start of the range (inclusive).
• range — size of the range (the upper bound is exclusive).
• onlyUnique — TRUE to enforce uniqueness among the generated values.