目录

类

class Random

public open class Random

功能: 提供生成伪随机数的相关功能。

示例:

import std.random.*
main() {
    let m: Random = Random()
    /* 创建 Random 对象并设置种子来获取随机对象 */
    m.seed = 3
    let b: Bool = m.nextBool()
    let c: Int8 = m.nextInt8()
    print("b=${b is Bool},")/* 对象也可以是 Bool 类型 */
    println("c=${c is Int8}")
    return 0
}

运行结果:

b=true,c=true

[h2]prop seed

public open mut prop seed: UInt64

功能: 设置或者获取种子的大小，如果设置相同随机种子，生成的伪随机数列表相同。

类型：UInt64

[h2]init()

public init()

功能: 默认无参构造函数创建新的 Random 对象。

[h2]init(UInt64)

public init(seed: UInt64)

功能：使用随机数种子创建新的 Random 对象。

参数:

[h2]func next(UInt64)

public open func next(bits: UInt64): UInt64

功能: 生成一个用户指定位长的随机整数。

参数:

返回值：用户指定位长的伪随机数。

异常:

[h2]func nextBool()

public open func nextBool(): Bool

功能：获取一个布尔类型的伪随机值。

返回值：

[h2]func nextFloat16()

public open func nextFloat16(): Float16

功能：获取一个 Float16 类型的伪随机数，其范围为 [0.0, 1.0)。

返回值：

[h2]func nextFloat32()

public open func nextFloat32(): Float32

功能：获取一个 Float32 类型的伪随机数，其范围为 [0.0, 1.0)。

返回值：

[h2]func nextFloat64()

public open func nextFloat64(): Float64

功能：获取一个 Float64 类型的伪随机数，其范围为 [0.0, 1.0)。

返回值：

[h2]func nextGaussianFloat16(Float16, Float16)

public func nextGaussianFloat16(mean!: Float16 = 0.0, sigma!: Float16 = 1.0): Float16

功能：获取一个 Float16 类型的符合指定均值与标准差的高斯分布的随机数。

默认获取一个 Float16 类型且符合均值为 0.0 标准差为 1.0 的高斯分布的随机数。其中均值是期望值，可解释为位置参数，决定了分布的位置，标准差可解释为尺度参数，决定了分布的幅度。此函数调用了函数 nextGaussianFloat16Implement 得到返回值，所以当子类继承 Random 并覆写 nextGaussianFloat64Implement 函数时，调用子类的该函数将会返回覆写的函数的返回值。

参数：

返回值：

[h2]func nextGaussianFloat16Implement(Float16, Float16)

protected open func nextGaussianFloat16Implement(mean: Float16, sigma: Float16): Float16

功能: nextGaussianFloat16 的实现函数，获取一个 Float16 类型的符合指定均值与标准差的高斯分布的随机数。

获取一个 Float16 类型，且符合均值为 mean 标准差为 sigma 的高斯分布的随机数。其中均值是期望值，可解释为位置参数，决定了分布的位置，标准差可解释为尺度参数，决定了分布的幅度。此函数是 nextGaussianFloat16 的实现函数，非公开，当子类继承 Random 并覆写此函数时，调用子类的 nextGaussianFloat16 函数将会返回此函数的返回值。

参数：

返回值：

[h2]func nextGaussianFloat32(Float32, Float32)

public func nextGaussianFloat32(mean!: Float32 = 0.0, sigma!: Float32 = 1.0): Float32

功能：获取一个 Float32 类型的符合指定均值与标准差的高斯分布的随机数。

默认获取一个 Float32 类型且符合均值为 0.0 标准差为 1.0 的高斯分布的随机数。其中均值是期望值，可解释为位置参数，决定了分布的位置，标准差可解释为尺度参数，决定了分布的幅度。此函数调用了函数 nextGaussianFloat32Implement 得到返回值，所以当子类继承 Random 并覆写 nextGaussianFloat64Implement 函数时，调用子类的该函数将会返回覆写的函数的返回值。

参数：

返回值：

[h2]func nextGaussianFloat32Implement(Float32, Float32)

protected open func nextGaussianFloat32Implement(mean: Float32, sigma: Float32): Float32

功能: nextGaussianFloat32 的实现函数，获取一个 Float32 类型的符合指定均值与标准差的高斯分布的随机数。

获取一个 Float32 类型，且符合均值为 mean 标准差为 sigma 的高斯分布的随机数。其中均值是期望值，可解释为位置参数，决定了分布的位置，标准差可解释为尺度参数，决定了分布的幅度。此函数是 nextGaussianFloat32 的实现函数，非公开，当子类继承 Random 并覆写此函数时，调用子类的 nextGaussianFloat32 函数将会返回此函数的返回值。

