friend constexpr weak_ordering operator<=>(weak_ordering v, /*unspecified*/) noexcept; // (1)
friend constexpr weak_ordering operator<=>(/*unspecified*/, weak_ordering v) noexcept; // (2)
概要
- (1) : 左辺の
weak_orderingの値を取得する。 - (2) : 右辺の
weak_orderingの値の表現する順序を反転させた値を取得する。
戻り値
- (1) :
return v - (2) :
return v < 0 ? weak_ordering::greater : (v > 0 ? weak_ordering::less : v)
例外
投げない。
備考
これらの演算子は、weak_orderingがメンバ変数となっている時にその属する型の三方比較演算子のdefault実装を妨げないために定義されている。
それぞれunspecifiedとなっている片側の引数には0リテラルのみが使用できる。それ以外の物を渡した場合、動作は未定義。
例
#include <iostream>
#include <compare>
int main()
{
std::weak_ordering comp1 = 1 <=> 2;
std::weak_ordering comp2 = 1 <=> 1;
std::cout << std::boolalpha;
std::cout << (comp1 < 0) << std::endl;
std::cout << (comp2 == 0) << std::endl;
std::cout << "\n";
// (1)
std::cout << ((comp1 <=> 0) < 0) << std::endl;
std::cout << ((comp2 <=> 0) == 0) << std::endl;
// (2)
std::cout << ((0 <=> comp1) < 0) << std::endl;
std::cout << ((0 <=> comp2) == 0) << std::endl;
}
出力
true
true
true
true
false
true
バージョン
言語
- C++20
処理系
- Clang: ??
- GCC: 10.1 ✅
- Visual C++: 2019 ✅