std::bind1st, std::bind2nd

Определено в заголовке `<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`

Возвращаемое значение

Объект функции, обёртывающий f и x.

Исключения

Может выбросить исключение, определённое реализацией.

Пример

#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); // since C++20 use std::numbers::pi
 
    std::transform(a.begin(), a.end(), r.begin(),
        std::bind1st(std::multiplies<double>(), pi / 180.0));
//  an equivalent lambda is: [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

См. также

binder1stbinder2nd (устарело в C++11)(удалено в C++17)	объект функции, содержащий бинарную функцию и один из её аргументов (шаблон класса)
bind_frontbind_back (C++20)(C++23)	связывает переменное количество аргументов в определённом порядке к объекту функции (функциональная шаблонная функция)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/w/cpp/utility/functional/bind12