std::pair

 

C++

編譯器支援

獨立式與託管式

語言

標準函式庫

標準函式庫標頭檔

具名要求

特性測試巨集 (C++20)

語言支援函式庫

概念函式庫 (C++20)

診斷函式庫

記憶體管理函式庫

元編程函式庫 (C++11)

通用公用程式函式庫

容器函式庫

疊代器函式庫

Ranges 函式庫 (C++20)

演算法函式庫

字串函式庫

文本處理函式庫

數值函式庫

日期與時間函式庫

輸入/輸出函式庫

檔案系統函式庫 (C++17)

並行支援函式庫 (C++11)

執行控制函式庫 (C++26)

技術規範

符號索引

外部函式庫

 

工具程式庫

語言支援 型別支援 (基本型別, RTTI) 函式庫特性測試巨集 (C++20) 程式公用程式 可變參數函式 initializer_list (C++11) is_constant_evaluated (C++20) is_within_lifetime (C++26) source_location (C++20) 協程支援 (C++20) 合約支援 (C++26) 三向比較 three_way_comparablethree_way_comparable_with (C++20)(C++20) strong_ordering (C++20) weak_ordering (C++20) partial_ordering (C++20) common_comparison_category (C++20) compare_three_way_result (C++20) compare_three_way (C++20) strong_order (C++20) weak_order (C++20) partial_order (C++20) compare_strong_order_fallback (C++20) compare_weak_order_fallback (C++20) compare_partial_order_fallback (C++20)   is_eqis_ltis_lteq (C++20)(C++20)(C++20)   is_neqis_gtis_gteq (C++20)(C++20)(C++20)

通用公用程式 函式物件 位元操作 (C++20) bitset hash (C++11) 關係運算子 (C++20 中棄用) rel_ops::operator!=rel_ops::operator>    rel_ops::operator<=rel_ops::operator>= 整數比較函式 cmp_equalcmp_lesscmp_less_than (C++20)(C++20)(C++20)   cmp_not_equalcmp_greatercmp_greater_than (C++20)(C++20)(C++20) in_range (C++20) Swap 與 型別操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) to_underlying (C++23) forward (C++11) forward_like (C++23) move (C++11) move_if_noexcept (C++11) as_const (C++17) 通用詞彙型別 pair tuple (C++11) optional (C++17) any (C++17) variant (C++17) tuple_size (C++11) tuple_element (C++11) apply (C++17) make_from_tuple (C++17) expected (C++23)

 

std::pair

成員函式

pair::pair

pair::operator=

pair::swap (C++11)

非成員函式

make_pair

operator==operator!=operator<operator<=operator>operator>=operator<=> (直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(直到 C++20)(自 C++20 起)

swap(std::pair) (C++11)

get(std::pair) (C++11)

輔助類別

tuple_size<std::pair> (C++11)

tuple_element<std::pair> (C++11)

basic_common_reference<std::pair> (C++23)

common_type<std::pair> (C++23)

formatter<std::pair> (C++23)

piecewise_construct_t (C++11)

推導指引 (Deduction guides)(C++17)

 

定義於標頭檔 <utility>
template<     class T1,     class T2 > struct pair;

std::pair 是一個類別模板，提供了一種將兩個異質物件儲存為單一單元的方法。pair 是 std::tuple 的一種特殊情況，包含兩個元素。

若 T1 與 T2 皆非具有非平凡解構函式的 cv 限定類別型別（或其陣列），則 pair 的解構函式為平凡的。

模板參數

T1, T2

-

pair 所儲存元素的型別。

成員型別

成員型別	定義
first_type	T1
second_type	T2

成員物件

成員名稱	類型
first	T1
second	T2

成員函式

(建構子)	建構新的 pair (公開成員函式)
operator=	賦值內容 (公開成員函式)
swap (C++11)	交換內容 (公開成員函式)

非成員函式

make_pair	建立一個由參數型別決定的 pair 物件 (函式模板)
operator==operator!=operator<operator<=operator>operator>=operator<=> (於 C++20 中移除)(於 C++20 中移除)(於 C++20 中移除)(於 C++20 中移除)(於 C++20 中移除)(自 C++20 起)	按字典序比較 pair 中的值 (函式模板)
std::swap(std::pair) (C++11)	特化 std::swap 演算法 (函式模板)
get(std::pair) (C++11)	存取 pair 中的元素 (函式模板)

輔助類別

std::tuple_size<std::pair> (C++11)	取得 pair 的大小 (類別模板特化)
std::tuple_element<std::pair> (C++11)	取得 pair 中元素的型別 (類別模板特化)
std::basic_common_reference<std::pair> (C++23)	決定兩個 pair 的共同參考型別 (類別模板特化)
std::common_type<std::pair> (C++23)	決定兩個 pair 的共同型別 (類別模板特化)
std::formatter<std::pair> (C++23)	對 pair 的格式化支援 (類別模板特化)

輔助特化

template< class T, class U > constexpr bool enable_nonlocking_formatter_optimization<std::pair<T, U>> =     enable_nonlocking_formatter_optimization<T> &&     enable_nonlocking_formatter_optimization<U>;		(自 C++23 起)

此 std::enable_nonlocking_formatter_optimization 特化，使得當 T 與 U 皆啟用此功能時，能對 pair 物件進行 std::print 與 std::println 的高效實作。

缺陷報告

下列更改行為的缺陷報告追溯應用於之前的 C++ 標準。

DR	應用於	出版時的行為	正確的行為
LWG 2796	C++98	pair 解構函式的平凡性未明確定義	已指定

參見

tuple (C++11)	實作固定大小的容器，可儲存不同型別的元素 (類別模板)
tie (C++11)	建立一個左值引用 tuple 或將 tuple 解包為單獨的物件 (函式模板)