Skip to content

Latest commit

 

History

History
31 lines (20 loc) · 978 Bytes

randomint.markdown

File metadata and controls

31 lines (20 loc) · 978 Bytes
layout title published tags
default
randomint
true
reference
data functions
functions
randomint

[%CFEngine_function_prototype(lower, upper)%]

Description: Returns a random integer between lower and up to but not including upper.

The limits must be integer values and the resulting numbers are based on the entropy of the md5 algorithm.

The upper limit is excluded from the range. Thus randomint(0, 100) will return 100 possible values, not 101.

The function will be re-evaluated on each pass if it is not restricted with a context class expression as shown in the example.

NOTE: The randomness produced by randomint is not safe for cryptographic usage.

[%CFEngine_function_attributes(lower, upper)%]

Example:

[%CFEngine_include_snippet(randomint.cf, #+begin_src cfengine3, .*end_src)%]

Output: (when show_random is defined)

[%CFEngine_include_snippet(randomint.cf, #+begin_src\s+show_random_example_output\s*, .*end_src)%]