The system’s default source of random data.

    @frozen struct SystemRandomNumberGenerator

    When you generate random values, shuffle a collection, or perform another operation that depends on random data, this type is the generator used by default. For example, the two method calls in this example are equivalent:

    let x = Int.random(in: 1...100)
    var g = SystemRandomNumberGenerator()
    let y = Int.random(in: 1...100, using: &g)

    SystemRandomNumberGenerator is automatically seeded, is safe to use in multiple threads, and uses a cryptographically secure algorithm whenever possible.

    Platform Implementation of SystemRandomNumberGenerator

    While the system generator is automatically seeded and thread-safe on every platform, the cryptographic quality of the stream of random data produced by the generator may vary. For more detail, see the documentation for the APIs used by each platform.

    • Apple platforms use arc4random_buf(3).

    • Linux platforms use getrandom(2) when available; otherwise, they read from /dev/urandom.

    • Windows uses BCryptGenRandom.

    Citizens in Swift



    • init()

      Creates a new instance of the system’s default random number generator.

    • func next() -> UInt64

      Returns a value from a uniform, independent distribution of binary data.