rand (';' MIN ' (;' MAX )?)?

Summary

The rand macro generates a random integer. By default it returns a number between 0 and 100, or within a specified min/max range (inclusive).

Syntax

${rand[;<max>[;<min>]]}

Parameters

• max (optional) - Maximum value (default: 100)
• min (optional) - Minimum value (default: 0)

Behavior

• No arguments: Random number 0-100
• One argument: Random number 0 to max
• Two arguments: Random number min to max
• Range is inclusive (includes both min and max)
• Returns rounded integer

Examples

Default range (0-100):

${rand}
# Returns: 42 (example)

Custom max:

${rand;10}
# Returns: 7 (between 0-10)

Custom range:

${rand;100;50}
# Returns: 73 (between 50-100)

Generate unique build number:

build.number=${rand;9999;1000}

Use Cases

• Generating random test data
• Creating unique identifiers
• Random selection
• Build numbers
• Temporary values

Notes

• Range is inclusive on both ends
• Returns integer (rounded)
• Not cryptographically secure
• Each invocation generates new value
• See also: ${random} for random strings

See test cases in MacroTestsForDocsExamples.java