random Method

Class: Number

Description

This method returns a pseudo-random integer between 0 and the number's value minus 1. For example, assume val is an integer value of the number. If val is less than 1, and exception is thrown. Otherwise, a pseudo-random number from the closed interval [0,val-1] is returned.

Syntax

NumberObject.random()

Parameters

None

 

Returns

An integer number.

When Became Available

Profile v7.0

Example

// A positive and a negative value to demonstrate behavior

type Number NONINT = 12345678.9876

type Number INT    = 12345678

 

Type Number TRY1 = INT.random()    // between 0 and 12345677

Type Number TRY2 = NONINT.random() // between 0 and 12345677

 

// compensate for possible 0 result from INT.random()

Type Number TRY3 = (TRY1 + 1).random()

 

// DO NOT TRY THIS IT IS LIKELY TO GENERATE AN EXCEPTION

Type Number MayBeNeg = TRY2 - TRY1

Type Number DONT = MayBeNeg.random()