File: BitArray%2BRandomBits.swift

package info (click to toggle)
swiftlang 6.0.3-2
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 2,519,992 kB
  • sloc: cpp: 9,107,863; ansic: 2,040,022; asm: 1,135,751; python: 296,500; objc: 82,456; f90: 60,502; lisp: 34,951; pascal: 19,946; sh: 18,133; perl: 7,482; ml: 4,937; javascript: 4,117; makefile: 3,840; awk: 3,535; xml: 914; fortran: 619; cs: 573; ruby: 573
file content (38 lines) | stat: -rw-r--r-- 1,491 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
//===----------------------------------------------------------------------===//
//
// This source file is part of the Swift Collections open source project
//
// Copyright (c) 2022 - 2024 Apple Inc. and the Swift project authors
// Licensed under Apache License v2.0 with Runtime Library Exception
//
// See https://swift.org/LICENSE.txt for license information
//
//===----------------------------------------------------------------------===//

extension BitArray {
  /// Create and return a new bit array consisting of `count` random bits,
  /// using the system random number generator.
  ///
  /// - Parameter count: The number of random bits to generate.
  public static func randomBits(count: Int) -> BitArray {
    var rng = SystemRandomNumberGenerator()
    return randomBits(count: count, using: &rng)
  }

  /// Create and return a new bit array consisting of `count` random bits,
  /// using the given random number generator.
  ///
  /// - Parameter count: The number of random bits to generate.
  /// - Parameter rng: The random number generator to use.
  public static func randomBits(
    count: Int,
    using rng: inout some RandomNumberGenerator
  ) -> BitArray {
    precondition(count >= 0, "Invalid count")
    guard count > 0 else { return BitArray() }
    let (w, b) = _BitPosition(count).endSplit
    var words = (0 ... w).map { _ in _Word(rng.next() as UInt) }
    words[w].formIntersection(_Word(upTo: b))
    return BitArray(_storage: words, count: count)
  }
}