random

returns a random integer.

# Metadata

Platforms: desktop, server, mobile OS: mac, windows, linux, ios, android Introduced: 1.0 Security:

# Syntax

the random of upperLimit

# Params

- upperLimit : Any positive number that would be rounded to an integer greater than or equal to 1.

# Examples

random(22) -- returns a number between 1 and 22

random(item 1 of field "Numbers")

sort lines of myVar by random(the number of lines of myVar)

# Description

Use the random function to pick a random member of a set, or to generate a random number.

If the upperLimit is a positive integer, the random function returns an integer between 1 and the upperLimit. If the upperLimit is a number that is not an integer, the random function returns an integer between 1 and round(upperLimit).

To generate a random number between two integers, use a handler like this:

function randomInRange lowerLimit,upperLimit return random(upperLimit - lowerLimit + 1) + lowerLimit - 1 end randomInRange

# Tags

math,

# See

- **keyword:** any, integer - **property:** randomSeed - **function:** round, random - **glossary:** return - **control structure:** function