跳到主要内容

RandomGenerator

描述:

  一个随机数生成对象,有自己的随机状态。

type

类型: 函数。

描述:

  获取字符串形式的对象类型。

签名:

type: function(self: RandomGenerator): string

返回值:

返回类型描述
string字符串类型。

Of

类型: 函数。

描述:

  检查对象是否属于某种类型。如果对象的层次结构中具有指定名称的类型,则此函数将返回 true。

签名:

typeOf: function(self: RandomGenerator, type_name: string): boolean

参数:

参数名类型描述
type_namestring要检查的类型的名称。

返回值:

返回类型描述
boolean如果对象属于指定类型,则为 true,否则为 false。

release

类型: 函数。

描述:

  销毁对象的 Lua 引用。如果该对象未被任何其他 LÖVE 对象或线程引用,则该对象将被完全删除。 这个方法可以用来立即清理资源,而不需要等待Lua的垃圾收集器。

签名:

release: function(self: RandomGenerator): boolean

返回值:

返回类型描述
boolean如果对象已通过此调用释放,则为 true;如果先前已释放过该对象,则为 false。

random

类型: 函数。

描述:

  以独立于平台的方式生成伪随机数。

签名:

random: function(self: RandomGenerator): number

返回值:

返回类型描述
numbernumber — 伪随机数。

random

类型: 函数。

描述:

  以独立于平台的方式生成伪随机数。

签名:

random: function(self: RandomGenerator, upper: number): number

参数:

参数名类型描述
uppernumber它应该返回的最大可能值。

返回值:

返回类型描述
number伪随机整数。

random

类型: 函数。

描述:

  以独立于平台的方式生成伪随机数。

签名:

random: function(self: RandomGenerator, lower: number, upper: number): number

参数:

参数名类型描述
lowernumber它应该返回的最小可能值。
uppernumber它应该返回的最大可能值。

返回值:

返回类型描述
number伪随机整数。

randomNormal

类型: 函数。

描述:

  获取正态分布的伪随机数。

签名:

randomNormal: function(self: RandomGenerator, standard_deviation?: number, mean?: number): number

参数:

参数名类型描述
standard_deviationnumber分布的标准偏差。 (默认值:1。)
meannumber分布的平均值。 (默认值:0。)

返回值:

返回类型描述
number具有方差 (stddev)² 和指定平均值的正态分布随机数。

setSeed

类型: 函数。

描述:

  使用指定的整数设置随机数生成器的种子。

签名:

setSeed: function(self: RandomGenerator, seed: number)

参数:

参数名类型描述
seednumber您想要用于随机化种子的整数。必须在 2^53 范围内。

setSeed

类型: 函数。

描述:

  使用指定的整数设置随机数生成器的种子。

签名:

setSeed: function(self: RandomGenerator, low: number, high: number)

参数:

参数名类型描述
lownumber种子值的低 32 位。必须在 2^32 - 1 范围内。
highnumber种子值的高 32 位。必须在 2^32 - 1 范围内。

getSeed

类型: 函数。

描述:

  获取随机数生成器对象的种子。 由于 Lua 对所有数值都使用双精度数,因此种子被分成两个数字 - 双精度数无法准确表示 2^53 以上的整数值,但种子值是 2^64 - 1 范围内的整数。

签名:

getSeed: function(self: RandomGenerator): number, number

返回值:

返回类型描述
number表示 RandomGenerator 的 64 位种子值的低 32 位的整数。
number表示 RandomGenerator 的 64 位种子值的高 32 位的整数。

setState

类型: 函数。

描述:

  设置随机数生成器的当前状态。用作此函数参数的值是一个不透明字符串,并且只能源自 LÖVE 的同一主要版本中之前对 RandomGenerator:getState 的调用。 这与 RandomGenerator:setSeed 不同,setState 直接设置 RandomGenerator 的当前依赖于实现的状态,而 setSeed 为其提供新的种子值。 重载说明:

  1. 状态字符串的效果与当前操作系统无关。

签名:

setState: function(self: RandomGenerator, state: string)

参数:

参数名类型描述
statestringRandomGenerator 对象的新状态,表示为字符串。这应该源自之前对 RandomGenerator:getState 的调用。

getState

类型: 函数。

描述:

  获取随机数生成器的当前状态。这会返回一个不透明的字符串,该字符串仅适用于以后与 LÖVE 的相同主要版本中的 RandomGenerator:setState 一起使用。 这与 RandomGenerator:getSeed 不同,getState 获取 RandomGenerator 的当前状态,而 getSeed 获取之前设置的种子数。 重载说明:

  1. 状态字符串的值与当前操作系统无关。

签名:

getState: function(self: RandomGenerator): string

返回值:

返回类型描述
stringRandomGenerator 对象的当前状态,表示为字符串。