cpp/algorithm/ranges/adjacent find

Searches the range for two consecutive equal elements.

@1@ Elements are compared using (after projecting with the projection ). @2@ Same as, but uses as the source range, as if using  as  and  as.

Return value
An iterator to the first of the first pair of identical elements, that is, the first iterator such that  is.

If no such elements are found, an iterator equal to is returned.

Complexity
Exactly applications of the predicate and projection where  is the return value.