Files
Faris Basha TM 088f92a30c Fix dead links to moved source files and the Collections guide (#469)
The channel and debounce sources moved into Channels/ and Debounce/,
AsyncChunksOfCountAndSignalSequence.swift is now
AsyncChunksOfCountOrSignalSequence.swift, and the Collections guide
lives in the DocC catalog, so these links return 404.
2026-11-18 06:44:13 -08:00

2.3 KiB

AdjacentPairs

Introduction

The adjacentPairs() API serve the purpose of collecting adjacent values. This operation is available for any AsyncSequence by calling the adjacentPairs() method.

extension AsyncSequence {
  public func adjacentPairs() -> AsyncAdjacentPairsSequence<Self>
}

Detailed Design

The adjacentPairs() algorithm produces elements of tuple (size of 2), containing a pair of the original Element type.

The interface for this algorithm is available on all AsyncSequence types. The returned AsyncAdjacentPairsSequence conditionally conforms to Sendable.

Its iterator keeps track of the previous element returned in the next() function and updates it in every turn.

for await (first, second) in (1...5).async.adjacentPairs() {
   print("First: \(first), Second: \(second)")
}

// First: 1, Second: 2
// First: 2, Second: 3
// First: 3, Second: 4
// First: 4, Second: 5

It composes well with the Dictionary.init(_:uniquingKeysWith:) API that deals with AsyncSequence of tuples.

Dictionary(uniqueKeysWithValues: url.lines.adjacentPairs())

Alternatives Considered

This functionality is often written as a zip of a sequence together with itself, dropping its first element (zip(source, source.dropFirst())).

It's such a dominant use-case, the swift-algorithms package also introduced it to its collection of algorithms.

Credits/Inspiration

The synchronous counterpart in swift-algorithms.