文書 > Swift > Swift 標準ライブラリ > Collections > Supporting Types > Slice > randomElement(using:)

インスタンスメソッド

randomElement(using:)

与えられたジェネレータを乱数のソースとして使用して、コレクションのランダムな要素を返します。

宣言

func randomElement<T>(using generator: inout T) -> Base.Element? where T : 
	RandomNumberGenerator

パラメータ

generator

ランダム要素を選択するときに使用する乱数ジェネレータ。

戻り値

コレクションからのランダムな要素。コレクションが空の場合、このメソッドは nil を返します。

議論

カスタム乱数ジェネレータを使用しているときに、randomElement(using:) を呼び出して、配列または別のコレクションからランダムな要素を選択します。この例では、配列からランダムに名前を選択します。

let names = ["Zoey", "Chloe", "Amani", "Amaia"]
let randomName = names.randomElement(using: &myGenerator)!
// randomName == "Amani"

複雑さ：コレクションが RandomAccessCollection に準拠している場合は O(1)。それ以外の場合 O(n)、ここで n はコレクションの長さです。

注意：

ランダム要素を選択するために使用されるアルゴリズムは、将来のバージョンの Swift で変更される可能性があります。プログラムを実行するたびに同じシーケンスの要素を生成するジェネレータを渡す場合、異なるバージョンの Swift を使用してプログラムをコンパイルすると、そのシーケンスが変わることがあります。