swirl Guide to OmniMark 6   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesOMX VariablesErrors
 
      Other Library Functions  
function   UTIL_UniformRand   Available in:
Professional
Enterprise

Library: omutil - miscellaneous system utilities
Include: omutil.xin
Return type: Integer
Returns:       

The next number in a pseudo-random sequence.


Declaration

  define external integer function UTIL_UniformRand
     (  value integer Val1,
        value integer Val1
     )


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 RAND_MAX (32767 on most platforms). 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
 
----  

Top [ INDEX ] [ CONCEPTS ] [ TASKS ] [ SYNTAX ] [ LIBRARIES ] [ OMX ] [ ERRORS ]

OmniMark 6.5 Documentation Generated: December 23, 2002 at 6:25:46 pm
If you have any comments about this section of the documentation, send email to [email protected]

Copyright © OmniMark Technologies Corporation, 1988-2002.