Difference between revisions of "RandomGenerator:setSeed"

(Moved example from love.math.setRandomSeed)
 
Line 23: Line 23:
 
=== Returns ===
 
=== Returns ===
 
Nothing.
 
Nothing.
 +
== Examples ==
 +
Creates a new RandomGenerator object, sets the seed to the system clock's time, then generates a number between 1 and 100 inclusive. Note that the seed can be any number within the range of [0, 2^53 - 1].
 +
<source lang="lua">
 +
function love.load()
 +
rng = love.math.newRandomGenerator()
 +
rng:setSeed(os.time())
 +
randomNumber = rng:random(1,100)
 +
end
 +
</source>
 
== See Also ==
 
== See Also ==
 
* [[parent::RandomGenerator]]
 
* [[parent::RandomGenerator]]

Latest revision as of 07:05, 18 December 2013

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

Sets the seed of the random number generator using the specified integer number.

Function

Synopsis

RandomGenerator:setSeed( seed )

Arguments

number seed
The integer number with which you want to seed the randomization. Must be within the range of [1, 2^53].

Returns

Nothing.

Notes

Due to Lua's use of double-precision floating point numbers, values above 2^53 cannot be accurately represented. Use the other variant of this function if your seed will have a larger value.

Function

Combines two 32-bit integer numbers into a 64-bit integer value and sets the seed of the random number generator using the value.

Synopsis

RandomGenerator:setSeed( low, high )

Arguments

number low
The lower 32 bits of the seed value. Must be within the range of [0, 2^32 - 1].
number high
The higher 32 bits of the seed value. Must be within the range of [0, 2^32 - 1].

Returns

Nothing.

Examples

Creates a new RandomGenerator object, sets the seed to the system clock's time, then generates a number between 1 and 100 inclusive. Note that the seed can be any number within the range of [0, 2^53 - 1].

function love.load()
	rng = love.math.newRandomGenerator()
	rng:setSeed(os.time())
	randomNumber = rng:random(1,100)
end

See Also

Other Languages