< cpp‎ | utility‎ | functional
Revision as of 15:30, 2 November 2012 by P12bot (Talk | contribs)

Function objects
Function wrappers
Reference wrappers
Operator wrappers
Deprecated binders and adaptors

Template:ddcl list begin <tr class="t-dsc-header">

Defined in header <functional>

<td></td> <td></td> <tr class="t-dcl ">

<td >

    class Arg1,
    class Arg2,
    class Result

> struct binary_function;

<td class="t-dcl-nopad"> </td> <td > (deprecated) </td> </tr> Template:ddcl list end

binary_function is a base class for creating function objects with two arguments.

binary_function does not define operator(); it is expected that derived classes will define this. binary_function provides only three types - first_argument_type, second_argument_type and result_type - defined by the template parameters.

Some standard library function object adaptors, such as std::not2, require the function objects they adapt to have certain types defined; std::not2 requires the function object being adapted to have two types named first_argument_type and second_argument_type. Deriving function objects that take two arguments from binary_function is an easy way to make them compatible with those adaptors.

binary_function is deprecated in C++11. Its functionality has been made obsolete by std::function and other standard library function objects, which define the necessary types.

Member types

Type Definition
first_argument_type Arg1
second_argument_type Arg2
result_type Result


#include <algorithm>
#include <functional>
#include <iostream>
#include <vector>
struct same : std::binary_function<int, int, bool>
    bool operator()(int a, int b) const { return a == b; }
int main()
    std::vector<int> v1{ 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10};
    std::vector<int> v2{10, 9, 8, 7, 6, 5, 4, 3, 2, 1, 0 };
    std::vector<bool> v3(v1.size());
    std::transform(v1.begin(), v1.end(), v2.begin(), v3.begin(), std::not2(same()));
    std::cout << std::boolalpha;
    for (std::size_t i = 0; i < v1.size(); ++i)
        std::cout << v1[i] << ' ' << v2[i] << ' ' << v3[i] << '\n';


0 10 true
1 9 true
2 8 true
3 7 true
4 6 true
5 5 false
6 4 true
7 3 true
8 2 true
9 1 true

See also

wraps callable object of any type with specified function call signature
(class template) [edit]
creates an adaptor-compatible function object wrapper from a pointer to function
(function template) [edit]
adaptor-compatible wrapper for a pointer to binary function
(class template) [edit]
adaptor-compatible unary function base class
(class template) [edit]