AdjacentPairs.md

AdjacentPairs

• Author(s): László Teveli

[Source | Tests]

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

extensionAsyncSequence{publicfunc 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.

forawait(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.