文書 > Swift > Dictionary > randomElement(using:)

汎用インスタンスメソッド

randomElement(using:)

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

宣言

func randomElement<T>(using generator: inout T) -> (key: Key, value: Value)? 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 を使用してプログラムをコンパイルすると、そのシーケンスが変更される場合があります。