613-518-1166 info@zimdatabases.com
Select Page

# \$random

Generates a pseudo-random number, uniformly distributed within the range 0 to 1.

\$random(number)

### Parameters

 number a number, or an expression that evaluates to a number, that acts as a seed for the random number generator

### Return Value

Number, with the same number of decimal places as number.

### Comments

Use \$random to generate a series of random numbers, by calling the function first with a seed value, and thereafter with \$Null. The value returned by \$random is a number in the range 0 to 1, with the same number of decimal places as number.

To pass the null property to \$random, create a variable of a number data type (INT, LONGINT, VASTINT, numeric) and with the desired number of decimal places. Use this variable on subsequent calls to \$random after seeding. (Remember that an uninitialized variable is always \$Null.)

If you seed the random number generator with the same number on two or more different occasions, you obtain the same series of “random” numbers on the first call and subsequent (\$Null) calls to \$random.

Under some operating systems, the seed number is ignored; an internally generated seed is used instead.

When number is \$Null, the random number generator is not reseeded.

### Example

let seed = 9.999
let i = \$random(seed)  % i might be set to 0.798 here
let seed = \$null
let i = \$random(seed)  % i might be set to 0.768 here

let i = \$time
let i = \$random(i)       % first call
:
let i = \$random(UninitVariable) % subsequent calls

Notice that \$random(\$time) always returns 0 or 1, because \$Time has no decimal places. Variable i is used to provide the necessary decimal places.

Was this article helpful?
###### 0 out Of 5 Stars
 5 Stars 0% 4 Stars 0% 3 Stars 0% 2 Stars 0% 1 Stars 0%
##### How can we improve this article?
Table of Contents