binder1st クラス

指定した値に二項関数の 1 番目の引数をバインドして二項関数オブジェクトを単項関数オブジェクトに変換するコンストラクターを提供するクラス テンプレート。 bind を推奨する C++11 では非推奨とされ、C++17 では削除されました。

構文

template <class Operation>
class binder1st
    : public unaryFunction <typename Operation::second_argument_type,
                             typename Operation::result_type>
{
public:
    typedef typename Operation::argument_type argument_type;
    typedef typename Operation::result_type result_type;
    binder1st(
        const Operation& binary_fn,
        const typename Operation::first_argument_type& left);

    result_type operator()(const argument_type& right) const;
    result_type operator()(const argument_type& right) const;

protected:
    Operation op;
    typename Operation::first_argument_type value;
};

パラメーター

binary_fn
単項関数オブジェクトに変換する二項関数オブジェクト。

left
二項関数オブジェクトの最初の引数がバインドされている値。

right
調整後の二項オブジェクトが 2 つ目の引数の固定値と比較する引数の値。

戻り値

二項関数オブジェクトの最初の引数を値 left にバインドした結果として生成される単項関数オブジェクト。

解説

クラス テンプレートは、op に格納されているバイナリ関数オブジェクト binary_fn と、value 内の left のコピーを格納します。 そのメンバー関数 operator() は op(value, right) を返すように定義されています。

binary_fn が型 Operation のオブジェクトであり、c が定数である場合は、bind1st(binary_fn, c) は binder1st<Operation>(binary_fn, c) のより便利な同等の機能です。 詳しくは、「bind1st」をご覧ください。

例

// functional_binder1st.cpp
// compile with: /EHsc
#include <vector>
#include <functional>
#include <algorithm>
#include <iostream>

using namespace std;

int main()
{
    vector<int> v1;
    vector<int>::iterator Iter;

    int i;
    for (i = 0; i <= 5; i++)
    {
        v1.push_back(5 * i);
    }

    cout << "The vector v1 = ( ";
    for (Iter = v1.begin(); Iter != v1.end(); Iter++)
        cout << *Iter << " ";
    cout << ")" << endl;

    // Count the number of integers > 10 in the vector
    vector<int>::iterator::difference_type result1;
    result1 = count_if(v1.begin(), v1.end(),
        binder1st<less<int> >(less<int>(), 10));
    cout << "The number of elements in v1 greater than 10 is: "
         << result1 << "." << endl;

    // Compare use of binder2nd fixing 2nd argument:
    // count the number of integers < 10 in the vector
    vector<int>::iterator::difference_type result2;
    result2 = count_if(v1.begin(), v1.end(),
        binder2nd<less<int> >(less<int>(), 10));
    cout << "The number of elements in v1 less than 10 is: "
         << result2 << "." << endl;
}

The vector v1 = ( 0 5 10 15 20 25 )
The number of elements in v1 greater than 10 is: 3.
The number of elements in v1 less than 10 is: 2.