Namespaces
Variants

std::function_ref

来自 zh.cppreference.net
 
 
 
函数对象
函数调用
(C++17)(C++23)
恒等函数对象
(C++20)
透明运算符包装器
(C++14)
(C++14)
(C++14)
(C++14)  
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)
(C++14)

旧式绑定器和适配器
(至 C++17*)
(至 C++17*)
(至 C++17*)
(至 C++17*)
(至 C++17*)(至 C++17*)(至 C++17*)(至 C++17*)
(至 C++20*)
(至 C++20*)
(至 C++17*)(至 C++17*)
(至 C++17*)(至 C++17*)

(至 C++17*)
(至 C++17*)(至 C++17*)(至 C++17*)(至 C++17*)
(至 C++20*)
(至 C++20*)
 
 
定义于头文件 <functional>
template< class... >
class function_ref; // not defined
(1) (自 C++26 起)
template< class R, class... Args >
class function_ref<R(Args...)>;
template< class R, class... Args >
class function_ref<R(Args...) noexcept>;
template< class R, class... Args >
class function_ref<R(Args...) const>;
template< class R, class... Args >
class function_ref<R(Args...) const noexcept>;
(2) (自 C++26 起)

类模板 std::function_ref 是一个非拥有型函数包装器。std::function_ref 对象可以存储并调用对可调用 目标的引用——函数、lambda 表达式、绑定表达式或其他函数对象,但不包括指向成员函数的指针和指向成员对象的指针。std::nontype 可用于通过传递函数指针、指向成员函数的指针和指向成员对象的指针来构造 std::function_ref。

std::function_refs 支持模板参数中提供的cv 限定符(不包括 volatile)和noexcept 说明符的所有可能组合。

std::function_ref 的每个特化都是满足可平凡复制且符合可复制的

成员类型

成员 定义
BoundEntityType (私有) 未指定的 TriviallyCopyable 类型,满足 copyable 概念,且能够存储对象指针值或函数指针值
( 仅用于说明的成员类型* )
FunctionPointerType (私有) R ( * ) ( BoundEntityType  , Args && ... ) noexcept ( noex  )

其中 noex 为 true (当函数签名中作为 std::function_ref 模板参数的一部分包含 noexcept 时),否则为 false
( 仅用于说明的成员类型* )

数据成员

成员 定义
BoundEntityType bound-entity 绑定实体对象
( 仅用于说明的成员对象* )
FunctionPointerType thunk-ptr 存储的函数指针
( 仅用于说明的成员对象* )

成员函数

构造新的 function_ref 对象
(公开成员函数)
赋值 function_ref
(公开成员函数)
调用 function_ref 存储的 thunk
(公开成员函数)

推导指引

注释

功能测试 宏 值 标准 功能
__cpp_lib_function_ref 202306L (C++26) std::function_ref

示例

参见

(C++11)
任何可复制构造可调用对象的可复制包装器
(类模板)
支持给定调用签名中限定符的任何可复制构造可调用对象的可复制包装器
(类模板)
支持给定调用签名中限定符的任何可调用对象的仅移动包装器
(类模板)
值构造标签
(标签)