std::common_with

 

C++

編譯器支援

自由（freestanding）與宿主（hosted）

語言

標準庫

標準庫標頭檔案

具名要求

特性測試宏 (C++20)

語言支援庫

概念庫 (C++20)

診斷庫

記憶體管理庫

超程式設計庫 (C++11)

通用工具庫

容器庫

迭代器庫

範圍庫 (C++20)

演算法庫

字串庫

文字處理庫

數值庫

日期和時間庫

輸入/輸出庫

檔案系統庫 (C++17)

併發支援庫 (C++11)

執行控制庫 (C++26)

技術規範

符號索引

外部庫

 

概念庫

核心語言概念 same_as (C++20) derived_from (C++20) convertible_to (C++20) common_reference_with (C++20) common_with (C++20) integral (C++20) signed_integral (C++20) unsigned_integral (C++20) floating_point (C++20) swappableswappable_with (C++20)(C++20) destructible (C++20) constructible_from (C++20) default_initializable (C++20)   move_constructible (C++20) copy_constructible (C++20) assignable_from (C++20)

比較概念 equality_comparableequality_comparable_with (C++20)(C++20) totally_orderedtotally_ordered_with (C++20)(C++20) 物件概念 movable (C++20) copyable (C++20) semiregular (C++20) regular (C++20) 可呼叫概念 invocableregular_invocable (C++20)(C++20) predicate (C++20) relation (C++20) equivalence_relation (C++20) strict_weak_order (C++20)

僅用於闡釋的概念 boolean-testable  (C++20)

 

定義於標頭檔案 <concepts>
template< class T, class U > concept common_with =     std::same_as<std::common_type_t<T, U>, std::common_type_t<U, T>> &&     requires {         static_cast<std::common_type_t<T, U>>(std::declval<T>());         static_cast<std::common_type_t<T, U>>(std::declval<U>());     } &&     std::common_reference_with<         std::add_lvalue_reference_t<const T>,         std::add_lvalue_reference_t<const U>> &&     std::common_reference_with<         std::add_lvalue_reference_t<std::common_type_t<T, U>>,         std::common_reference_t<             std::add_lvalue_reference_t<const T>,             std::add_lvalue_reference_t<const U>>>;		(C++20 起)

概念 common_with 指定了兩種型別 T 和 U 共享一個公共型別（由 std::common_type_t 計算），並且兩者都可以轉換為該公共型別。

語義要求

T 和 U 建模 std::common_with<T, U> 僅當，給定保持相等的表示式 t1, t2, u1 和 u2，使得 decltype((t1)) 和 decltype((t2)) 都為 T，以及 decltype((u1)) 和 decltype((u2)) 都為 U，

• std::common_type_t<T, U>(t1) 等於 std::common_type_t<T, U>(t2) 當且僅當 t1 等於 t2；並且
• std::common_type_t<T, U>(u1) 等於 std::common_type_t<T, U>(u2) 當且僅當 u1 等於 u2。

換句話說，轉換為公共型別必須保持相等。

相等性保持

在標準庫概念的 requires 表示式中宣告的表示式必須保持相等（除非另有說明）。

參考

• C++23 標準 (ISO/IEC 14882:2024)

• 18.4.6 概念 common_with [concept.common]

• C++20 標準 (ISO/IEC 14882:2020)

• 18.4.6 概念 common_with [concept.common]

另見

common_type (C++11)	確定一組型別的公共型別 (類模板)
common_referencebasic_common_reference (C++20)	確定一組型別的公共引用型別 (類模板)
common_reference_with (C++20)	指定兩種型別共享一個共同的引用型別 (概念)