Generic Instance Method

shuffle(using:)

Shuffles the collection in place, using the given generator as a source for randomness.

Declaration

mutating func shuffle<T>(using generator: inout T) where T : RandomNumberGenerator

Parameters

generator

The random number generator to use when shuffling the collection.

Discussion

You use this method to randomize the elements of a collection when you are using a custom random number generator. For example, you can use the shuffle(using:) method to randomly reorder the elements of an array.

var names = ["Alejandro", "Camila", "Diego", "Luciana", "Luis", "Sofía"]
names.shuffle(using: &myGenerator)
// names == ["Sofía", "Alejandro", "Camila", "Luis", "Diego", "Luciana"]

Complexity: O(n), where n is the length of the collection.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software