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

Return type: Integer Returns: A pseudo-random number between 0 and UTIL_RAND_MAX.

Declaration

define external integer function UTIL_Rand

This function returns a pseudo-random number between 0 and UTIL_RAND_MAX (32767).

Example:

  ; In this example, the time is used as a seed to generate a random number. The output shows the random number
  ; UTIL_Srand is a function that needs to be called to generate the seed for UTIL_Rand.
  
  include "omutil.xin"
  process
  
     local integer seed initial {0}
     local integer RandomNumber initial {0}
  
     set seed to UTIL_GetMilliSecondTimer
     UTIL_Srand(seed)   ; sets the seed
  
     set RandomNumber to UTIL_Rand
     output "Random Number = " || "d" % RandomNumber

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 ]