love.math.random

Available since LÖVE 0.9.0
This function is not supported in earlier versions.

Generates a pseudo-random number in a platform independent manner. This function is seeded at startup, so you generally don't need to seed it yourself.

Function

Get uniformly distributed pseudo-random real number within [0, 1].

Synopsis

number = love.math.random( )

Arguments

None.

Returns

number number

The pseudo-random number.

Function

Get a uniformly distributed pseudo-random integer within [1, max].

Synopsis

number = love.math.random( max )

Arguments

number max

The maximum possible value it should return.

Returns

number number

The pseudo-random integer number.

Function

Get uniformly distributed pseudo-random integer within [min, max].

Synopsis

number = love.math.random( min, max )

Arguments

number min

The minimum possible value it should return.

number max

The maximum possible value it should return.

Returns

number number

The pseudo-random integer number.

Examples

Generates a number between 1 and 100 (both inclusive).

function love.load()
    randomNumber = love.math.random(1, 100)
end

Notes

When using the 2nd and 3rd variant, numbers passed will be rounded, thus, love.math.random(0, 76.767) may return 77

See Also

• love.math
• love.math.setRandomSeed
• love.math.randomNormal
• love.math.newRandomGenerator