参数：

返回值：

[h2]func nextGaussianFloat64(Float64, Float64)

public func nextGaussianFloat64(mean!: Float64 = 0.0, sigma!: Float64 = 1.0): Float64

功能：获取一个 Float64 类型的符合指定均值与标准差的高斯分布的随机数。

默认获取一个 Float64 类型且符合均值为 0.0 标准差为 1.0 的高斯分布的随机数。其中均值是期望值，可解释为位置参数，决定了分布的位置，标准差可解释为尺度参数，决定了分布的幅度。此函数调用了函数 nextGaussianFloat64Implement 得到返回值，所以当子类继承 Random 并覆写 nextGaussianFloat64Implement 函数时，调用子类的该函数将会返回覆写的函数的返回值。

参数：

返回值：

[h2]func nextGaussianFloat64Implement(Float64, Float64)

protected open func nextGaussianFloat64Implement(mean: Float64, sigma: Float64): Float64

功能: nextGaussianFloat64 的实现函数，获取一个 Float64 类型的符合指定均值与标准差的高斯分布的随机数。

获取一个 Float64 类型，且符合均值为 mean 标准差为 sigma 的高斯分布的随机数。其中均值是期望值，可解释为位置参数，决定了分布的位置，标准差可解释为尺度参数，决定了分布的幅度。此函数是 nextGaussianFloat64 的实现函数，非公开，当子类继承 Random 并覆写此函数时，调用子类的 nextGaussianFloat64 函数将会返回此函数的返回值。

参数：

返回值：

[h2]func nextInt16()

public open func nextInt16(): Int16

功能：获取一个 Int16 类型的伪随机数。

返回值：

[h2]func nextInt16(Int16)

public open func nextInt16(upper: Int16): Int16

功能：获取一个范围在 [0, upper) 的 Int16 类型的伪随机数。

参数：

返回值：

异常：

[h2]func nextInt32()

public open func nextInt32(): Int32

功能：获取一个 Int32 类型的伪随机数。

返回值：

[h2]func nextInt32(Int32)

public open func nextInt32(upper: Int32): Int32

功能：获取一个范围在 [0, upper) 的 Int32 类型的伪随机数。

参数：

返回值：

异常：

[h2]func nextInt64()

public open func nextInt64(): Int64

功能：获取一个 Int64 类型的伪随机数。

返回值：

[h2]func nextInt64(Int64)

public open func nextInt64(upper: Int64): Int64

功能：获取一个范围在 [0, upper) 的 Int64 类型的伪随机数。

参数：

返回值：

异常：

[h2]func nextInt8()

public open func nextInt8(): Int8

功能：获取一个 Int8 类型的伪随机数。

返回值：

[h2]func nextInt8(Int8): Int8

public open func nextInt8(upper: Int8): Int8

功能：获取一个范围在 [0, upper) 的 Int8 类型的伪随机数。

参数：

返回值：

异常：

[h2]func nextUInt16()

public open func nextUInt16(): UInt16

功能：获取一个 UInt16 类型的伪随机数。

返回值：

[h2]func nextUInt16(UInt16)

public open func nextUInt16(upper: UInt16): UInt16

功能：获取一个范围在 [0, upper) 的 UInt16 类型的伪随机数。

参数：

返回值：

异常：

[h2]func nextUInt32()

public open func nextUInt32(): UInt32

功能：获取一个 UInt32 类型的伪随机数。

返回值：

[h2]func nextUInt32(UInt32)

public open func nextUInt32(upper: UInt32): UInt32

功能：获取一个范围在 [0, upper) 的 UInt32 类型的伪随机数。

参数：

返回值：

异常：

[h2]func nextUInt64()

public open func nextUInt64(): UInt64

功能：获取一个 UInt64 类型的伪随机数。

返回值：

[h2]func nextUInt64(UInt64)

public open func nextUInt64(upper: UInt64): UInt64

功能：获取一个范围在 [0, upper) 的 UInt64 类型的伪随机数。

参数：

返回值：

异常：

[h2]func nextUInt8()

public open func nextUInt8(): UInt8

功能：获取一个 UInt8 类型的伪随机数。

返回值：

[h2]func nextUInt8(UInt8)

public open func nextUInt8(upper: UInt8): UInt8

功能：获取一个范围在 [0, upper) 的 UInt8 类型的伪随机数。

参数：

返回值：

异常：

[h2]func nextUInt8s(Array<UInt8>)

public open func nextUInt8s(array: Array<UInt8>): Array<UInt8>

功能：生成随机数替换入参数组中的每个元素。

参数：

返回值：