StructureSwift

SystemRandomNumberGenerator

The system’s default source of random data.

@frozen struct SystemRandomNumberGenerator

Overview

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.

Members

Initializers

  • init()

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

Instance Methods

Conforms To

Removed Members

Instance Methods