std::pair<T1,T2>::pair

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ (C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ (C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ (C++17)

正規表現ライブラリ (C++11)

アトミック操作ライブラリ (C++11)

スレッドサポートライブラリ (C++11)

技術仕様書

 

ユーティリティライブラリ

言語サポート 型サポート (基本型、RTTI、型特性) ライブラリの機能テストマクロ (C++20) 動的メモリ管理 プログラムユーティリティ エラー処理 コルーチンサポート (C++20) 可変長引数関数 launder (C++17) initializer_list (C++11) source_location (C++20) 三方比較 (C++20) 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_neqis_ltis_lteqis_gtis_gteq (C++20)(C++20)(C++20)(C++20)(C++20)(C++20)

汎用ユーティリティ 日付と時間 関数オブジェクト 書式化ライブラリ (C++20) bitset hash (C++11) integer_sequence (C++14) 関係演算子 (C++20で非推奨) rel_ops::operator!=rel_ops::operator>rel_ops::operator<=rel_ops::operator>= 整数比較関数 cmp_equalcmp_not_equalcmp_lesscmp_greatercmp_less_thancmp_greater_than (C++20)(C++20)(C++20)(C++20)(C++20)(C++20) in_range (C++20) スワップと型操作 swap ranges::swap (C++20) exchange (C++14) declval (C++11) forward (C++11) move (C++11) move_if_noexcept (C++11) as_const (C++17) 一般的な語彙の型 pair tuple (C++11) apply (C++17) make_from_tuple (C++17) optional (C++17) any (C++17) variant (C++17) 初等文字列変換 to_chars (C++17) from_chars (C++17) chars_format (C++17)

 

std::pair

メンバ関数

pair::pair

pair::operator=

pair::swap

非メンバ関数

make_pair

operator==operator!=operator<operator<=operator>operator>=operator<=> (C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20未満)(C++20)

std::swap

get (C++11)

推定ガイド(C++17)

ヘルパークラス

tuple_size (C++11)

tuple_element (C++11)

 

<tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody> <tbody class="t-dcl-rev t-dcl-rev-num "> </tbody><tbody> </tbody>

	(1)
pair();		(C++11未満)
constexpr pair();		(C++11以上) (条件付き explicit)
	(2)
pair( const T1& x, const T2& y );		(C++11未満)
pair( const T1& x, const T2& y );		(C++11以上) (C++14未満) (条件付き explicit)
constexpr pair( const T1& x, const T2& y );		(C++14以上) (条件付き explicit)
	(3)
template< class U1, class U2 > pair( U1&& x, U2&& y );		(C++11以上) (C++14未満) (条件付き explicit)
template< class U1, class U2 > constexpr pair( U1&& x, U2&& y );		(C++14以上) (条件付き explicit)
	(4)
template< class U1, class U2 > pair( const pair<U1, U2>& p );		(C++11未満)
template< class U1, class U2 > pair( const pair<U1, U2>& p );		(C++11以上) (C++14未満) (条件付き explicit)
template< class U1, class U2 > constexpr pair( const pair<U1, U2>& p );		(C++14以上) (条件付き explicit)
	(5)
template< class U1, class U2 > pair( pair<U1, U2>&& p );		(C++11以上) (C++14未満) (条件付き explicit)
template< class U1, class U2 > constexpr pair( pair<U1, U2>&& p );		(C++14以上) (条件付き explicit)
	(6)
template< class... Args1, class... Args2 > pair( std::piecewise_construct_t, std::tuple<Args1...> first_args, std::tuple<Args2...> second_args );		(C++11以上) (C++20未満)
template< class... Args1, class... Args2 > constexpr pair( std::piecewise_construct_t, std::tuple<Args1...> first_args, std::tuple<Args2...> second_args );		(C++20以上)
pair( const pair& p ) = default;	(7)
pair( pair&& p ) = default;	(8)	(C++11以上)

新しいペアを構築します。

1) デフォルトコンストラクタ。 ペアの要素、first および second を両方とも値初期化します。

このコンストラクタは、 std::is_default_constructible_v<first_type> および std::is_default_constructible_v<second_type> がどちらも true である場合にのみ、オーバーロード解決に参加します。 このコンストラクタは、 first_type または second_type のいずれかが暗黙にデフォルト構築可能でない場合、 explicit になります。

(C++11以上)

2) first を x で、 second を y で初期化します。

