dropFirst(_:)

Omits a specified number of elements from the base asynchronous sequence, then passes through all remaining elements.

iOS
13.0+
macOS
10.15+
tvOS
13.0+
watchOS
6.0+
func dropFirst(_ count: Int = 1) -> AsyncDropFirstSequence<Self>

Parameters

count

The number of elements to drop from the beginning of the sequence. count must be greater than or equal to zero.

Returns

An asynchronous sequence that drops the first count elements from the base sequence.

Use dropFirst(_:) when you want to drop the first n elements from the base sequence and pass through the remaining elements.

In this example, an asynchronous sequence called Counter produces Int values from 1 to 10. The dropFirst(_:) method causes the modified sequence to ignore the values 1 through 3, and instead emit 4 through 10:

for await number in Counter(howHigh: 10).dropFirst(3) {
    print(number, terminator: " ")
}
// Prints "4 5 6 7 8 9 10 "

If the number of elements to drop exceeds the number of elements in the sequence, the result is an empty sequence.