Namespaces
Variants

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

    Из ru.cppreference.net
     
    C++
    Поддержка компиляторов
    Автономный и размещённый
    Язык
    Стандартная библиотека
    Заголовки стандартной библиотеки
    Именованные требования
    Макросы тестирования возможностей (C++20)
    Библиотека поддержки языка
    Библиотека концепций (C++20)
    Библиотека диагностики
    Библиотека управления памятью
    Библиотека метапрограммирования (C++11)
    Библиотека общих утилит
    Библиотека контейнеров
    Библиотека итераторов
    Библиотека диапазонов (C++20)
    Библиотека алгоритмов
    Библиотека строк
    Библиотека обработки текста
    Библиотека численных операций
    Библиотека даты и времени
    Библиотека ввода/вывода
    Библиотека файловой системы (C++17)
    Библиотека поддержки параллелизма (C++11)
    Библиотека управления выполнением (C++26)
    Технические спецификации
    Указатель символов
    Внешние библиотеки
     
    Библиотека утилит
    Поддержка языка
    Поддержка типов (базовые типы, RTTI)
    Макросы тестирования возможностей библиотеки (C++20)
    Утилиты программы
    Функции с переменным числом аргументов
    (C++11)
    (C++20)
    (C++26)
    (C++20)
    Поддержка корутин (C++20)
    Поддержка контрактов (C++26)
    Трёхстороннее сравнение
    (C++20)(C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)
    (C++20)    
    (C++20)(C++20)(C++20)    
    (C++20)(C++20)(C++20)

    Общие утилиты
    Операторы отношений (устарело в C++20)
     
    std::variant
     
    Определён в заголовке <variant> 
    template< class... Types >
constexpr bool operator==( const std::variant<Types...>& lhs,
                           const std::variant<Types...>& rhs );
    		(1) (начиная с C++17) 
    template< class... Types >
constexpr bool operator!=( const std::variant<Types...>& lhs,
                           const std::variant<Types...>& rhs );
    		(2) (начиная с C++17) 
    template< class... Types >
constexpr bool operator<( const std::variant<Types...>& lhs,
                          const std::variant<Types...>& rhs );
    		(3) (начиная с C++17) 
    template< class... Types >
constexpr bool operator>( const std::variant<Types...>& lhs,
                          const std::variant<Types...>& rhs );
    		(4) (начиная с C++17) 
    template< class... Types >
constexpr bool operator<=( const std::variant<Types...>& lhs,
                           const std::variant<Types...>& rhs );
    		(5) (начиная с C++17) 
    template< class... Types >
constexpr bool operator>=( const std::variant<Types...>& lhs,
                           const std::variant<Types...>& rhs );
    		(6) (начиная с C++17) 
    template< class... Types >
constexpr std::common_comparison_category_t
              <std::compare_three_way_result_t<Types>...>
    operator<=>( const std::variant<Types...>& lhs,
                 const std::variant<Types...>& rhs );
    		(7) (начиная с C++20)
    Вспомогательный шаблон функции
    		 
    template< std::size_t I, class... Types >
