std::optional<T>:: swap

Обменивает содержимое с содержимым other .

• Если ни * this , ни other не содержат значения, функция не имеет эффекта.

• Если только один из * this и other содержит значение (назовём этот объект in , а другой un ), содержащееся значение un прямо инициализируется из std :: move ( * in ) , после чего следует уничтожение содержащегося значения in как если бы с помощью in - > T :: ~T ( ) . После этого вызова in не содержит значения; un содержит значение.

• Если и * this и other содержат значения, содержащиеся значения обмениваются посредством вызова using std:: swap ; swap ( ** this, * other ) .

Программа является некорректной, если тип T не является Swappable и std:: is_move_constructible_v < T > не равен true .

Параметры

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

(нет)

Исключения

В случае возникновения исключения состояния содержащихся значений * this и other определяются гарантиями безопасности исключений swap для типа T или конструктора перемещения T , в зависимости от того, что вызывается. Как для * this , так и для other , если объект содержал значение, он остается содержащим значение, и наоборот.

Пример

#include <iostream>
#include <optional>
#include <string>
int main()
{
    std::optional<std::string> opt1("First example text");
    std::optional<std::string> opt2("2nd text");
    enum Swap { Before, After };
    auto print_opts = [&](Swap e)
    {
        std::cout << (e == Before ? "Before swap:\n" : "After swap:\n");
        std::cout << "opt1 contains '" << opt1.value_or("") << "'\n";
        std::cout << "opt2 contains '" << opt2.value_or("") << "'\n";
        std::cout << (e == Before ? "---SWAP---\n": "\n");
    };
    print_opts(Before);
    opt1.swap(opt2);
    print_opts(After);
    // Swap with only 1 set
    opt1 = "Lorem ipsum dolor sit amet, consectetur tincidunt.";
    opt2.reset();
    print_opts(Before);
    opt1.swap(opt2);
    print_opts(After);
}

Before swap:
opt1 contains 'First example text'
opt2 contains '2nd text'
---SWAP---
After swap:
opt1 contains '2nd text'
opt2 contains 'First example text'
Before swap:
opt1 contains 'Lorem ipsum dolor sit amet, consectetur tincidunt.'
opt2 contains ''
---SWAP---
After swap:
opt1 contains ''
opt2 contains 'Lorem ipsum dolor sit amet, consectetur tincidunt.'

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

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

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