std::convertible_to (自 C++20 起)

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名需求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (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 限定类型的右值引用，并且 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)

检查一个类型是否可以转换为另一个类型 (类模板)