[#bsl-binary_compose]
= xref:bsl.adoc[bsl]::binary_compose
:relfileprefix: ../
:mrdocs:

This class provides a function object adaptor for three other functors. When given two adaptable unary functions `g1` and `g2`, and a third adaptable binary function `f`, and if `g1` and `g2`s argument type is convertible to `f`s argument type, this class can be used to create a function object `h` that is equivalent to `f(g1(x), g2(x))`.

== Synopsis

Declared in `<bslstp_exfunctional.h>`

[source,cpp,subs="verbatim,replacements,macros,-callouts"]
----
template<
    class OPERATION1,
    class OPERATION2,
    class OPERATION3>
class binary_compose;
----

== Type Aliases

[cols="1,4"]
|===
| Name| Description
| xref:bsl/binary_compose/argument_type.adoc[`argument_type`] 
| This `typedef` is an alias to `OPERATION2::argument_type`.
| xref:bsl/binary_compose/result_type.adoc[`result_type`] 
| This `typedef` is an alias to `OPERATION1::result_type`.
|===


== Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:bsl/binary_compose/2constructor.adoc[`binary_compose`]         [.small]#[constructor]#
| Create a `binary_compose` object from the specified `fn1`, `fn2`, and `fn3` functors.
| xref:bsl/binary_compose/operator_call-00.adoc[`operator()`] 
| Function call operators
|===


== Protected Data Members

[cols="1,4"]
|===
| Name| Description
| xref:bsl/binary_compose/d_fn1.adoc[`d_fn1`] 
| First functor `f` in the composition `f(g1(x), g2(x))`.
| xref:bsl/binary_compose/d_fn2.adoc[`d_fn2`] 
| Second functor `g1` in the composition `f(g1(x), g2(x))`.
| xref:bsl/binary_compose/d_fn3.adoc[`d_fn3`] 
| Third functor `g2` in the composition `f(g1(x), g2(x))`.
|===


== Non-Member Functions

[cols="1,4"]
|===
| Name| Description
| xref:bsl/compose2.adoc[`compose2`]
| Return a `binary_compose` function object constructed using the specified `fn1` binary function, and the specified `fn2` and `fn3` unary functions. The returned function object is equivalent to `fn1(fn2(x), fn3(x))`.
|===


[.small]#Created with https://www.mrdocs.com[MrDocs]#