Namespaces
Variants

std:: swap (std::optional)

From cppreference.net
Utilities library
Определено в заголовочном файле <optional>
template < class T >

void swap ( std:: optional < T > & lhs,

std:: optional < T > & rhs ) noexcept ( /* see below */ ) ;
(начиная с C++17)
(constexpr начиная с C++20)

Перегружает алгоритм std::swap для std::optional . Обменивает состояние lhs с состоянием rhs . Фактически вызывает lhs. swap ( rhs ) .

Эта перегрузка участвует в разрешении перегрузки только если std:: is_move_constructible_v < T > и std:: is_swappable_v < T > оба равны true .

Содержание

Параметры

lhs, rhs - optional объекты, состояния которых нужно обменять

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

(нет)

Исключения

noexcept спецификация:
noexcept ( noexcept ( lhs. swap ( rhs ) ) )

Примечания

Макрос тестирования возможностей Значение Стандарт Функция
__cpp_lib_optional 202106L (C++20)
(DR20)
Полностью constexpr

Пример

#include <iostream>
#include <optional>
#include <string>
int main()
{
    std::optional<std::string> a{"██████"}, b{"▒▒▒▒▒▒"};
    auto print = [&](auto const& s)
    {
        std::cout << s << "\t"
                     "a = " << a.value_or("(null)") << "  "
                     "b = " << b.value_or("(null)") << '\n';
    };
    print("Initially:");
    std::swap(a, b);
    print("swap(a, b):");
    a.reset();
    print("\n""a.reset():");
    std::swap(a, b);
    print("swap(a, b):");
}

Вывод:

Initially:   a = ██████  b = ▒▒▒▒▒▒
swap(a, b):  a = ▒▒▒▒▒▒  b = ██████
a.reset():   a = (null)  b = ██████
swap(a, b):  a = ██████  b = (null)

Отчеты о дефектах

Следующие отчеты об изменениях поведения, влияющие на дефекты, были применены ретроактивно к ранее опубликованным стандартам C++.

DR Applied to Behavior as published Correct behavior
P2231R1 C++20 swap не был constexpr в то время как требуемые операции могут быть constexpr в C++20 сделан constexpr

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

обменивает содержимое
(публичная функция-член)