Instance Method

removeAll(where:)

Removes all the elements that satisfy the given predicate.

Declaration

mutating func removeAll(where shouldBeRemoved: (UInt8) throws -> Bool) rethrows

Parameters

shouldBeRemoved

A closure that takes an element of the sequence as its argument and returns a Boolean value indicating whether the element should be removed from the collection.

Discussion

Use this method to remove every element in a collection that meets particular criteria. The order of the remaining elements is preserved. This example removes all the vowels from a string:

var phrase = "The rain in Spain stays mainly in the plain."

let vowels: Set<Character> = ["a", "e", "i", "o", "u"]
phrase.removeAll(where: { vowels.contains($0) })
// phrase == "Th rn n Spn stys mnly n th pln."

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