OR-5269 Operators:: Sequence Operators:: Finding values:: max(by:)

[crazymanish]

Context

• Close ticket: [w25(18june-24june)] Operators:: Sequence Operators: Finding values #32

Operators are publishers

• In Combine, methods that perform an operation on values coming from a publisher are called operators.
• Each Combine operator actually returns a publisher. Generally speaking, that publisher receives the upstream values, manipulates the data, and then sends that data downstream.

Sequence operators

• Sequence operators are easiest to understand when you realize that publishers are just sequences themselves.
• Sequence operators work with the collection of a publisher’s values, much like an array or set — which, of course, are just finite sequences!

Finding values

• This file consists of operators that locate specific values the publisher emits based on different criteria.
• These are similar to the collection methods in the Swift standard library.

In this PR

• Operators:: Sequence Operators:: Finding values:: max(by:)
• max(by:) Publishes the maximum value received from the upstream publisher, using the provided ordering closure.
• A closure that receives two elements and returns true if they’re in increasing order.
• https://developer.apple.com/documentation/combine/publishers/reduce/max(by:)