std::function

来自cppreference.com
< cpp‎ | utility‎ | functional
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)
 
函数对象
函数包装
function
(C++11)
(C++11)
部分函数应用
(C++11)
(C++20)(C++23)
函数调用
(C++17)(C++23)
恒等函数对象
(C++20)
引用包装
(C++11)(C++11)
通透运算符包装
(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++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; /* 未定义 */
(C++11 起)
template< class R, class... Args >
class function<R(Args...)>;
(C++11 起)

类模板 std::function 是通用多态函数包装器。 std::function 的实例能存储、复制及调用任何可复制构造 (CopyConstructible) 可调用 (Callable) 目标——函数(通过其指针)、 lambda 表达式bind 表达式或其他函数对象,还有指向成员函数指针和指向数据成员指针。

存储的可调用对象被称为 std::function目标。若 std::function 不含目标,则称它为。调用 std::function目标导致抛出 std::bad_function_call 异常。

std::function 满足可复制构造 (CopyConstructible) 可复制赋值 (CopyAssignable)

成员类型

类型 定义
result_type R
argument_type(C++17 中弃用)(C++20 中移除) sizeof...(Args)==1TArgs... 中首个且唯一的类型,则为 T
first_argument_type(C++17 中弃用)(C++20 中移除) sizeof...(Args)==2T1Args... 中二个类型的第一个,则为 T1
second_argument_type(C++17 中弃用)(C++20 中移除) sizeof...(Args)==2T2Args... 中二个类型的第二个,则为 T2

成员函数

构造新的 std::function 实例
(公开成员函数)
析构 std::function 实例
(公开成员函数)
为内容赋值
(公开成员函数)
交换内容
(公开成员函数)
(C++17 中移除)
为内容赋值一个新的目标
(公开成员函数)
检查是否包含了有效的目标
(公开成员函数)
调用其目标
(公开成员函数)
目标访问
获得目标对象的 typeid
(公开成员函数)
获得指向 std::function 所存储的目标的指针
(公开成员函数)

非成员函数

特化 std::swap 算法
(函数模板)
(C++20 中移除)
比较 std::functionnullptr
(函数模板)

辅助类

特化 std::uses_allocator 类型特性
(类模板特化)

推导指引(C++17 起)

注解

当结果类型为引用的 std::function 从无尾随返回类型的 lambda 表达式初始化时需要留心。由于 auto 推导的起效方式,这种 lambda 表达式将始终返回纯右值。故而结果引用将始终绑定到生命期在 std::function::operator() 返回时结束的临时量。

(C++23 前)

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

(C++23 起)
std::function<const int&()> F([]{ return 42; }); // C++23 起错误:不能绑定返回的引用到临时对象
 
int x = F(); // C++23 前为未定义行为: F() 的结果是悬垂引用
 
std::function<int&()> G([]()->int& { static int i{0x2A}; return i; }); // OK
 
std::function<const int&()> H([i{052}]->const int& { return i; }); // OK

示例

#include <functional>
#include <iostream>
 
struct Foo {
    Foo(int num) : num_(num) {}
    void print_add(int i) const { std::cout << num_+i << '\n'; }
    int num_;
};
 
void print_num(int i)
{
    std::cout << i << '\n';
}
 
struct PrintNum {
    void operator()(int i) const
    {
        std::cout << i << '\n';
    }
};
 
int main()
{
    // 存储自由函数
    std::function<void(int)> f_display = print_num;
    f_display(-9);
 
    // 存储 lambda
    std::function<void()> f_display_42 = []() { print_num(42); };
    f_display_42();
 
    // 存储到 std::bind 调用的结果
    std::function<void()> f_display_31337 = std::bind(print_num, 31337);
    f_display_31337();
 
    // 存储到成员函数的调用
    std::function<void(const Foo&, int)> f_add_display = &Foo::print_add;
    const Foo foo(314159);
    f_add_display(foo, 1);
    f_add_display(314159, 1);
 
    // 存储到数据成员访问器的调用
    std::function<int(Foo const&)> f_num = &Foo::num_;
    std::cout << "num_: " << f_num(foo) << '\n';
 
    // 存储到成员函数及对象的调用
    using std::placeholders::_1;
    std::function<void(int)> f_add_display2 = std::bind( &Foo::print_add, foo, _1 );
    f_add_display2(2);
 
    // 存储到成员函数和对象指针的调用
    std::function<void(int)> f_add_display3 = std::bind( &Foo::print_add, &foo, _1 );
    f_add_display3(3);
 
    // 存储到函数对象的调用
    std::function<void(int)> f_display_obj = PrintNum();
    f_display_obj(18);
 
    auto factorial = [](int n) {
        // 存储 lambda 对象以模拟“递归 lambda ”,注意额外开销
        std::function<int(int)> fac = [&](int n){ return (n < 2) ? 1 : n*fac(n-1); };
        // note that "auto fac = [&](int n){...};" does not work in recursive calls
        return fac(n);
    };
    for (int i{5}; i != 8; ++i) { std::cout << i << "! = " << factorial(i) << ";  "; }
}

可能的输出:

-9
42
31337
314160
314160
num_: 314159
314161
314162
18
5! = 120;  6! = 720;  7! = 5040;

参阅

包装具有指定函数调用签名的任意类型的可调用对象
(类模板)
调用空的 std::function 时抛出的异常
(类)
(C++11)
从成员指针创建出函数对象
(函数模板)