24 Containers library [containers]

24.2 Requirements [container.requirements]

24.2.2 General containers [container.requirements.general]

24.2.2.4 Optional container requirements [container.opt.reqmts]

The following operations are provided for some types of containers but not others.

Those containers for which the listed operations are provided shall implement the semantics as described unless otherwise stated.

If the iterators passed to lexicographical_compare_three_way meet the constexpr iterator requirements ([iterator.requirements.general]) then the operations described below are implemented by constexpr functions.

🔗

a <=> b

Result: synth-three-way-result<X::value_type>.

Preconditions: Either T models three_way_comparable, or < is defined for values of type (possibly const) T and < is a total ordering relationship.

Returns: lexicographical_compare_three_way(a.begin(), a.end(), b.begin(), b.end(),
synth-three-way)

[Note 1:

The algorithm lexicographical_compare_three_way is defined in [algorithms].

— end note]

Complexity: Linear.