constexpr const std::variant_alternative_t<I, std::variant<Types...>>&
    GET( const variant<Types...>& v );
    		(8) (только для демонстрации*)

    Выполняет операции сравнения для объектов std::variant.

    1-7) Сравнивает два объекта std::variant lhs и rhs. Содержащиеся значения сравниваются (с использованием соответствующего оператора T) только если оба lhs и rhs содержат значения, соответствующие одному и тому же индексу. В противном случае
    • lhs считается равным rhs тогда и только тогда, когда оба lhs и rhs не содержат значения.
    • lhs считается меньше rhs тогда и только тогда, когда либо rhs содержит значение, а lhs нет, либо lhs.index() меньше, чем rhs.index().
    1-6) Пусть @ обозначает соответствующий оператор сравнения для каждой из этих функций:

    Если для некоторых значений I соответствующее выражение GET <I>(lhs) @ GET <I>(rhs) некорректно или его результат не преобразуется в bool, программа считается некорректной.

    		(до C++26)

    Эта перегрузка участвует в разрешении перегрузки только если для всех значений I соответствующее выражение GET <I>(lhs) @ GET <I>(rhs) является корректным и его результат преобразуется в bool.

    		(начиная с C++26)
    8) Вспомогательный шаблон функции GET (только для демонстрации) ведёт себя как std::get(std::variant), за исключением того, что std::bad_variant_access никогда не выбрасывается.
    Если I < sizeof...(Types) равно false, программа считается некорректной.
    Если I == v.index() равно false, поведение не определено.

    Параметры

    lhs,rhs - варианты для сравнения

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

    **Примечание:** В данном фрагменте HTML-кода весь текст внутри тегов ``, `
    `, `` и C++ специфические термины (такие как `GET`, `lhs`, `rhs`, `index`, `lhs_empty`, `rhs_empty`) сохранены без перевода, как и требовалось. HTML-теги и атрибуты также остались неизменными.
    Оператор Оба операнда содержат значение
    (пусть I будет lhs. index ( ) и J будет rhs. index ( ) )     		lhs или rhs не содержит значения
    (пусть lhs_empty будет lhs. valueless_by_exception ( ) и rhs_empty будет rhs. valueless_by_exception ( ) )
    I и J равны I и J не равны
    == GET  < I > ( lhs ) == GET  < I > ( rhs ) false lhs_empty && rhs_empty
    ! = GET  < I > ( lhs ) ! = GET  < I > ( rhs ) true lhs_empty ! = rhs_empty
    < GET  < I > ( lhs ) < GET  < I > ( rhs ) lhs. index ( ) < rhs. index ( ) lhs_empty && ! rhs_empty
    > GET  < I > ( lhs ) > GET  < I > ( rhs ) lhs. index ( ) > rhs. index ( ) ! lhs_empty && rhs_empty
    <= GET  < I > ( lhs ) <= GET  < I > ( rhs ) lhs. index ( ) < rhs. index ( ) lhs_empty
    >= GET  < I > ( lhs ) >= GET  < I > ( rhs ) lhs. index ( ) > rhs. index ( ) rhs_empty
    <=> GET  < I > ( lhs ) <=> GET  < I > ( rhs ) lhs. index ( ) <=> rhs. index ( ) см. ниже

    Для operator <=> :

    Примечания

    Макрос тестирования возможностей Значение Стандарт Функция
    __cpp_lib_constrained_equality 202403L (C++26) ограниченные операторы сравнения для std::variant

    Пример

    Запустить этот код 
    #include <iostream>
#include <string>
#include <variant>
int main()
{
    std::cout << std::boolalpha;
    std::string cmp;
    bool result;
    auto print2 = [&cmp, &result](const auto& lhs, const auto& rhs)
    {
        std::cout << lhs << ' ' << cmp << ' ' << rhs << " : " << result << '\n';
    };
    std::variant<int, std::string> v1, v2;
    std::cout << "operator==\n";
    {
        cmp = "==";
        // по умолчанию v1 = 0, v2 = 0;
        result = v1 == v2; // true
        std::visit(print2, v1, v2);
        v1 = v2 = 1;
        result = v1 == v2; // true
        std::visit(print2, v1, v2);
        v2 = 2;
        result = v1 == v2; // false
        std::visit(print2, v1, v2);
        v1 = "A";
        result = v1 == v2; // false: v1.index == 1, v2.index == 0
        std::visit(print2, v1, v2);
        v2 = "B";
        result = v1 == v2; // false
        std::visit(print2, v1, v2);
        v2 = "A";
        result = v1 == v2; // true
        std::visit(print2, v1, v2);
    }
    std::cout << "operator<\n";
    {
        cmp = "<";
        v1 = v2 = 1;
        result = v1 < v2; // false
        std::visit(print2, v1, v2);
        v2 = 2;
        result = v1 < v2; // true
        std::visit(print2, v1, v2);
        v1 = 3;
        result = v1 < v2; // false
        std::visit(print2, v1, v2);
        v1 = "A"; v2 = 1;
        result = v1 < v2; // false: v1.index == 1, v2.index == 0
        std::visit(print2, v1, v2);
        v1 = 1; v2 = "A";
        result = v1 < v2; // true: v1.index == 0, v2.index == 1
        std::visit(print2, v1, v2);
        v1 = v2 = "A";
        result = v1 < v2; // false
        std::visit(print2, v1, v2);
        v2 = "B";
        result = v1 < v2; // true
        std::visit(print2, v1, v2);
        v1 = "C";
        result = v1 < v2; // false
        std::visit(print2, v1, v2);
    }
    {
        std::variant<int, std::string> v1;
        std::variant<std::string, int> v2;
    //  v1 == v2; // Ошибка компиляции: неизвестное преобразование
    }
    // TODO: C++20 трёхсторонний оператор сравнения <=> для вариантов
}

    Вывод: 

    operator==
0 == 0 : true
1 == 1 : true
1 == 2 : false
A == 2 : false
A == B : false
A == A : true
operator<
1 < 1 : false
1 < 2 : true
3 < 2 : false
A < 1 : false
1 < A : true
A < A : false
A < B : true
C < B : false

    Смотрите также

    (C++17) (C++17) (C++17) (C++17) (C++17) (C++17) (C++20)
    		сравнивает объекты optional
    (шаблон функции)