cpp/algorithm/adjacent find

Searches the range for two consecutive equal elements.

@1@ Elements are compared using. @3@ Elements are compared using the given binary predicate. @2,4@ Same as, but executed according to.

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

If no such elements are found, is returned.

Complexity
@1,3@ Exactly applications of the predicate where  is the return value. @2,4@ applications of the corresponding predicate.