operator==,!=,<,<=,>,>=,<=>(std::multiset)
Defined in header <set>
|
||
template< class Key, class Compare, class Alloc > bool operator==( const std::multiset<Key, Compare, Alloc>& lhs, |
(1) | |
template< class Key, class Compare, class Alloc > bool operator!=( const std::multiset<Key, Compare, Alloc>& lhs, |
(2) | (until C++20) |
template< class Key, class Compare, class Alloc > bool operator<( const std::multiset<Key, Compare, Alloc>& lhs, |
(3) | (until C++20) |
template< class Key, class Compare, class Alloc > bool operator<=( const std::multiset<Key, Compare, Alloc>& lhs, |
(4) | (until C++20) |
template< class Key, class Compare, class Alloc > bool operator>( const std::multiset<Key, Compare, Alloc>& lhs, |
(5) | (until C++20) |
template< class Key, class Compare, class Alloc > bool operator>=( const std::multiset<Key, Compare, Alloc>& lhs, |
(6) | (until C++20) |
template< class Key, class Compare, class Alloc > /* see below */ operator<=>( const std::multiset<Key, Compare, Alloc>& lhs, |
(7) | (since C++20) |
Compares the contents of two multiset
s.
multiset
's ordering Compare.multiset
s with a function object performing synthesized three-way comparison (see below). The return type is same as the result type of synthesized three-way comparison. This comparison ignores the multiset
's ordering Compare.
Given two const E lvalues lhs and rhs as left hand operand and right hand operand respectively (where E
is Key
), synthesized three-way comparison is defined as:
- if std::three_way_comparable_with<E, E> is satisfied, equivalent to lhs <=> rhs;
- otherwise, if comparing two const E lvalues by operator< is well-formed and the result type satisfies
boolean-testable
, equivalent to
lhs < rhs ? std::weak_ordering::less : rhs < lhs ? std::weak_ordering::greater : std::weak_ordering::equivalent
- otherwise, synthesized three-way comparison is not defined, and operator<=> does not participate in overload resolution.
three_way_comparable_with
or boolean-testable
is satisfied but not modeled, or operator< is used but E
and <
do not establish a total order.
The |
(since C++20) |
Contents |
[edit] Parameters
lhs, rhs | - | multiset s whose contents to compare
|
-Key must meet the requirements of EqualityComparable in order to use overloads (1,2).
|
[edit] Return value
multiset
s are equal, false otherwise.multiset
s are not equal, false otherwise.[edit] Complexity
multiset
.multiset
.[edit] Example
#include <cassert> #include <set> int main() { const std::multiset a{1, 2, 3}, b{1, 2, 3}, c{7, 8, 9, 10}; assert ("" "Compare equal containers:" && (a != b) == false && (a == b) == true && (a < b) == false && (a <= b) == true && (a > b) == false && (a >= b) == true && (a <=> b) != std::weak_ordering::less && (a <=> b) != std::weak_ordering::greater && (a <=> b) == std::weak_ordering::equivalent && (a <=> b) >= 0 && (a <=> b) <= 0 && (a <=> b) == 0 && "Compare non equal containers:" && (a != c) == true && (a == c) == false && (a < c) == true && (a <= c) == true && (a > c) == false && (a >= c) == false && (a <=> c) == std::weak_ordering::less && (a <=> c) != std::weak_ordering::equivalent && (a <=> c) != std::weak_ordering::greater && (a <=> c) < 0 && (a <=> c) != 0 && (a <=> c) <= 0 && ""); }