std::copyable_function
定义在头文件 <functional> 中 |
||
template< class... > class copyable_function; // 未定义 |
(1) | (从 C++26 开始) |
template< class R, class... Args > class copyable_function<R(Args...)>; |
(2) | (从 C++26 开始) |
类模板 std::copyable_function
是一个通用的多态函数包装器。std::copyable_function
对象可以存储和调用任何 可复制构造 可调用 目标 — 函数、lambda 表达式、bind 表达式 或其他函数对象,以及指向成员函数的指针和指向成员对象的指针。
存储的可调用对象称为 `std::copyable_function` 的目标。如果 `std::copyable_function` 不包含目标,则称为空。与 std::function 不同,调用空 `std::copyable_function` 会导致未定义的行为。
std::copyable_function
支持在模板参数中提供的所有可能的 cv 限定符、引用限定符 和 noexcept 说明符 的组合,不包括 volatile。这些限定符和说明符(如果有)将被添加到其 operator()
中。
std::copyable_function
满足 可复制构造 和 可复制赋值 的要求。
内容 |
[编辑] 成员类型
类型 | 定义 |
result_type
|
R
|
[编辑] 成员函数
构造新的 `std::copyable_function` 对象 (公共成员函数) | |
销毁 `std::copyable_function` 对象 (公共成员函数) | |
替换或销毁目标 (公共成员函数) | |
交换两个 `std::copyable_function` 对象的目标 (公共成员函数) | |
检查 `std::copyable_function` 是否有目标 (公共成员函数) | |
调用目标 (公共成员函数) |
[编辑] 非成员函数
(C++26) |
重载 std::swap 算法 (函数) |
(C++26) |
比较 `std::copyable_function` 与 nullptr (函数) |
[编辑] 注释
实现可能会在 `std::copyable_function` 对象中存储大小较小的可调用对象。这种小对象优化实际上是函数指针和 std::reference_wrapper 特化的要求,并且只能应用于 std::is_nothrow_move_constructible_v<T> 为 true 的类型 `T`。
功能测试 宏 | 值 | Std | 功能 |
---|---|---|---|
__cpp_lib_copyable_function |
202306L | (C++26) | std::copyable_function
|
[编辑] 示例
本节不完整 原因:示例 |
[编辑] 参见
(C++11) |
任何可复制构造的可调用对象的复制包装器 (类模板) |
(C++23) |
任何支持给定调用签名中限定符的可调用对象的移动专用包装器 (类模板) |