このコンストラクタは、 std::is_copy_constructible_v<first_type> および std::is_copy_constructible_v<second_type> がどちらも true である場合のにみ、オーバーロード解決に参加します。 このコンストラクタは、 std::is_convertible_v<const first_type&, first_type> が false であるか、 std::is_convertible_v<const second_type&, second_type> が false である場合にのみ、 explicit になります。

(C++11以上)

3) first を std::forward<U1>(x) で、 second を std::forward<U2>(y) で初期化します。

• このコンストラクタは、 std::is_constructible_v<first_type, U1&&> および std::is_constructible_v<second_type, U2&&> がどちらも true である場合にのみ、オーバーロード解決に参加します。
• このコンストラクタは、 std::is_convertible_v<U1&&, first_type> が false であるか、 std::is_convertible_v<U2&&, second_type> が false である場合にのみ、 explicit になります。

4) first を p.first で、 second を p.second で初期化します。

このコンストラクタは、 std::is_constructible_v<first_type, const U1&> および std::is_constructible_v<second_type, const U2&> がどちらも true の場合にのみ、オーバーロード解決に参加します。 このコンストラクタは、 std::is_convertible_v<const U1&, first_type> が false であるか、 std::is_convertible_v<const U2&, second_type> が false である場合にのみ、 explicit に指定されます。

(C++11以上)

5) first を std::forward<U1>(p.first) で、 second を std::forward<U2>(p.second) で初期化します。

• このコンストラクタは、 std::is_constructible_v<first_type, U1&&> および std::is_constructible_v<second_type, U2&&> がどちらも true の場合にのみ、オーバーロード解決に参加します。
• このコンストラクタは、 std::is_convertible_v<U1&&, first_type> が false であるか、 std::is_convertible_v<U2&&, second_type> が false である場合にのみ、 explicit になります。

6) first_args の要素を first のコンストラクタに転送し、 second_args の要素を second のコンストラクタに転送します。 これはコピー可能でもムーブ可能でもない型のペアを作成するために使用できる、デフォルトコンストラクタ以外の唯一のコンストラクタです。

7) コピーコンストラクタはデフォルト化されており、両方の要素のコピーが constexpr 関数の要件を満たす場合は constexpr になります。

8) ムーブコンストラクタはデフォルト化されており、両方の要素のムーブが constexpr 関数の要件を満たす場合は constexpr になります。

引数

x	-	このペアの第1要素を初期化するための値
y	-	このペアの第2要素を初期化するための値
p	-	このペアの両方の要素を初期化するために使用される値のペア
first_args	-	このペアの第1要素を初期化するためのコンストラクタ引数のタプル
second_args	-	このペアの第2要素を初期化するためのコンストラクタ引数のタプル

例外

指定された操作のいずれか (要素のコンストラクタなど) が例外を投げない限り、例外を投げません。

欠陥報告

以下の動作変更欠陥報告は以前に発行された C++ 標準に遡って適用されました。

DR	適用先	発行時の動作	正しい動作
N4387	C++11	some constructors were implicit-only, preventing some uses	constructors made conditionally-explicit
LWG 2510	C++11	default constructor was implicit	made conditionally-explicit

例

Run this code

#include <utility>
#include <string>
#include <complex>
#include <tuple>
#include <iostream>

int main()
{
    std::pair<int, float> p1;
    std::cout << "Value-initialized: "
              << p1.first << ", " << p1.second << '\n';

    std::pair<int, double> p2(42, 0.123);
    std::cout << "Initialized with two values: "
              << p2.first << ", " << p2.second << '\n';

    std::pair<char, int> p4(p2);
    std::cout << "Implicitly converted: "
              << p4.first << ", " << p4.second << '\n';

    std::pair<std::complex<double>, std::string> p6(
                    std::piecewise_construct, 
                    std::forward_as_tuple(0.123, 7.7),
                    std::forward_as_tuple(10, 'a'));
    std::cout << "Piecewise constructed: "
              << p6.first << ", " << p6.second << '\n';
}

出力:

Value-initialized: 0, 0
Initialized with two values: 42, 0.123
Implicitly converted: *, 0
Piecewise constructed: (0.123,7.7), aaaaaaaaaa

関連項目

make_pair

引数の型によって定義された型の pair オブジェクトを作成します (関数テンプレート)