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

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

Declaration

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

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"

Other Library Functions UTIL_Env UTIL_ExpRand UTIL_GetEnv UTIL_GetMilliSecondTimer UTIL_GetProcessId UTIL_IsVersionCompatible UTIL_LibraryVersion UTIL_Rand UTIL_Sleep UTIL_SortIntegersByKey UTIL_SortIntegersByValue UTIL_SortStreamsByKey UTIL_SortStreamsByValue UTIL_SortSwitchesByKey UTIL_Srand UTIL_UniformRand

[ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ LEGACY LIBRARIES ] [ ERRORS ]