cpp/algorithm/lexicographical compare three way

Lexicographically compares two ranges and  using three-way comparison and produces a result of the strongest applicable comparison category type.

@1@ Returns the order between the first non-equivalent pair of elements according to in both ranges if any, otherwise (if one ranges is equivalent to the prefix of another according to ), returns the order between the length of both ranges.

@2@ Equivalent to:

Return value
The value of a comparison category type specified above.

Complexity
At most N applications of, where N is the smaller of length of both ranges.