std::convertible_to

 

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 From, class To > concept convertible_to =     std::is_convertible_v<From, To> &&     requires {         static_cast<To>(std::declval<From>());     };		(C++20 起)

概念 convertible_to<From, To> 指定了一個表示式，其型別和值類別與 std::declval<From>() 相同，可以隱式和顯式轉換為型別 To，並且這兩種轉換形式產生相同的結果。

語義要求

convertible_to<From, To> 僅在以下條件滿足時才被建模：給定一個型別為 std::add_rvalue_reference_t<From>() 的函式 fun，且表示式 fun() 是相等性保持的，

• 要麼
  • To 既不是物件型別也不是物件引用型別，或者
  • static_cast<To>(fun()) 等於 []() -> To { return fun(); }()，並且

• 以下之一為真
  • std::add_rvalue_reference_t<From> 不是物件引用型別，或者
  • std::add_rvalue_reference_t<From> 是對非 const-qualified 型別的右值引用，並且在上述任一表達式之後，由 fun() 引用的物件狀態有效但未指定；或者
  • 由 fun() 引用的物件未被上述任一表達式修改。

相等性保持

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

參考

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

• 18.4.4 概念 convertible_to [concept.convertible]

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

• 18.4.4 概念 convertible_to [concept.convertible]

參見

is_convertibleis_nothrow_convertible (C++11)(C++20)

檢查一個型別是否可以轉換為另一個型別 (類模板)