Instance Method

contains(where:)

Returns a Boolean value indicating whether the sequence contains an element that satisfies the given predicate.

Declaration

func contains(where predicate: (Element) throws -> Bool) rethrows -> Bool

Parameters

predicate

A closure that takes an element of the sequence as its argument and returns a Boolean value that indicates whether the passed element represents a match.

Return Value

true if the sequence contains an element that satisfies predicate; otherwise, false.

Discussion

You can use the predicate to check for an element of a type that doesn’t conform to the Equatable protocol, such as the HTTPResponse enumeration in this example.

enum HTTPResponse {
    case ok
    case error(Int)
}

let lastThreeResponses: [HTTPResponse] = [.ok, .ok, .error(404)]
let hadError = lastThreeResponses.contains { element in
    if case .error = element {
        return true
    } else {
        return false
    }
}
// 'hadError' == true

Alternatively, a predicate can be satisfied by a range of Equatable elements or a general condition. This example shows how you can check an array for an expense greater than $100.

let expenses = [21.37, 55.21, 9.32, 10.18, 388.77, 11.41]
let hasBigPurchase = expenses.contains { $0 > 100 }
// 'hasBigPurchase' == true

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

See Also

Finding Elements

func contains(Element) -> Bool

Returns a Boolean value indicating whether the sequence contains the given element.

func allSatisfy((Element) -> Bool) -> Bool

Returns a Boolean value indicating whether every element of a sequence satisfies a given predicate.

func first(where: (Element) -> Bool) -> Element?

Returns the first element of the sequence that satisfies the given predicate.

func firstIndex(of: Element) -> Int?

Returns the first index where the specified value appears in the collection.

func firstIndex(where: (Element) -> Bool) -> Int?

Returns the first index in which an element of the collection satisfies the given predicate.

func last(where: (Element) -> Bool) -> Element?

Returns the last element of the sequence that satisfies the given predicate.

func lastIndex(of: Element) -> Int?

Returns the last index where the specified value appears in the collection.

func lastIndex(where: (Element) -> Bool) -> Int?

Returns the index of the last element in the collection that matches the given predicate.

func min() -> Element?

Returns the minimum element in the sequence.

func min(by: (Element, Element) -> Bool) -> Element?

Returns the minimum element in the sequence, using the given predicate as the comparison between elements.

func max() -> Element?

Returns the maximum element in the sequence.

func max(by: (Element, Element) -> Bool) -> Element?

Returns the maximum element in the sequence, using the given predicate as the comparison between elements.