標準ライブラリヘッダ <compare>

 

C++

言語

標準ライブラリヘッダ

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

名前付き要件

言語サポートライブラリ

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

診断ライブラリ

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

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

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

アルゴリズムライブラリ

数値演算ライブラリ

入出力ライブラリ

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

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

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

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

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

技術仕様書

 

標準ライブラリヘッダ

言語サポート
<cstddef> <limits> <climits> <coroutine>	<cfloat> <cstdint> <new> <source_location>	<typeinfo> <exception> <initializer_list> <version>	<csignal> <csetjmp> <cstdarg>
コンセプト
<concepts>
診断
<stdexcept>	<cassert>	<cerrno>	<system_error>
汎用ユーティリティ
<utility> <memory> <memory_resource> <scoped_allocator>     <compare>	<bitset> <tuple> <optional> <any> <variant>	<type_traits> <ratio> <chrono> <typeindex> <functional>	<ctime> <cstdlib>
文字列
<string> <string_view> <cstring>	<charconv> <format>	<cctype> <cwctype>	<cwchar> <cuchar>
ローカライゼーション
<locale>	<codecvt>	<clocale>
コンテナ
<span> <array> <vector>	<deque> <forward_list> <list>	<map> <set> <queue>	<unordered_map> <unordered_set> <stack>
イテレータ
<iterator>
範囲
<ranges>
アルゴリズム
<algorithm>	<execution>
数値演算
<complex> <random>	<valarray> <numeric>	<bit> <numbers>	<cfenv> <cmath>
入出力
<iosfwd> <ios> <iomanip> <streambuf>	<istream> <ostream> <iostream>	<sstream> <fstream> <syncstream>	<cstdio> <cinttypes> <strstream>
正規表現
<regex>
ファイルシステムサポート
<filesystem>
スレッドサポート
<thread> <atomic> <mutex>	<shared_mutex> <condition_variable> <future>	<stop_token> <semaphore>	<latch> <barrier>
C互換
<ciso646> <cstdalign>	<cstdbool> <ccomplex>	<ctgmath>

 

このヘッダは汎用ユーティリティライブラリの一部です。

コンセプト

three_way_comparablethree_way_comparable_with (C++20)

指定された型に対して演算子 <=> が一貫した結果を生成することを指定します (コンセプト)

クラス

partial_ordering (C++20)	6種類の演算子をすべてサポートし、代用可能でなく、比較不可能な値を許容する、三方比較の結果の型 (クラス)
weak_ordering (C++20)	6種類の演算子をすべてサポートする代用可能でない三方比較の結果の型 (クラス)
strong_ordering (C++20)	6種類の演算子をすべてサポートする代用可能な三方比較の結果の型 (クラス)
common_comparison_category (C++20)	指定されたすべての型が変換可能な最も強い比較カテゴリ (クラステンプレート)
compare_three_way_result (C++20)	指定された型に対する三方比較演算子 <=> の結果の型を取得します (クラステンプレート)
compare_three_way (C++20)	x <=> y を実装する関数オブジェクト (クラス)

カスタマイゼーションポイントオブジェクト

strong_order (C++20)	三方比較を行い、 std::strong_ordering 型の結果を生成します (カスタマイゼーションポイントオブジェクト)
weak_order (C++20)	三方比較を行い、 std::weak_ordering 型の結果を生成します (カスタマイゼーションポイントオブジェクト)
partial_order (C++20)	三方比較を行い、 std::partial_ordering 型の結果を生成します (カスタマイゼーションポイントオブジェクト)
compare_strong_order_fallback (C++20)	三方比較を行い、 std::strong_ordering 型の結果を生成します (operator<=> が利用できない場合でも) (カスタマイゼーションポイントオブジェクト)
compare_weak_order_fallback (C++20)	三方比較を行い、 std::weak_ordering 型の結果を生成します (operator<=> が利用できない場合でも) (カスタマイゼーションポイントオブジェクト)
compare_partial_order_fallback (C++20)	三方比較を行い、 std::partial_ordering 型の結果を生成します (operator<=> が利用できない場合でも) (カスタマイゼーションポイントオブジェクト)

関数

is_eqis_neqis_ltis_lteqis_gtis_gteq (C++20)

名前付きの比較関数 (関数)

概要

