std::is_convertible, std::is_nothrow_convertible

定义于头文件 `<type_traits>`
template< class From, class To > struct is_convertible;	(1)	(since C++11)
template< class From, class To > struct is_nothrow_convertible;	(2)	(since C++20)

1) 如果虚构的函数定义 To test() { return std::declval<From>(); } 是良构的，（即，要么 std::declval<From>() 可以使用隐式转换转换为 To，或者 From 和 To 都是可能带 cv 限定符的 void），则提供等于 true 的成员常量 value。否则 value 为 false。对于此检查的目的，返回语句中 std::declval 的使用不被视为 ODR 使用。

如果 To 是引用类型，并且在将 std::declval<From>() 绑定到 To 时会创建临时对象，则即使这种绑定在实际函数中是不良构的，虚构函数中的 return 语句也被认为是良构的。

(since C++26)

访问检查的执行方式如同来自与任一类型无关的上下文。仅考虑返回语句中表达式的直接上下文（包括到返回类型的转换）的有效性。

2) 与 (1) 相同，但转换也是 noexcept。

如果 From 或 To 不是完整类型、（可能带 cv 限定符的）void 或未知边界的数组，则行为未定义。

如果上述模板的实例化直接或间接地依赖于不完整类型，并且如果假设该类型已完成，则该实例化可能会产生不同的结果，则行为未定义。

如果程序为此页面上描述的任何模板添加了特化，则行为未定义。

继承自 std::integral_constant

成员常量

value

[静态]

true 如果 From 可转换为 To，false 否则为 false
(公共静态成员常量)

成员函数

operator bool	将对象转换为 bool，返回 value (公共成员函数)
operator() (C++14)	返回 value (公共成员函数)

成员类型

类型	定义
`value_type`	bool
`type`	std::integral_constant<bool, value>

[编辑] 可能的实现

is_convertible (1)

namespace detail
{
    template<class T>
    auto test_returnable(int) -> decltype(
        void(static_cast<T(*)()>(nullptr)), std::true_type{}
    );
    template<class>
    auto test_returnable(...) -> std::false_type;
 
    template<class From, class To>
    auto test_implicitly_convertible(int) -> decltype(
        void(std::declval<void(&)(To)>()(std::declval<From>())), std::true_type{}
    );
    template<class, class>
    auto test_implicitly_convertible(...) -> std::false_type;
} // namespace detail
 
template<class From, class To>
struct is_convertible : std::integral_constant<bool,
    (decltype(detail::test_returnable<To>(0))::value &&
     decltype(detail::test_implicitly_convertible<From, To>(0))::value) ||
    (std::is_void<From>::value && std::is_void<To>::value)
> {};

is_nothrow_convertible (2)

template<class From, class To>
struct is_nothrow_convertible : std::conjunction<std::is_void<From>, std::is_void<To>> {};
 
template<class From, class To>
    requires
        requires
        {
            static_cast<To(*)()>(nullptr);
            { std::declval<void(&)(To) noexcept>()(std::declval<From>()) } noexcept;
        }
struct is_nothrow_convertible<From, To> : std::true_type {};

[编辑] 备注

对引用类型、void 类型、数组类型和函数类型给出明确定义的结果。

目前，标准尚未指定转换产生的对象的销毁（结果对象或绑定到引用的临时对象）是否被视为转换的一部分。这是 LWG issue 3400。

所有已知的实现都将销毁视为转换的一部分，如 P0758R1 中提出的那样。

特性测试宏	值	Std	特性
`__cpp_lib_is_nothrow_convertible`	`201806L`	(C++20)	`std::is_nothrow_convertible`

[编辑] 示例

运行此代码

#include <iomanip>
#include <iostream>
#include <string>
#include <string_view>
#include <type_traits>
 
class E { public: template<class T> E(T&&) {} };
 
int main()
{
    class A {};
    class B : public A {};
    class C {};
    class D { public: operator C() { return c; } C c; };
 
    static_assert(std::is_convertible_v<B*, A*>);
    static_assert(!std::is_convertible_v<A*, B*>);
    static_assert(std::is_convertible_v<D, C>);
    static_assert(!std::is_convertible_v<B*, C*>);
    // Note that the Perfect Forwarding constructor makes the class E be
    // "convertible" from everything. So, A is replaceable by B, C, D..:
    static_assert(std::is_convertible_v<A, E>);
 
    static_assert(!std::is_convertible_v<std::string_view, std::string>);
    static_assert(std::is_convertible_v<std::string, std::string_view>);
 
    auto stringify = []<typename T>(T x)
    {
        if constexpr (std::is_convertible_v<T, std::string> or
                      std::is_convertible_v<T, std::string_view>)
            return x;
        else
            return std::to_string(x);
    };
 
    using std::operator "" s, std::operator "" sv;
    const char* three = "three";
 
    std::cout << std::quoted(stringify("one"s)) << ' '
              << std::quoted(stringify("two"sv)) << ' '
              << std::quoted(stringify(three)) << ' '
              << std::quoted(stringify(42)) << ' '
              << std::quoted(stringify(42.0)) << '\n';
}

输出

"one" "two" "three" "42" "42.000000"

[编辑] 参见

is_base_of (C++11)	检查一个类型是否是另一个类型的基类 (类模板) [编辑]
is_pointer_interconvertible_base_of (C++20)	检查一个类型是否是另一个类型的指针可互转换（初始）基类 (类模板) [编辑]
is_pointer_interconvertible_with_class (C++20)	检查一个类型的对象是否与该类型的指定子对象指针可互转换 (函数模板) [编辑]
convertible_to (C++20)	指定一个类型可以隐式转换为另一个类型 (概念) [编辑]

编译器支持
独立式和宿主式
语言
标准库
标准库头文件
命名要求
特性测试宏 (C++20)
语言支持库
概念库 (C++20)
诊断库
内存管理库
元编程库 (C++11)
通用工具库
容器库
迭代器库
范围库 (C++20)
算法库
字符串库
文本处理库
数值库
日期和时间库
输入/输出库
文件系统库 (C++17)
并发支持库 (C++11)
执行控制库 (C++26)
技术规范
符号索引
外部库

template< class From, class To > constexpr bool is_convertible_v = is_convertible<From, To>::value;		(since C++17)
template< class From, class To > constexpr bool is_nothrow_convertible_v = is_nothrow_convertible<From, To>::value;		(since C++20)

cppreference.cn

命名空间

变体

视图

操作