UTIL_UniformRand

function

Library: Utilities (OMUTIL legacy)
Include: omutil.xin

Returns: The next number in a pseudo-random sequence.


Declaration
define external integer function UTIL_UniformRand
   (  value integer lower-bound,
      value integer lower-bound
   )


Purpose

This function gets the next number from a pseudo-random sequence. The returned value is an integer equal to Val1 or Val2 or any integer between them. The distribution of returned values over the range is uniform. The difference between Val1 and Val2 should not exceed UTIL_RAND_MAX (32767). If it does, not all discrete values in the range may be returned.

Example:

  ; display a random number between 10 and 20
  include "omutil.xin"
  process
     local integer RandVal
     set RandVal to UTIL_UniformRand(10, 20)
     output "The Nth random number is: %d(RandVal)%n"
     set RandVal to UTIL_UniformRand(10, 20)
     output "The (N+1)th random number is: %d(RandVal)%n"
     set RandVal to UTIL_UniformRand(10, 20)
     output "The (N+2)th random number is: %d(RandVal)%n"