std::pair<T1,T2>::operator=
pair& operator=( const pair& other );
|
(1) | (自 C++20 起为 constexpr) |
constexpr const pair& operator=( const pair& other ) const;
|
(2) | (自 C++23 起) |
template< class U1, class U2 >
pair& operator=( const pair<U1, U2>& other );
|
(3) | (自 C++20 起为 constexpr) |
template< class U1, class U2 >
constexpr const pair& operator=( const pair<U1, U2>& other ) const;
|
(4) | (自 C++23 起) |
pair& operator=( pair&& other ) noexcept(/* see below */);
|
(5) | (自 C++11 起) (自 C++20 起为 constexpr) |
constexpr const pair& operator=( pair&& other ) const;
|
(6) | (自 C++23 起) |
template< class U1, class U2 >
pair& operator=( pair<U1, U2>&& p );
|
(7) | (自 C++11 起) (自 C++20 起为 constexpr) |
template< class U1, class U2 >
constexpr const pair& operator=( pair<U1, U2>&& p ) const;
|
(8) | (自 C++23 起) |
template< pair-like P >
constexpr pair& operator=( P&& u );
|
(9) | (自 C++23 起) |
template< pair-like P >
constexpr const pair& operator=( P&& u ) const;
|
(10) | (自 C++23 起) |
替换 pair 的内容。
other 内容的副本替换内容。
|
如果 |
(直到 C++11) |
|
如果 |
(自 C++11 起) |
std::is_copy_assignable_v<const T1> 和 std::is_copy_assignable_v<const T2> 都是 true 时,此重载才参与重载决议。other.first 赋给 first,并将 other.second 赋给 second。
|
仅当 |
(自 C++11 起) |
other.first 赋给 first,并将 other.second 赋给 second。std::is_assignable_v<const T1&, const U1&> 和 std::is_assignable_v<const T2&, const U2&> 都是 true 时,此重载才参与重载决议。other 的内容。std::is_move_assignable<T1>::value 和 std::is_move_assignable<T2>::value 都是 true 时,此重载才参与重载决议。std::is_assignable_v<const T1&, T1> 和 std::is_assignable_v<const T2&, T2> 都是 true 时,此重载才参与重载决议。std::forward<U1>(p.first) 赋给 first,并将 std::forward<U2>(p.second) 赋给 second。std::is_assignable<T1&, U1>::value 和 std::is_assignable<T2&, U2>::value 都是 true 时,此重载才参与重载决议。std::forward<U1>(p.first) 赋给 first,并将 std::forward<U2>(p.second) 赋给 second。std::is_assignable_v<const T1&, U1> 和 std::is_assignable_v<const T2&, U2> 都是 true 时,此重载才参与重载决议。std::get<0>(std::forward<P>(u)) 赋给 first,并将 std::get<1>(std::forward<P>(u)) 赋给 second。std::same_as<std::remove_cvref_t<P>, std::pair>是false,std::remove_cvref_t<P>不是 std::ranges::subrange 的特化,std::is_assignable_v<T1&, decltype(std::get<0>(std::forward<P>(p)))>是true,且std::is_assignable_v<T1&, decltype(std::get<1>(std::forward<P>(p)))>是true时,此重载才参与重载决议。
std::get<0>(std::forward<P>(u)) 赋给 first,并将 std::get<1>(std::forward<P>(u)) 赋给 second。std::same_as<std::remove_cvref_t<P>, std::pair>是false,std::remove_cvref_t<P>不是 std::ranges::subrange 的特化,std::is_assignable_v<const T1&, decltype(std::get<0>(std::forward<P>(p)))>是true,且std::is_assignable_v<const T1&, decltype(std::get<1>(std::forward<P>(p)))>是true时,此重载才参与重载决议。
参数
| other | - | 用于替换本对内容的值对 |
| p | - | 可能具有不同类型的值对,用于替换本对内容 |
| u | - | pair-like 对象的值,用于替换本对内容 |
| 类型要求 | ||
-
T1
必须满足从
U1
的
CopyAssignable
要求。
(C++11 前)
|
||
-
T2
必须满足从
U2
的
CopyAssignable
要求。
(C++11 前)
|
||
返回值
* this
异常
std::
is_nothrow_move_assignable
<
T1
>
::
value
&&
std::
is_nothrow_move_assignable
<
T2
>
::
value
示例
#include <cstddef> #include <iomanip> #include <iostream> #include <utility> #include <vector> template<class Os, class T> Os& operator<<(Os& os, const std::vector<T>& v) { os << '{'; for (std::size_t t = 0; t != v.size(); ++t) os << v[t] << (t + 1 < v.size() ? ", " : ""); return os << '}'; } template<class Os, class U1, class U2> Os& operator<<(Os& os, const std::pair<U1, U2>& pair) { return os << '{' << pair.first << ", " << pair.second << '}'; } int main() { std::pair<int, std::vector<int>> p{1, {2}}, q{2, {5, 6}}; p = q; // (1) operator=(const pair& other); std::cout << std::setw(23) << std::left << "(1) p = q;" << "p: " << p << " q: " << q << '\n'; std::pair<short, std::vector<int>> r{4, {7, 8, 9}}; p = r; // (3) operator=(const pair<U1, U2>& other); std::cout << std::setw(23) << "(3) p = r;" << "p: " << p << " r: " << r << '\n'; p = std::pair<int, std::vector<int>>{3, {4}}; p = std::move(q); // (5) operator=(pair&& other); std::cout << std::setw(23) << "(5) p = std::move(q);" << "p: " << p << " q: " << q << '\n'; p = std::pair<int, std::vector<int>>{5, {6}}; p = std::move(r); // (7) operator=(pair<U1, U2>&& other); std::cout << std::setw(23) << "(7) p = std::move(r);" << "p: " << p << " r: " << r << '\n'; }
输出:
(1) p = q; p: {2, {5, 6}} q: {2, {5, 6}}
(3) p = r; p: {4, {7, 8, 9}} r: {4, {7, 8, 9}}
(5) p = std::move(q); p: {2, {5, 6}} q: {2, {}}
(7) p = std::move(r); p: {4, {7, 8, 9}} r: {4, {}}
缺陷报告
下列行为变更缺陷报告被追溯应用于先前发布的 C++ 标准。
| 缺陷报告 | 适用标准 | 发布时行为 | 正确行为 |
|---|---|---|---|
| LWG 885 | C++98 | 缺少异构拷贝赋值操作 | 已添加(作为重载 (3) ) |
| LWG 2729 | C++11 |
pair::operator=
未受约束且可能
导致不必要的未定义行为 |
已添加约束 |
参见
将一个
tuple
的内容赋值给另一个
(
std::tuple<Types...>
的公开成员函数)
|