23 General utilities library [utilities]

23.5 Tuples [tuple]

23.5.3 Class template tuple [tuple.tuple]

23.5.3.2 Assignment [tuple.assign]

For each tuple assignment operator, an exception is thrown only if the assignment of one of the types in Types throws an exception. In the function descriptions that follow, let i be in the range [0, sizeof...(Types)) in order, $T_{i}$ be the $i^{th}$ type in Types, and $U_{i}$ be the $i^{th}$ type in a template parameter pack named UTypes, where indexing is zero-based.

tuple& operator=(const tuple& u);

Effects: Assigns each element of u to the corresponding element of *this.

Remarks: This operator shall be defined as deleted unless is_copy_assignable_v< $T_{i}$ > is true for all i.

Returns: *this.

tuple& operator=(tuple&& u) noexcept(see below);

Effects: For all i, assigns std::forward< $T_{i}$ >(get<i>(u)) to get<i>(*this).

Remarks: This operator shall be defined as deleted unless is_move_assignable_v< $T_{i}$ > is true for all i.

Remarks: The expression inside noexcept is equivalent to the logical and of the following expressions:

is_nothrow_move_assignable_v< $T_{i}$ >

where $T_{i}$ is the $i^{th}$ type in Types.

Returns: *this.

template <class... UTypes> tuple& operator=(const tuple<UTypes...>& u);

Effects: Assigns each element of u to the corresponding element of *this.

Remarks: This operator shall not participate in overload resolution unless sizeof...(Types) == sizeof...(UTypes) and is_assignable_v< $T_{i}$ &, const $U_{i}$ &> is true for all i.

Returns: *this.

template <class... UTypes> tuple& operator=(tuple<UTypes...>&& u);

Effects: For all i, assigns std::forward< $U_{i}$ >(get<i>(u)) to get<i>(*this).

Remarks: This operator shall not participate in overload resolution unless is_assignable_v< $T_{i}$ &, $U_{i}$ &&> == true for all i and sizeof...(Types) == sizeof...(UTypes).

Returns: *this.

template <class U1, class U2> tuple& operator=(const pair<U1, U2>& u);

Effects: Assigns u.first to the first element of *this and u.second to the second element of *this.

Remarks: This operator shall not participate in overload resolution unless sizeof...(Types) == 2 and is_assignable_v< $T_{0}$ &, const U1&> is true for the first type $T_{0}$ in Types and is_assignable_v< $T_{1}$ &, const U2&> is true for the second type $T_{1}$ in Types.

Returns: *this.

template <class U1, class U2> tuple& operator=(pair<U1, U2>&& u);

Effects: Assigns std::forward<U1>(u.first) to the first element of *this and
std::forward<U2>(u.second) to the second element of *this.

Remarks: This operator shall not participate in overload resolution unless sizeof...(Types) == 2 and is_assignable_v< $T_{0}$ &, U1&&> is true for the first type $T_{0}$ in Types and is_assignable_v< $T_{1}$ &, U2&&> is true for the second type $T_{1}$ in Types.

Returns: *this.