19 General utilities library [utilities]

19.7 Variants [variant]

variant& operator=(const variant& rhs);

Let j be rhs.index().

Effects:

(2.1)
If neither *this nor rhs holds a value, there is no effect.
(2.2)
Otherwise, if *this holds a value but rhs does not, destroys the value contained in *this and sets *this to not hold a value.
(2.3)
Otherwise, if index() == j, assigns the value contained in rhs to the value contained in *this.
(2.4)
Otherwise, if either is_nothrow_copy_constructible_v<T $_{j}$ > is true or is_nothrow_move_constructible_v<T $_{j}$ > is false, equivalent to emplace<j>(get<j>(rhs)).
(2.5)
Otherwise, equivalent to operator=(variant(rhs)).

Returns: *this.

Ensures: index() == rhs.index().

Remarks: This operator shall be defined as deleted unless is_copy_constructible_v<T

_{i}

> && is_copy_assignable_v<T

_{i}

> is true for all i.

variant& operator=(variant&& rhs) noexcept(see below);

Let j be rhs.index().

Effects:

(7.1)
If neither *this nor rhs holds a value, there is no effect.
(7.2)
Otherwise, if *this holds a value but rhs does not, destroys the value contained in *this and sets *this to not hold a value.
(7.3)
Otherwise, if index() == j, assigns get<j>(std::move(rhs)) to the value contained in *this.
(7.4)
Otherwise, equivalent to emplace<j>(get<j>(std::move(rhs))).

Returns: *this.

Remarks: This function shall not participate in overload resolution unless is_move_constructible_v<T

_{i}

> && is_move_assignable_v<T

_{i}

> is true for all i.

The expression inside noexcept is equivalent to: is_nothrow_move_constructible_v<T

_{i}

> && is_nothrow_move_assignable_v<T

_{i}

> for all i.

(9.1)
If an exception is thrown during the call to T $_{j}$ 's move construction (with j being rhs.index()), the variant will hold no value.
(9.2)
If an exception is thrown during the call to T $_{j}$ 's move assignment, the state of the contained value is as defined by the exception safety guarantee of T $_{j}$ 's move assignment; index() will be j.

template<class T> variant& operator=(T&& t) noexcept(see below);

Let T

_{j}

be a type that is determined as follows: build an imaginary function FUN(T

_{i}

) for each alternative type T

_{i}

The overload FUN(T

_{j}

) selected by overload resolution for the expression FUN(std::forward<T>(t)) defines the alternative T

_{j}

which is the type of the contained value after assignment.

Effects:

(11.1)
If *this holds a T $_{j}$ , assigns std::forward<T>(t) to the value contained in *this.
(11.2)
Otherwise, if is_nothrow_constructible_v<T $_{j}$ , T> || !is_nothrow_move_constructible_v<T $_{j}$ > is true, equivalent to emplace<j>(std::forward<T>(t)).
(11.3)
Otherwise, equivalent to operator=(variant(std::forward<T>(t))).

Ensures: holds_alternative<T

_{j}

>(*this) is true, with T

_{j}

selected by the imaginary function overload resolution described above.

Returns: *this.

Remarks: This function shall not participate in overload resolution unless

(14.1)
is_same_v<remove_cvref_t<T>, variant> is false,
(14.2)
is_assignable_v<T $_{j}$ &, T> && is_constructible_v<T $_{j}$ , T> is true, and
(14.3)
the expression FUN(std::forward<T>(t)) (with FUN being the above-mentioned set of imaginary functions) is well-formed.

variant<string, string> v;
v = "abc";

is ill-formed, as both alternative types have an equally viable constructor for the argument.

— end note

]

The expression inside noexcept is equivalent to:

is_nothrow_assignable_v<T $_{j}$ &, T> && is_nothrow_constructible_v<T $_{j}$ , T>

(16.1)
If an exception is thrown during the assignment of std::forward<T>(t) to the value contained in *this, the state of the contained value and t are as defined by the exception safety guarantee of the assignment expression; valueless_by_exception() will be false.
(16.2)
If an exception is thrown during the initialization of the contained value, the variant object might not hold a value.