swirl
Guide to OmniMark 8   OmniMark home
docs home 
IndexConceptsTasksSyntaxLibrariesLegacy LibrariesErrors
 
      Other Library Functions  
function  

UTIL_UniformRand

 
 

Library: Utilities (OMUTIL) legacy library
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
   )


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"

        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 ] [ LEGACY LIBRARIES ] [ ERRORS ]

OmniMark 8.2.0 Documentation Generated: March 13, 2008 at 3:27:39 pm
If you have any comments about this section of the documentation, please use this form.

Copyright © Stilo International plc, 1988-2008.