Instance Method

forEach(_:)

Calls the given closure on each element in the sequence in the same order as a for-in loop.

Declaration

func forEach(_ body: ((key: Key, value: Value)) throws -> Void) rethrows

Parameters

body: A closure that takes an element of the sequence as a parameter.

Discussion

The two loops in the following example produce the same output:

let numberWords = ["one", "two", "three"]
for word in numberWords {
    print(word)
}
// Prints "one"
// Prints "two"
// Prints "three"

numberWords.forEach { word in
    print(word)
}
// Same as above

Using the forEach method is distinct from a for-in loop in two important ways:

You cannot use a break or continue statement to exit the current call of the body closure or skip subsequent calls.
Using the return statement in the body closure will exit only from the current call to body, not from any outer scope, and won’t skip subsequent calls.

See Also

Iterating over Keys and Values

func enumerated() -> EnumeratedSequence<Dictionary<Key, Value>>

Returns a sequence of pairs (n, x), where n represents a consecutive integer starting at zero and x represents an element of the sequence.

var lazy: LazySequence<Dictionary<Key, Value>>

A sequence containing the same elements as this sequence, but on which some operations, such as map and filter, are implemented lazily.

func makeIterator() -> Dictionary<Key, Value>.Iterator

Returns an iterator over the dictionary’s key-value pairs.

var underestimatedCount: Int

A value less than or equal to the number of elements in the collection.