Difference between revisions of "love.math.random"

m
m (I can make links, me)
(3 intermediate revisions by 3 users not shown)
Line 1: Line 1:
 
{{newin|[[0.9.0]]|090|type=function}}
 
{{newin|[[0.9.0]]|090|type=function}}
Generates a pseudo-random number in a platform independent manner.
+
Generates a pseudo-random number in a platform independent manner. The default [[love.run]] seeds this function at startup, so you generally don't need to seed it yourself.
 +
 
 
== Function ==
 
== Function ==
 
Get uniformly distributed pseudo-random real number within [0, 1].
 
Get uniformly distributed pseudo-random real number within [0, 1].
 +
 
=== Synopsis ===
 
=== Synopsis ===
 
<source lang="lua">
 
<source lang="lua">
Line 11: Line 13:
 
=== Returns ===
 
=== Returns ===
 
{{param|number|number|The pseudo-random number.}}
 
{{param|number|number|The pseudo-random number.}}
 +
 
== Function ==
 
== Function ==
 
Get a uniformly distributed pseudo-random integer within [1, max].
 
Get a uniformly distributed pseudo-random integer within [1, max].
Line 34: Line 37:
  
 
== Examples ==
 
== Examples ==
Generates a number between 1 and 100, inclusive.
+
Generates a number between 1 and 100 (both inclusive).
 
<source lang="lua">
 
<source lang="lua">
 
function love.load()
 
function love.load()

Revision as of 14:55, 4 October 2017

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. The default love.run seeds this function 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

See Also

Other Languages