std::bind1st, std::bind2nd

来自cppreference.com
< cpp‎ | utility‎ | functional
 
 
工具库
语言支持
类型支持(基本类型、RTTI)
库功能特性测试宏 (C++20)
动态内存管理
程序工具
协程支持 (C++20)
变参数函数
调试支持
(C++26)
三路比较
(C++20)
(C++20)(C++20)(C++20)
(C++20)(C++20)(C++20)
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)   
(C++20)
交换类型运算
(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++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 前*)
bind1stbind2nd
(C++17 前*)(C++17 前*)

(C++17 前*)
(C++17 前*)(C++17 前*)(C++17 前*)(C++17 前*)
(C++20 前*)
(C++20 前*)
 
在标头 <functional> 定义
template< class F, class T >
std::binder1st<F> bind1st( const F& f, const T& x );
(1) (C++11 中弃用)
(C++17 中移除)
template< class F, class T >
std::binder2nd<F> bind2nd( const F& f, const T& x );
(2) (C++11 中弃用)
(C++17 中移除)

绑定给定实参 x 到给定二元函数对象 f 的第一或第二形参。即,在产生的包装器内存储 x,若调用它,则将 x 传递给 f 的第一或第二形参。

1) 绑定 f 的第一实参到 x。相当于调用 std::binder1st<F>(f, typename F::first_argument_type(x))
2) 绑定 f 的第二实参到 x。相当于调用 std::binder2nd<F>(f, typename F::second_argument_type(x))

参数

f - 指向要绑定实参到的函数的指针
x - 要绑定到 f 的实参

返回值

包装 fx 的函数对象。

异常

可能会抛出由实现定义的异常。

示例

#include <algorithm>
#include <cmath>
#include <cstddef>
#include <functional>
#include <iomanip>
#include <iostream>
#include <vector>
 
int main()
{
    std::vector<double> a = {0, 30, 45, 60, 90, 180};
    std::vector<double> r(a.size());
    const double pi = std::acos(-1); // C++20 起使用 std::numbers::pi
 
    std::transform(a.begin(), a.end(), r.begin(),
        std::bind1st(std::multiplies<double>(), pi / 180.0));
//  等价的 lambda 为:[pi](double a){ return a * pi / 180.0; });
 
    for (std::size_t n = 0; n < a.size(); ++n)
        std::cout << std::setw(3) << a[n] << "° = " << std::fixed << r[n]
                  << " rad\n" << std::defaultfloat;
}

输出:

  0° = 0.000000 rad
 30° = 0.523599 rad
 45° = 0.785398 rad
 60° = 1.047198 rad
 90° = 1.570796 rad
180° = 3.141593 rad

参阅

(C++11 中弃用)(C++17 中移除)
持有一个二元函数和它的实参之一的函数对象
(类模板)
(C++20)(C++23)
按顺序绑定一定数量的实参到函数对象
(函数模板)