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

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

shuffled(using:)

乱数の発生源として与えられた発生器を使用して、シャッフルされたシーケンスの要素を返します。

宣言

func shuffled<T>(using generator: inout T) -> [Element] where T : RandomNumberGenerator

パラメータ

generator

シーケンスをシャッフルするときに使用する乱数発生器。

戻り値

このシーケンスの要素をシャッフルされた順に並べた配列。

議論

カスタムの乱数発生器を使用している場合は、このメソッドを使用してシーケンスの要素をランダム化します。たとえば、0 から 9 までのの範囲で shuffled(using:) メソッドを呼び出すことで、その範囲の数字をシャッフルすることができます。

let numbers = 0...9
let shuffledNumbers = numbers.shuffled(using: &myGenerator)
// shuffledNumbers == [8, 9, 4, 3, 2, 6, 7, 0, 5, 1]

複雑さ：O(n)、ここで n はシーケンスの長さです。

注意：

シーケンスをシャッフルするために使用されるアルゴリズムは、Swift の将来のバージョンで変更される可能性があります。プログラムを実行するたびに同じシャッフル順序になる発生器を渡すと、プログラムが異なるバージョンの Swift を使用してコンパイルされたときにそのシーケンスが変わる可能性があります。