Spec-Zone.ru › C++

operator==,!=,<,<=,>,>=, <=>(std::multiset)

Определено в заголовке <set>
template< class Key, class Compare, class Alloc >
bool operator==( const std::multiset<Key, Compare, Alloc>& lhs,
                 const std::multiset<Key, Compare, Alloc>& rhs );
(1)
template< class Key, class Compare, class Alloc >
bool operator!=( const std::multiset<Key, Compare, Alloc>& lhs,
                 const std::multiset<Key, Compare, Alloc>& rhs );
(2) (до C++20)
template< class Key, class Compare, class Alloc >
bool operator<( const std::multiset<Key, Compare, Alloc>& lhs,
                const std::multiset<Key, Compare, Alloc>& rhs );
(3) (до C++20)
template< class Key, class Compare, class Alloc >
bool operator<=( const std::multiset<Key, Compare, Alloc>& lhs,
                 const std::multiset<Key, Compare, Alloc>& rhs );
(4) (до C++20)
template< class Key, class Compare, class Alloc >
bool operator>( const std::multiset<Key, Compare, Alloc>& lhs,
                const std::multiset<Key, Compare, Alloc>& rhs );
(5) (до C++20)
template< class Key, class Compare, class Alloc >
bool operator>=( const std::multiset<Key, Compare, Alloc>& lhs,
                 const std::multiset<Key, Compare, Alloc>& rhs );
(6) (до C++20)
template< class Key, class Compare, class Alloc >
/* see below */ operator<=>( const std::multiset<Key, Compare, Alloc>& lhs,
                             const std::multiset<Key, Compare, Alloc>& rhs );
(7) (с C++20)

Сравнивает содержимое двух multiset.

1,2) Проверяет, равны ли содержимое lhs и rhs, то есть, имеют ли они одинаковое количество элементов и каждый элемент в lhs сравнивается как равный элементу в rhs на той же позиции.
3-6) Сравнивает содержимое lhs и rhs лексикографически. Сравнение выполняется с помощью функции, эквивалентной std::lexicographical_compare. Это сравнение игнорирует порядок сортировки multiset.
7) Сравнивает содержимое lhs и rhs лексикографически. Сравнение выполняется как будто вызывается std::lexicographical_compare_three_way для двух multiset с объектом функции, выполняющим синтезированное сравнение по трём направлениям (см. ниже). Тип возвращаемого значения совпадает с типом результата синтезированного сравнения по трём направлениям. Это сравнение игнорирует порядок сортировки multiset.

Учитывая два const E значения lhs и rhs в качестве левого и правого операнда соответственно (где E есть Key), синтезированное сравнение по трём направлениям определяется как:

  • если выполняется условие std::three_way_comparable_with<E, E>, эквивалентно lhs <=> rhs;
  • в противном случае, если сравнение двух const E значений с помощью оператора< корректное и тип результата удовлетворяет boolean-testable, эквивалентно
lhs < rhs ? std::weak_ordering::less :
rhs < lhs ? std::weak_ordering::greater :
            std::weak_ordering::equivalent
  • в противном случае, синтезированное сравнение по трём направлениям не определено, и оператор<=> не участвует в разрешении перегрузки.
Поведение оператора<=> неопределено, если three_way_comparable_with или boolean-testable удовлетворены, но не моделируются, или оператор< используется, но E и < не устанавливают полную упорядоченность.

Операторы <, <=, >, >=, и != синтезируются из оператора<=> и оператора== соответственно.

(с C++20)

Параметры

lhs, rhs - multiset, содержимое которых сравнивается
-Key должны удовлетворять требованиям EqualityComparable, чтобы использовать перегрузки (1,2).

Возвращаемое значение

1) true если содержимое multiset равны, false в противном случае.
2) true если содержимое multiset не равны, false в противном случае.
3) true если содержимое lhs лексикографически меньше, чем содержимое rhs, false в противном случае.
4) true если содержимое lhs лексикографически меньше или равно содержимому rhs, false в противном случае.
5) true если содержимое lhs лексикографически больше, чем содержимое rhs, false в противном случае.
6) true если содержимое lhs лексикографически больше или равно содержимому rhs, false в противном случае.
7) Относительный порядок первой пары неэквивалентных элементов в lhs и rhs если такие элементы существуют, lhs.size() <=> rhs.size() в противном случае.

Сложность

1,2) Постоянная, если lhs и rhs имеют различный размер, в противном случае линейная от размера multiset.
3-7) Линейная от размера multiset.

Пример

#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 &&
    "");
}

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/container/multiset/operator_cmp

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API