namespace std {// comparison category typesclass partial_ordering;class weak_ordering;class strong_ordering;   // named comparison functionsconstexprbool is_eq (partial_ordering cmp)noexcept{return cmp ==0;}constexprbool is_neq (partial_ordering cmp)noexcept{return cmp !=0;}constexprbool is_lt (partial_ordering cmp)noexcept{return cmp <0;}constexprbool is_lteq(partial_ordering cmp)noexcept{return cmp <=0;}constexprbool is_gt (partial_ordering cmp)noexcept{return cmp >0;}constexprbool is_gteq(partial_ordering cmp)noexcept{return cmp >=0;}   // common comparison category typetemplate<class... Ts>struct common_comparison_category {using type =/* see description */;};template<class... Ts>using common_comparison_category_t =typename common_comparison_category<Ts...>::type;   // concept three_way_comparabletemplate<class T, class Cat = partial_ordering> concept three_way_comparable =/* see description */;template<class T, class U, class Cat = partial_ordering> concept three_way_comparable_with =/* see description */;   // result of three-way comparisontemplate<class T, class U = T>struct compare_three_way_result;   template<class T, class U = T>using compare_three_way_result_t =typename compare_three_way_result<T, U>::type;   // class compare_three_waystruct compare_three_way;   // comparison algorithmsinlinenamespace/* unspecified */{inlineconstexpr/* unspecified */ strong_order =/* unspecified */;inlineconstexpr/* unspecified */ weak_order =/* unspecified */;inlineconstexpr/* unspecified */ partial_order =/* unspecified */;inlineconstexpr/* unspecified */ compare_strong_order_fallback =/* unspecified */;inlineconstexpr/* unspecified */ compare_weak_order_fallback =/* unspecified */;inlineconstexpr/* unspecified */ compare_partial_order_fallback =/* unspecified */;}}

コンセプト three_way_comparable

namespace std {template<class T, class Cat> concept __ComparesAs =// exposition only same_as<common_comparison_category_t<T, Cat>, Cat>;   template<class T, class U> concept __PartiallyOrderedWith =// exposition only requires(const remove_reference_t<T>& t, const remove_reference_t<U>& u){{ t < u }-> boolean;{ t > u }-> boolean;{ t <= u }-> boolean;{ t >= u }-> boolean;{ u < t }-> boolean;{ u > t }-> boolean;{ u <= t }-> boolean;{ u >= t }-> boolean;};   template<class T, class Cat = partial_ordering> concept three_way_comparable = __WeaklyEqualityComparableWith<T, T>&& __PartiallyOrderedWith<T, T>&& requires(const remove_reference_t<T>& a, const remove_reference_t<T>& b){{ a <=> b }-> __ComparesAs<Cat>;};}

コンセプト three_way_comparable_with

namespace std {template<class T, class U, class Cat = partial_ordering> concept three_way_comparable_with = __WeaklyEqualityComparableWith<T, U>&& __PartiallyOrderedWith<T, U>&& three_way_comparable<T, Cat>&& three_way_comparable<U, Cat>&& common_reference_with<const remove_reference_t<T>&, const remove_reference_t<U>&>&& three_way_comparable< common_reference_t<const remove_reference_t<T>&, const remove_reference_t<U>&>, Cat>&& requires(const remove_reference_t<T>& t, const remove_reference_t<U>& u){{ t <=> u }-> __ComparesAs<Cat>;{ u <=> t }-> __ComparesAs<Cat>;};}

クラス std::partial_ordering

namespace std {class partial_ordering {int value;// exposition onlybool is_ordered;// exposition only   // exposition-only constructorsconstexprexplicit partial_ordering(eq v)noexcept: value(int(v)), is_ordered(true){}// exposition onlyconstexprexplicit partial_ordering(ord v)noexcept: value(int(v)), is_ordered(true){}// exposition onlyconstexprexplicit partial_ordering(ncmp v)noexcept: value(int(v)), is_ordered(false){}// exposition only   public:// valid valuesstaticconst partial_ordering less;staticconst partial_ordering equivalent;staticconst partial_ordering greater;staticconst partial_ordering unordered;   // comparisonsfriendconstexprbool operator==(partial_ordering v, /* unspecified */)noexcept;friendconstexprbool operator==(partial_ordering v, partial_ordering w)noexcept=default;friendconstexprbool operator<(partial_ordering v, /* unspecified */)noexcept;friendconstexprbool operator>(partial_ordering v, /* unspecified */)noexcept;friendconstexprbool operator<=(partial_ordering v, /* unspecified */)noexcept;friendconstexprbool operator>=(partial_ordering v, /* unspecified */)noexcept;friendconstexprbool operator<(/* unspecified */, partial_ordering v)noexcept;friendconstexprbool operator>(/* unspecified */, partial_ordering v)noexcept;friendconstexprbool operator<=(/* unspecified */, partial_ordering v)noexcept;friendconstexprbool operator>=(/* unspecified */, partial_ordering v)noexcept;friendconstexpr partial_ordering operator<=>(partial_ordering v, /* unspecified */)noexcept;friendconstexpr partial_ordering operator<=>(/* unspecified */, partial_ordering v)noexcept;};   // valid values' definitionsinlineconstexpr partial_ordering partial_ordering::less(ord::less);inlineconstexpr partial_ordering partial_ordering::equivalent(eq::equivalent);inlineconstexpr partial_ordering partial_ordering::greater(ord::greater);inlineconstexpr partial_ordering partial_ordering::unordered(ncmp::unordered);}

クラス std::weak_ordering

namespace std {class weak_ordering {int value;// exposition only   // exposition-only constructorsconstexprexplicit weak_ordering(eq v)noexcept: value(int(v)){}// exposition onlyconstexprexplicit weak_ordering(ord v)noexcept: value(int(v)){}// exposition only   public:// valid valuesstaticconst weak_ordering less;staticconst weak_ordering equivalent;staticconst weak_ordering greater;   // conversionsconstexpr operator partial_ordering()constnoexcept;   // comparisonsfriendconstexprbool operator==(weak_ordering v, /* unspecified */)noexcept;friendconstexprbool operator==(weak_ordering v, weak_ordering w)noexcept=default;friendconstexprbool operator<(weak_ordering v, /* unspecified */)noexcept;friendconstexprbool operator>(weak_ordering v, /* unspecified */)noexcept;friendconstexprbool operator<=(weak_ordering v, /* unspecified */)noexcept;friendconstexprbool operator>=(weak_ordering v, /* unspecified */)noexcept;friendconstexprbool operator<(/* unspecified */, weak_ordering v)noexcept;friendconstexprbool operator>(/* unspecified */, weak_ordering v)noexcept;friendconstexprbool operator<=(/* unspecified */, weak_ordering v)noexcept;friendconstexprbool operator>=(/* unspecified */, weak_ordering v)noexcept;friendconstexpr weak_ordering operator<=>(weak_ordering v, /* unspecified */)noexcept;friendconstexpr weak_ordering operator<=>(/* unspecified */, weak_ordering v)noexcept;};   // valid values' definitionsinlineconstexpr weak_ordering weak_ordering::less(ord::less);inlineconstexpr weak_ordering weak_ordering::equivalent(eq::equivalent);inlineconstexpr weak_ordering weak_ordering::greater(ord::greater);}

クラス std::strong_ordering

namespace std {class strong_ordering {int value;// exposition only   // exposition-only constructorsconstexprexplicit strong_ordering(eq v)noexcept: value(int(v)){}// exposition onlyconstexprexplicit strong_ordering(ord v)noexcept: value(int(v)){}// exposition only   public:// valid valuesstaticconst strong_ordering less;staticconst strong_ordering equal;staticconst strong_ordering equivalent;staticconst strong_ordering greater;   // conversionsconstexpr operator partial_ordering()constnoexcept;constexpr operator weak_ordering()constnoexcept;   // comparisonsfriendconstexprbool operator==(strong_ordering v, /* unspecified */)noexcept;friendconstexprbool operator==(strong_ordering v, strong_ordering w)noexcept=default;friendconstexprbool operator<(strong_ordering v, /* unspecified */)noexcept;friendconstexprbool operator>(strong_ordering v, /* unspecified */)noexcept;friendconstexprbool operator<=(strong_ordering v, /* unspecified */)noexcept;friendconstexprbool operator>=(strong_ordering v, /* unspecified */)noexcept;friendconstexprbool operator<(/* unspecified */, strong_ordering v)noexcept;friendconstexprbool operator>(/* unspecified */, strong_ordering v)noexcept;friendconstexprbool operator<=(/* unspecified */, strong_ordering v)noexcept;friendconstexprbool operator>=(/* unspecified */, strong_ordering v)noexcept;friendconstexpr strong_ordering operator<=>(strong_ordering v, /* unspecified */)noexcept;friendconstexpr strong_ordering operator<=>(/* unspecified */, strong_ordering v)noexcept;};   // valid values' definitionsinlineconstexpr strong_ordering strong_ordering::less(ord::less);inlineconstexpr strong_ordering strong_ordering::equal(eq::equal);inlineconstexpr strong_ordering strong_ordering::equivalent(eq::equivalent);inlineconstexpr strong_ordering strong_ordering::greater(ord::greater);}

クラス std::compare_three_way

namespace std {struct compare_three_way {template<class T, class U> requires three_way_comparable_with<T, U>||/*BUILTIN-PTR-THREE-WAY*/(T, U)constexprauto operator()(T&& t, U&& u)const;   using is_transparent =/* unspecified */;};}

関連項目

三方比較演算子 (C++20)