std::move_only_function

< cpp‎ | utility‎ | functional
在标头 <functional> 定义
template< class... >
class move_only_function; // 不定义
(C++23 起)
template< class R, class... Args >

class move_only_function<R(Args...)>;
template< class R, class... Args >
class move_only_function<R(Args...) noexcept>;
template< class R, class... Args >
class move_only_function<R(Args...) &>;
template< class R, class... Args >
class move_only_function<R(Args...) & noexcept>;
template< class R, class... Args >
class move_only_function<R(Args...) &&>;
template< class R, class... Args >
class move_only_function<R(Args...) && noexcept>;
template< class R, class... Args >
class move_only_function<R(Args...) const>;
template< class R, class... Args >
class move_only_function<R(Args...) const noexcept>;
template< class R, class... Args >
class move_only_function<R(Args...) const &>;
template< class R, class... Args >
class move_only_function<R(Args...) const & noexcept>;
template< class R, class... Args >
class move_only_function<R(Args...) const &&>;
template< class R, class... Args >

class move_only_function<R(Args...) const && noexcept>;
(C++23 起)

类模板 std::move_only_function 是通用的多态函数包装。 std::move_only_function 对象存储并调用任何可构造(不要求为可移动构造)的可调用 (Callable) 目标——函数、 lambda 表达式bind 表达式或其他函数对象,以及成员函数指针和成员对象指针。

称存储的可调用对象为 std::move_only_function目标。若 std::move_only_function 不含目标,则称之为。不同于 std::function ,调用std::move_only_function 导致未定义行为。

std::move_only_functions 支持在其模板形参中提供的不含 volatile 的每种 cv 限定符引用限定符noexcept 说明符的组合。这些限定符与说明符(若存在)被添加到其 operator()

std::move_only_function 满足可移动构造 (MoveConstructible)可移动赋值 (MoveAssignable) 的要求,但不满足可复制构造 (CopyConstructible)可复制赋值 (CopyAssignable)

成员类型

类型 定义
result_type R

成员函数

(C++23)
构造新的 std::move_only_function 对象
(公开成员函数)
(C++23)
销毁 std::move_only_function 对象
(公开成员函数)
(C++23)
替换或销毁目标
(公开成员函数)
(C++23)
交换二个 std::move_only_function 对象的目标
(公开成员函数)
(C++23)
检查 std::move_only_function 是否拥有目标
(公开成员函数)
(C++23)
调用目标
(公开成员函数)

非成员函数

重载 std::swap 算法
(函数)
(C++23)
比较 std::move_only_functionnullptr
(函数)

注解

推荐实现存储有较小大小的可调用对象于 std::move_only_function 对象内部。这种小对象优化等效地对于函数指针和 std::reference_wrapper 特化要求,并且只能应用到 std::is_nothrow_move_constructible_v<T>true 的类型 T

若从返回纯右值的函数或函数对象(包括无尾随返回类型的 lambda 表达式)初始化返回引用的 std::move_only_function ,则程序非良构,因为禁止绑定返回的引用到临时对象。


功能特性测试
__cpp_lib_move_only_function

示例

参阅

(C++11)
包装具有指定函数调用签名的任意可复制构造类型的可调用对象
(类模板)