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

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

randomElement(using:)

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

宣言

func randomElement<T>(using generator: inout T) -> 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 を使用してコンパイルされたときにそのシーケンスが変わる可能性があります。