std::function

 

C++

语言

概念

实用工具库

字符串库

容器库

算法库

迭代器库

数值算法库

输入/输出库

本地化库

正则表达式库 (C++11)

原子操作库 (C++11)

线程的支持库 (C++11)

 

实用工具库

类型的支持 (basic types, RTTI, type traits)

动态内存管理

错误处理

程序实用工具

可变参数函数

日期和时间

函数对象

initializer_list (C++11)

bitset

hash (C++11)

关系运算符 原文： Relational operators 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

rel_ops::operator!= rel_ops::operator> rel_ops::operator<= rel_ops::operator>=

双和元组 原文： Pairs and tuples 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

pair

tuple (C++11)

piecewise_construct_t (C++11)

piecewise_construct (C++11)

掉期，远期和移动 原文： Swap, forward and move 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

swap

forward (C++11)

move (C++11)

move_if_noexcept (C++11)

declval (C++11)

 

函数对象

功能包装 原文： Function wrappers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
function (C++11)
mem_fn (C++11)
bad_function_call (C++11)
绑定 原文： Bind 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
bind (C++11)
is_bind_expression (C++11)
is_placeholder (C++11)
_1, _2, _3, ... (C++11)
参考包装 原文： Reference wrappers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
reference_wrapper (C++11)
ref cref (C++11) (C++11)
操作包装 原文： Operator wrappers 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
plus minus negate multiplies divides modulus logical_and logical_or logical_not	equal_to not_equal_to greater less greater_equal less_equal bit_and bit_or bit_xor
否定词 原文： Negators 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
unary_negate binary_negate	not1 not2
已过时粘合剂和适配器 原文： Deprecated binders and adaptors 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。
unary_function (过时)
binary_function (过时)
ptr_fun (过时)
pointer_to_unary_function (过时)
pointer_to_binary_function (过时)
mem_fun (过时)
mem_fun_t mem_fun1_t const_mem_fun_t const_mem_fun1_t (过时) (过时) (过时) (过时)
mem_fun_ref (过时)
mem_fun_ref_t mem_fun1_ref_t const_mem_fun_ref_t const_mem_fun1_ref_t (过时) (过时) (过时) (过时)
binder1st binder2nd (过时) (过时)
bind1st bind2nd (过时) (过时)

 

std::function

成员函数 原文： Member functions 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

function::function

function::~function

function::operator=

function::swap

function::assign

function::operator bool

function::operator()

function::target_type

function::target

非成员函数 原文： Non-member functions 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

operator== operator!=

std::swap(std::function)

Helper类 原文： Helper classes 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。

std::uses_allocator<std::function>

 

定义于头文件 <functional>
template< class > class function; /* 未定义 */		(C++11起)
template< class R, class... Args > class function<R(Args...)>		(C++11起)

类模版 std::function 是一种通用、多态的函数封装。std::function 的实例可以对任何可以调用的 目标 进行存储、复制、和调用操作，这些目标包括函数、lambda 表达式、绑定表达式、以及其它函数对象等。

成员类型

类型	定义
result_type	R
argument_type	T，前提是 sizeof...(Args)==1 且 Args... 中有且仅有 T
first_argument_type	T1，前提是 sizeof...(Args)==2 且 T1 是其中的第一个
second_argument_type	T2，前提是 sizeof...(Args)==2 且 T2 是其中的第二个

成员函数

(constructor)	构造新的std::function实例 (公共成员函数)
(destructor)	析构std::function实例 (公共成员函数)
operator=	为内容赋值 (公共成员函数)
swap	交换内容 (公共成员函数)
assign	为内容赋值一个新的目标 (公共成员函数)
operator bool	检查是否包含了有效的目标 (公共成员函数)
operator()	调用目标 (公共成员函数)
目标访问
target_type	获得std::function所存储的目标的typeid (公共成员函数)
target	获得std::function所存储的目标的指针 (公共成员函数)

非成员函数

std::swap(std::function) (C++11)	特化的std::swap算法 (函数模板)
operator== operator!=	将 std::function 与 std::nullptr 相比较 (函数模板)

辅助类

std::uses_allocator<std::function> (C++11)

特化的std::uses_allocator型特征 (类模板特化)

示例

#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;
    Foo foo(314159);
    f_add_display(foo, 1);
 
    // 保存成员函数和对象
    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);
}

输出：

-9
42
31337
314160
314161
314162
18

相关条目

bad_function_call (C++11)	调用一个空的std::function时抛出的异常 原文： the exception thrown when invoking an empty std::function 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (类)
mem_fn (C++11)	从指向成员的指针创建函数对象 原文： creates a function object out of a pointer to a member 这段文字是通过 Google Translate 自动翻译生成的。 您可以帮助我们检查、纠正翻译中的错误。详情请点击这里。 (函数模板)