std::compare_three_way_result

 

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)

 

ヘッダ <compare> で定義
template<class T, class U = T> struct compare_three_way_result;		(C++20以上)

t と u がそれぞれ conststd::remove_reference_t<T> と conststd::remove_reference_t<U> の左辺値を表すとき、式 t <=> u が well-formed であれば、 decltype(t <=> u) に等しいメンバ型 type を提供します。 そうでなければ、メンバ type は存在しません。

このテンプレートを特殊化する試みは未定義動作です。

メンバ型

名前	定義
type	T と U の const 修飾された左辺値に対する operator<=> の結果の型

ヘルパー型

template<class T, class U = T> using compare_three_way_result_t =typename compare_three_way_result<T>::type;		(C++20以上)

実装例

template<class T, class U = T>struct compare_three_way_result {};   template<class T, class U> requires requires(conststd::remove_reference_t<T>& t, conststd::remove_reference_t<U>& u){ t <=> u;}struct compare_three_way_result<T, U>{using type = decltype(std::declval<conststd::remove_reference_t<T>&>()<=>std::declval<conststd::remove_reference_t<U>&>());};

例

Run this code

#include <compare>#include <type_traits>#include <iostream>   template<class Ord>void print_cmp_type(){ifconstexpr(std::is_same_v<Ord, std::strong_ordering>)std::cout<<"strong ordering\n";elseifconstexpr(std::is_same_v<Ord, std::weak_ordering>)std::cout<<"weak ordering\n";elseifconstexpr(std::is_same_v<Ord, std::partial_ordering>)std::cout<<"partial ordering\n";elseifconstexpr(std::is_same_v<Ord, std::strong_equality>)std::cout<<"strong equality\n";elseifconstexpr(std::is_same_v<Ord, std::weak_equality>)std::cout<<"weak equality\n";elsestd::cout<<"illegal comparison result type\n";}   int main(){ print_cmp_type<std::compare_three_way_result_t<int>>(); print_cmp_type<std::compare_three_way_result_t<double>>(); print_cmp_type<std::compare_three_way_result_t<int(*)()>>();}

出力:

strong ordering partial ordering strong equality

関連項目

weak_equality (C++20)	等しい、等しくないのみサポートする代用可能でない三方比較の結果の型 (クラス)
strong_equality (C++20)	等しい、等しくないのみサポートする代用可能な三方比較の結果の型 (クラス)
partial_ordering (C++20)	6種類の演算子をすべてサポートし、代用可能でなく、比較不可能な値を許容する、三方比較の結果の型 (クラス)
weak_ordering (C++20)	6種類の演算子をすべてサポートする代用可能でない三方比較の結果の型 (クラス)
strong_ordering (C++20)	6種類の演算子をすべてサポートする代用可能な三方比較の結果の型 (クラス)