Instance Method

removeAll(where:)

Removes all the elements that satisfy the given predicate.

Declaration

mutating func removeAll(where shouldBeRemoved: (Element) 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.

See Also

Removing Elements

func remove(at: Int) -> Element

Removes and returns the element at the specified position.

func removeFirst() -> Element

Removes and returns the first element of the collection.

func removeFirst(Int)

Removes the specified number of elements from the beginning of the collection.

func removeLast() -> Element

Removes and returns the last element of the collection.

func removeLast(Int)

Removes the specified number of elements from the end of the collection.

func removeSubrange(Range<Int>)

Removes the elements in the specified subrange from the collection.

func removeSubrange<R>(R)

Removes the elements in the specified subrange from the collection.

func removeAll(keepingCapacity: Bool)

Removes all elements from the array.

func popLast() -> Element?

Removes and returns the last element of the collection.