cpp/utility/expected/operator cmp

Performs comparison operations on objects.

@1,2@ Compares two objects. The objects compare equal if and only if and  are equal, and the contained values are equal.
 * For overload, if the expressions and  are not well-formed, or if their results are not convertible to , the program is ill-formed.
 * For overload, if the expressions is not well-formed, or if its result is not convertible to , the program is ill-formed.

@3@ Compares object with a value. The objects compare equal if and only if contains an expected value, and the contained value is equal to.
 * If the expression is not well-formed, or if its result is not convertible to, the program is ill-formed.

@4@ Compares object with an unexpected value. The objects compare equal if and only if contains an unexpected value, and the contained value is equal to.
 * If the expression is not well-formed, or if its result is not convertible to, the program is ill-formed.

Return value
@1@ If, returns. Otherwise, if is true, returns. Otherwise, returns.

@2@ If, returns. Otherwise, if is true, returns. Otherwise, returns.

@3@ Returns.

@4@ Returns.

Exceptions
Throws when and what the comparison throws.