std::optional<T>::reset

void reset() noexcept;

(начиная с C++17)
(constexpr начиная с C++20)

Если *this содержит значение, уничтожает это значение, как если бы был вызван value().T::~T(). В противном случае не оказывает эффекта.

После этого вызова *this не содержит значения.

Примечания

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

Пример

#include <iostream>
#include <optional>

struct A
{
    std::string s;
    A(std::string str) : s(std::move(str)) { std::cout << " constructed\n"; }
    ~A() { std::cout << " destructed\n"; }
    A(const A& o) : s(o.s) { std::cout << " copy constructed\n"; }
    A(A&& o) : s(std::move(o.s)) { std::cout << " move constructed\n"; }
    
    A& operator=(const A& other)
    {
        s = other.s;
        std::cout << " copy assigned\n";
        return *this;
    }
    
    A& operator=(A&& other)
    {
        s = std::move(other.s);
        std::cout << " move assigned\n";
        return *this;
    }
};

int main()
{
    std::cout << "Create empty optional:\n";
    std::optional<A> opt;

    std::cout << "Construct and assign value:\n";
    opt = A("Lorem ipsum dolor sit amet, consectetur adipiscing elit nec.");

    std::cout << "Reset optional:\n";
    opt.reset();
    std::cout << "End example\n";
}

Вывод:

Create empty optional:
Construct and assign value:
 constructed
 move constructed
 destructed
Reset optional:
 destructed
End example

Отчёты об ошибках

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

DR	Применено к	Опубликованное поведение	Правильное поведение
P2231R1	C++20	`reset` не был constexpr, хотя в C++20 нетривиальное уничтожение допускается в constexpr	сделан constexpr

См. также

operator=

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

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/utility/optional/reset