Generic Instance Method 総称体インスタンスメソッド

randomElement(using:)

Returns a random element of the collection, using the given generator as a source for randomness. コレクションのある無作為な要素を返します、与えられた生成子を無作為さの出典として使って使います。

Declaration 宣言 

func randomElement<T>(using generator: inout T) -> (key: Key, value: Value)? where T : RandomNumberGenerator

Parameters パラメータ

generator

The random number generator to use when choosing a random element. ある無作為な要素を選ぶときに使う無作為数生成子。

Return Value 戻り値

A random element from the collection. If the collection is empty, the method returns nil. このコレクションからのある無作為の要素。コレクションが空ならば、このメソッドはnilを返します。

Discussion 解説

Call randomElement(using:) to select a random element from an array or another collection when you are using a custom random number generator. This example picks a name at random from an array: randomElement(using:)を呼び出して、あなたがあつらえの無作為数生成子を使っている場合に、ある無作為な要素を配列または別のコレクションから選んでください。この例は、ある名前を無作為に配列から選出します。 


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

Complexity: O(1) if the collection conforms to RandomAccessCollection; otherwise, O(n), where n is the length of the collection. 計算量：O(1)、もしコレクションがRandomAccessCollectionに準拠するならば；そうでなければ、O(n)、そこでnはコレクションの長さです。

See Also 参照

Accessing Keys and Values キーと値にアクセスする

subscript(Key) -> Value?
Accesses the value associated with the given key for reading and writing. 与えられたキーに結び付けられる値に読出しと書き込みのためにアクセスします。
subscript(Key, default() -> Value) -> Value
Accesses the value with the given key, falling back to the given default value if the key isn’t found. 値にこの与えられたキーでアクセスします、キーが見つけられないならばその与えられた省略時の値まで後退します。
func index(forKey: Key) -> Dictionary<Key, Value>.Index?
Returns the index for the given key. 与えられたキーに対するインデックスを返します。
subscript(Dictionary<Key, Value>.Index) -> Dictionary<Key, Value>.Element
Accesses the key-value pair at the specified position. 指定された位置でキー値ペアにアクセスします。
var keys: Dictionary<Key, Value>.Keys
A collection containing just the keys of the dictionary. 辞書のキーだけを含んでいるコレクション。
var values: Dictionary<Key, Value>.Values
A collection containing just the values of the dictionary. 辞書の値だけを含んでいるコレクション。
var first: (key: Key, value: Value)?
The first element of the collection. コレクションの最初の要素。
func randomElement() -> (key: Key, value: Value)?
Returns a random element of the collection. コレクションのある無作為の要素を返します。