std::function<R(Args...)>::operator()

来自cppreference.com
< cpp‎ | utility‎ | functional‎ | function
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (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)
 
函数对象
函数包装
(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 前)
 
 
R operator()( Args... args ) const;
(C++11 起)

以参数 args 调用存储的可调用函数目标。

等效于进行 INVOKE<R>(f, std::forward<Args>(args)...),其中 f*this目标对象

参数

args - 传递给存储的可调用函数目标的参数

返回值

Rvoid 时没有返回值。否则返回存储的可调用对象的调用返回值。

异常

在没有存储可调用函数目标,即 !*this == true 时抛出 std::bad_function_call

示例

下列示例展示能如何将 std::function 按值传递给另一函数。而且,它演示 std::function 能如何存储 lambda。

#include <functional>
#include <iostream>
 
void call(std::function<int()> f) // 能按值传递
{ 
    std::cout << f() << '\n';
}
 
int normal_function()
{
    return 42;
}
 
int main()
{
    int n = 1;
    std::function<int()> f = [&n](){ return n; };
    call(f);
 
    n = 2;
    call(f);
 
    f = normal_function;
    call(f);
}

输出:

1
2
42

参阅

调用目标
(std::move_only_function 的公开成员函数)
调用其所存储的函数
(std::reference_wrapper<T> 的公开成员函数)
调用空的 std::function 时抛出的异常
(类)
(C++17)(C++23)
以给定实参和可能指定的返回类型 (C++23 起)调用任意可调用 (Callable) 对象
(函数模板)