2007-02-15 23:11:24 +00:00
< html >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=ISO-8859-1" >
< title > unfused_generic< / title >
< link rel = "stylesheet" href = "../../../boostbook.css" type = "text/css" >
< meta name = "generator" content = "DocBook XSL Stylesheets V1.68.1" >
< link rel = "start" href = "../../../index.html" title = "Chapter<65> 1.<2E> Fusion 2.0" >
< link rel = "up" href = "../adapters.html" title = " Adapters" >
< link rel = "prev" href = "fused_function_object.html" title = "fused_function_object" >
< link rel = "next" href = "unfused_lvalue_args.html" title = "unfused_lvalue_args" >
< / head >
< body bgcolor = "white" text = "black" link = "#0000FF" vlink = "#840084" alink = "#0000FF" >
< table cellpadding = "2" width = "100%" >
< td valign = "top" > < img alt = "Boost C++ Libraries" width = "277" height = "86" src = "../../../../../../../boost.png" > < / td >
< td align = "center" > < a href = "../../../../../../../index.htm" > Home< / a > < / td >
< td align = "center" > < a href = "../../../../../../libraries.htm" > Libraries< / a > < / td >
< td align = "center" > < a href = "../../../../../../../people/people.htm" > People< / a > < / td >
< td align = "center" > < a href = "../../../../../../../more/faq.htm" > FAQ< / a > < / td >
< td align = "center" > < a href = "../../../../../../../more/index.htm" > More< / a > < / td >
< / table >
< hr >
< div class = "spirit-nav" >
< a accesskey = "p" href = "fused_function_object.html" > < img src = "../../../images/prev.png" alt = "Prev" > < / a > < a accesskey = "u" href = "../adapters.html" > < img src = "../../../images/up.png" alt = "Up" > < / a > < a accesskey = "h" href = "../../../index.html" > < img src = "../../../images/home.png" alt = "Home" > < / a > < a accesskey = "n" href = "unfused_lvalue_args.html" > < img src = "../../../images/next.png" alt = "Next" > < / a >
< / div >
< div class = "section" lang = "en" >
< div class = "titlepage" > < div > < div > < h4 class = "title" >
< a name = "fusion.functional.adapters.unfused_generic" > < / a > < a href = "unfused_generic.html" title = "unfused_generic" > unfused_generic< / a > < / h4 > < / div > < / div > < / div >
< a name = "fusion.functional.adapters.unfused_generic.description" > < / a > < h5 >
2007-02-25 22:02:27 +00:00
< a name = "id1213482" > < / a >
2007-02-15 23:11:24 +00:00
< a href = "unfused_generic.html#fusion.functional.adapters.unfused_generic.description" > Description< / a >
< / h5 >
< p >
An n-ary < a href = "../concepts/poly.html" title = " Polymorphic Function
Object">Polymorphic Function
Object< / a > adapter template for an unary < a href = "../concepts/poly.html" title = " Polymorphic Function
Object">Polymorphic
Function Object< / a > target function. When called, its arguments are
bundled to a < a href = "../../sequences/concepts/random_access_sequence.html" title = "Random
Access Sequence">Random
Access Sequence< / a > of references that is passed to the target function.
Non-const LValue arguments are transported as references to non-const,
otherwise references to const are used.
< / p >
< div class = "tip" > < table border = "0" summary = "Tip" >
< tr >
< td rowspan = "2" align = "center" valign = "top" width = "25" > < img alt = "[Tip]" src = "../../../images/tip.png" > < / td >
< th align = "left" > Tip< / th >
< / tr >
< tr > < td align = "left" valign = "top" > < p >
Detecting mutable LValues on a per-argument basis is currently a compile
time expensive operation (see < a href = "http://www.open-std.org/jtc1/sc22/wg21/docs/papers/2002/n1385.htm" target = "_top" > The
Forwarding Problem< / a > for details). Therefore, there are two, lightweight
and more restricted variants of this class template, < a href = "unfused_lvalue_args.html" title = "unfused_lvalue_args" > < code class = "computeroutput" > < span class = "identifier" > unfused_lvalue_args< / span > < / code > < / a > and < a href = "unfused_rvalue_args.html" title = "unfused_rvalue_args" > < code class = "computeroutput" > < span class = "identifier" > unfused_rvalue_args< / span > < / code > < / a > .
< / p > < / td > < / tr >
< / table > < / div >
< p >
The overload set of the adapter's function call operator can be restricted
by removing the < code class = "computeroutput" > < span class = "identifier" > type< / span > < / code > member
from the nested result metafunction of the < a href = "../concepts/poly.html" title = " Polymorphic Function
Object">Polymorphic
Function Object< / a > (in this case the substitution-failure-is-not-an-error
principle applies for non-nullary case and nullary calls are explicitly
disabled by the library).
< / p >
< div class = "caution" > < table border = "0" summary = "Caution" >
< tr >
< td rowspan = "2" align = "center" valign = "top" width = "25" > < img alt = "[Caution]" src = "../../../images/caution.png" > < / td >
< th align = "left" > Caution< / th >
< / tr >
< tr > < td align = "left" valign = "top" > < p >
As the nullary call operator cannot be a template it will be instantiated
along with the class template, so it must be disabled (as described above)
in cases where it isn't instantiable.
< / p > < / td > < / tr >
< / table > < / div >
< p >
The type of the target function is allowed to be const qualified or a reference.
Const qualification is preserved and propagated appropriately (in other
words, only const versions of < code class = "literal" > operator()< / code > can be used
if the target function object is const - or, in case the target function
object is held by value, the adapter is const).
< / p >
< a name = "fusion.functional.adapters.unfused_generic.header" > < / a > < h5 >
2007-02-25 22:02:27 +00:00
< a name = "id1213642" > < / a >
2007-02-15 23:11:24 +00:00
< a href = "unfused_generic.html#fusion.functional.adapters.unfused_generic.header" > Header< / a >
< / h5 >
< pre class = "programlisting" >
< span class = "preprocessor" > #include< / span > < span class = "special" > < < / span > < span class = "identifier" > boost< / span > < span class = "special" > /< / span > < span class = "identifier" > fusion< / span > < span class = "special" > /< / span > < span class = "identifier" > functional< / span > < span class = "special" > /< / span > < span class = "identifier" > adapter< / span > < span class = "special" > /< / span > < span class = "identifier" > unfused_generic< / span > < span class = "special" > .< / span > < span class = "identifier" > hpp< / span > < span class = "special" > > < / span >
< / pre >
< a name = "fusion.functional.adapters.unfused_generic.synopsis" > < / a > < h5 >
2007-02-25 22:02:27 +00:00
< a name = "id1213736" > < / a >
2007-02-15 23:11:24 +00:00
< a href = "unfused_generic.html#fusion.functional.adapters.unfused_generic.synopsis" > Synopsis< / a >
< / h5 >
< pre class = "programlisting" >
< span class = "keyword" > template< / span > < span class = "special" > < < / span > < span class = "keyword" > class< / span > < span class = "identifier" > Function< / span > < span class = "special" > > < / span >
< span class = "keyword" > class< / span > < span class = "identifier" > unfused_generic< / span > < span class = "special" > ;< / span >
< / pre >
< a name = "fusion.functional.adapters.unfused_generic.template_parameters" > < / a > < h5 >
2007-02-25 22:02:27 +00:00
< a name = "id1213806" > < / a >
2007-02-15 23:11:24 +00:00
< a href = "unfused_generic.html#fusion.functional.adapters.unfused_generic.template_parameters" > Template
parameters< / a >
< / h5 >
< div class = "informaltable" > < table class = "table" >
< colgroup >
< col >
< col >
< col >
< / colgroup >
< thead > < tr >
< th > Parameter< / th >
< th > Description< / th >
< th > Default< / th >
< / tr > < / thead >
< tbody > < tr >
< td > < code class = "computeroutput" > < span class = "identifier" > Function< / span > < / code > < / td >
< td > An
unary < a href = "../concepts/poly.html" title = " Polymorphic Function
Object">Polymorphic
Function Object< / a >
< / td >
< td > <EFBFBD> < / td >
< / tr > < / tbody >
< / table > < / div >
< a name = "fusion.functional.adapters.unfused_generic.model_of" > < / a > < h5 >
2007-02-25 22:02:27 +00:00
< a name = "id1213881" > < / a >
2007-02-15 23:11:24 +00:00
< a href = "unfused_generic.html#fusion.functional.adapters.unfused_generic.model_of" > Model
of< / a >
< / h5 >
< div class = "itemizedlist" > < ul type = "disc" >
< li > < a href = "../concepts/poly.html" title = " Polymorphic Function
Object">Polymorphic Function
Object< / a > < / li >
< li > < a href = "../concepts/def_callable.html" title = " Deferred
Callable Object">Deferred Callable
Object< / a > < / li >
< / ul > < / div >
< div class = "variablelist" >
< p class = "title" > < b > Notation< / b > < / p >
< dl >
< dt > < span class = "term" > < code class = "computeroutput" > < span class = "identifier" > F< / span > < / code > < / span > < / dt >
< dd >
A possibly const qualified, unary < a href = "../concepts/poly.html" title = " Polymorphic Function
Object">Polymorphic
Function Object< / a > type or reference type thereof
< / dd >
< dt > < span class = "term" > < code class = "computeroutput" > < span class = "identifier" > f< / span > < / code > < / span > < / dt >
< dd >
An object convertible to < code class = "computeroutput" > < span class = "identifier" > F< / span > < / code >
< / dd >
< dt > < span class = "term" > < code class = "computeroutput" > < span class = "identifier" > UG< / span > < / code > < / span > < / dt >
< dd >
The type < code class = "computeroutput" > < span class = "identifier" > unfused_generic< / span > < span class = "special" > < < / span > < span class = "identifier" > F< / span > < span class = "special" > > < / span > < / code >
< / dd >
< dt > < span class = "term" > < code class = "computeroutput" > < span class = "identifier" > ug< / span > < / code > < / span > < / dt >
< dd >
An instance of < code class = "computeroutput" > < span class = "identifier" > UG< / span > < / code > , initialized
with < code class = "computeroutput" > < span class = "identifier" > f< / span > < / code >
< / dd >
< dt > < span class = "term" > < code class = "computeroutput" > < span class = "identifier" > a0< / span > < / code > ...< code class = "computeroutput" > < span class = "identifier" > aN< / span > < / code > < / span > < / dt >
< dd >
Arguments to < code class = "computeroutput" > < span class = "identifier" > ug< / span > < / code >
< / dd >
< / dl >
< / div >
< a name = "fusion.functional.adapters.unfused_generic.expression_semantics" > < / a > < h5 >
2007-02-25 22:02:27 +00:00
< a name = "id1214088" > < / a >
2007-02-15 23:11:24 +00:00
< a href = "unfused_generic.html#fusion.functional.adapters.unfused_generic.expression_semantics" > Expression
Semantics< / a >
< / h5 >
< div class = "informaltable" > < table class = "table" >
< colgroup >
< col >
< col >
< / colgroup >
< thead > < tr >
< th > Expression< / th >
< th > Semantics< / th >
< / tr > < / thead >
< tbody >
< tr >
< td > < code class = "computeroutput" > < span class = "identifier" > UG< / span > < span class = "special" > (< / span > < span class = "identifier" > f< / span > < span class = "special" > )< / span > < / code > < / td >
< td > Creates
a fused function as described above, initializes the target function
with < code class = "computeroutput" > < span class = "identifier" > f< / span > < / code > .< / td >
< / tr >
< tr >
< td > < code class = "computeroutput" > < span class = "identifier" > UG< / span > < span class = "special" > ()< / span > < / code > < / td >
< td > Creates
a fused function as described above, attempts to use < code class = "computeroutput" > < span class = "identifier" > F< / span > < / code > 's default constructor.< / td >
< / tr >
< tr >
< td >
< code class = "computeroutput" > < span class = "identifier" > ug< / span > < span class = "special" > (< / span > < span class = "identifier" > a0< / span > < / code > ...< code class = "computeroutput" > < span class = "identifier" > aN< / span > < span class = "special" > )< / span > < / code >
< / td >
< td > Calls < code class = "computeroutput" > < span class = "identifier" > f< / span > < / code > with a < a href = "../../sequences.html" title = "Sequences" > Sequence< / a >
that contains references to the arguments < code class = "computeroutput" > < span class = "identifier" > a0< / span > < / code > ...< code class = "computeroutput" > < span class = "identifier" > aN< / span > < / code > .< / td >
< / tr >
< / tbody >
< / table > < / div >
< a name = "fusion.functional.adapters.unfused_generic.example" > < / a > < h5 >
2007-02-25 22:02:27 +00:00
< a name = "id1214276" > < / a >
2007-02-15 23:11:24 +00:00
< a href = "unfused_generic.html#fusion.functional.adapters.unfused_generic.example" > Example< / a >
< / h5 >
< pre class = "programlisting" >
< span class = "keyword" > template< / span > < span class = "special" > < < / span > < span class = "keyword" > typename< / span > < span class = "identifier" > Function< / span > < span class = "special" > ,< / span > < span class = "keyword" > typename< / span > < span class = "identifier" > T< / span > < span class = "special" > > < / span >
< span class = "keyword" > class< / span > < span class = "identifier" > fused_bound_1st< / span >
< span class = "special" > {< / span >
< span class = "keyword" > typename< / span > < span class = "identifier" > traits< / span > < span class = "special" > ::< / span > < a href = "../../support/deduce.html" title = "deduce" > < code class = "computeroutput" > < span class = "identifier" > deduce< / span > < / code > < / a > < span class = "special" > < < / span > < span class = "identifier" > Function< / span > < span class = "special" > > ::< / span > < span class = "identifier" > type< / span > < span class = "identifier" > fnc_deferred< / span > < span class = "special" > ;< / span >
< span class = "keyword" > typename< / span > < span class = "identifier" > traits< / span > < span class = "special" > ::< / span > < a href = "../../support/deduce.html" title = "deduce" > < code class = "computeroutput" > < span class = "identifier" > deduce< / span > < / code > < / a > < span class = "special" > < < / span > < span class = "identifier" > T< / span > < span class = "special" > > ::< / span > < span class = "identifier" > type< / span > < span class = "identifier" > xxx_bound< / span > < span class = "special" > ;< / span >
< span class = "keyword" > public< / span > < span class = "special" > :< / span >
< span class = "identifier" > fused_bound_1st< / span > < span class = "special" > (< / span > < span class = "identifier" > Function< / span > < span class = "identifier" > deferred< / span > < span class = "special" > ,< / span > < span class = "identifier" > T< / span > < span class = "identifier" > bound< / span > < span class = "special" > )< / span >
< span class = "special" > :< / span > < span class = "identifier" > fnc_deferred< / span > < span class = "special" > (< / span > < span class = "identifier" > deferred< / span > < span class = "special" > ),< / span > < span class = "identifier" > xxx_bound< / span > < span class = "special" > (< / span > < span class = "identifier" > bound< / span > < span class = "special" > )< / span >
< span class = "special" > {< / span > < span class = "special" > }< / span >
< span class = "keyword" > template< / span > < span class = "special" > < < / span > < span class = "keyword" > class< / span > < span class = "identifier" > Seq< / span > < span class = "special" > > < / span >
< span class = "keyword" > struct< / span > < span class = "identifier" > result< / span >
2007-02-25 22:02:27 +00:00
< span class = "special" > :< / span > < a href = "../invocation/metafunctions/invoke.html" title = "invoke" > < code class = "computeroutput" > < span class = "identifier" > result_of< / span > < span class = "special" > ::< / span > < span class = "identifier" > invoke< / span > < / code > < / a > < span class = "special" > < < / span > < span class = "identifier" > Function< / span > < span class = "special" > ,< / span >
< span class = "keyword" > typename< / span > < a href = "../../algorithms/transformation/metafunctions/push_front.html" title = "push_front" > < code class = "computeroutput" > < span class = "identifier" > result_of< / span > < span class = "special" > ::< / span > < span class = "identifier" > push_front< / span > < / code > < / a > < span class = "special" > < < / span > < span class = "identifier" > Seq< / span > < span class = "special" > ,< / span > < span class = "identifier" > T< / span > < span class = "special" > > ::< / span > < span class = "identifier" > type< / span > < span class = "special" > > < / span >
2007-02-15 23:11:24 +00:00
< span class = "special" > {< / span > < span class = "special" > };< / span >
< span class = "keyword" > template< / span > < span class = "special" > < < / span > < span class = "keyword" > class< / span > < span class = "identifier" > Seq< / span > < span class = "special" > > < / span >
< span class = "keyword" > typename< / span > < span class = "identifier" > result< / span > < span class = "special" > < < / span > < span class = "identifier" > Seq< / span > < span class = "special" > > ::< / span > < span class = "identifier" > type< / span > < span class = "keyword" > operator< / span > < span class = "special" > ()(< / span > < span class = "identifier" > Seq< / span > < span class = "keyword" > const< / span > < span class = "special" > & < / span > < span class = "identifier" > s< / span > < span class = "special" > )< / span > < span class = "keyword" > const< / span >
< span class = "special" > {< / span >
2007-02-25 22:02:27 +00:00
< span class = "keyword" > return< / span > < a href = "../invocation/functions/invoke.html" title = "invoke" > < code class = "computeroutput" > < span class = "identifier" > invoke< / span > < / code > < / a > < span class = "special" > (< / span > < span class = "identifier" > fnc_deferred< / span > < span class = "special" > ,< / span > < span class = "identifier" > push_front< / span > < span class = "special" > (< / span > < span class = "identifier" > s< / span > < span class = "special" > ,< / span > < span class = "identifier" > xxx_bound< / span > < span class = "special" > ));< / span >
2007-02-15 23:11:24 +00:00
< span class = "special" > }< / span >
< span class = "special" > };< / span >
< span class = "keyword" > template< / span > < span class = "special" > < < / span > < span class = "keyword" > typename< / span > < span class = "identifier" > Function< / span > < span class = "special" > ,< / span > < span class = "keyword" > typename< / span > < span class = "identifier" > T< / span > < span class = "special" > > < / span >
< span class = "identifier" > unfused_generic< / span > < span class = "special" > < < / span > < span class = "identifier" > fused_bound_1st< / span > < span class = "special" > < < / span > < span class = "identifier" > Function< / span > < span class = "special" > ,< / span > < span class = "identifier" > T< / span > < span class = "special" > > < / span > < span class = "special" > > < / span >
< span class = "identifier" > bind_1st< / span > < span class = "special" > (< / span > < span class = "identifier" > Function< / span > < span class = "identifier" > f< / span > < span class = "special" > ,< / span > < span class = "identifier" > T< / span > < span class = "keyword" > const< / span > < span class = "special" > & < / span > < span class = "identifier" > x< / span > < span class = "special" > )< / span >
< span class = "special" > {< / span >
< span class = "keyword" > return< / span > < span class = "identifier" > unfused_generic< / span > < span class = "special" > < < / span > < span class = "identifier" > fused_bound_1st< / span > < span class = "special" > < < / span > < span class = "identifier" > Function< / span > < span class = "special" > ,< / span > < span class = "identifier" > T< / span > < span class = "special" > > < / span > < span class = "special" > > (< / span >
< span class = "identifier" > fused_bound_1st< / span > < span class = "special" > < < / span > < span class = "identifier" > Function< / span > < span class = "special" > ,< / span > < span class = "identifier" > T< / span > < span class = "special" > > (< / span > < span class = "identifier" > f< / span > < span class = "special" > ,< / span > < span class = "identifier" > x< / span > < span class = "special" > )< / span > < span class = "special" > );< / span >
< span class = "special" > }< / span >
< span class = "keyword" > int< / span > < span class = "identifier" > test_func< / span > < span class = "special" > (< / span > < span class = "keyword" > int< / span > < span class = "identifier" > a< / span > < span class = "special" > ,< / span > < span class = "keyword" > int< / span > < span class = "identifier" > b< / span > < span class = "special" > ,< / span > < span class = "keyword" > int< / span > < span class = "identifier" > c< / span > < span class = "special" > )< / span >
< span class = "special" > {< / span >
< span class = "keyword" > return< / span > < span class = "identifier" > a< / span > < span class = "special" > +< / span > < span class = "identifier" > b< / span > < span class = "special" > +< / span > < span class = "identifier" > c< / span > < span class = "special" > ;< / span >
< span class = "special" > }< / span >
< span class = "keyword" > void< / span > < span class = "identifier" > try_it< / span > < span class = "special" > ()< / span >
< span class = "special" > {< / span >
< span class = "identifier" > assert< / span > < span class = "special" > (< / span > < span class = "identifier" > bind_1st< / span > < span class = "special" > (& < / span > < span class = "identifier" > test_func< / span > < span class = "special" > ,< / span > < span class = "number" > 3< / span > < span class = "special" > )(-< / span > < span class = "number" > 2< / span > < span class = "special" > ,-< / span > < span class = "number" > 1< / span > < span class = "special" > )< / span > < span class = "special" > ==< / span > < span class = "number" > 0< / span > < span class = "special" > );< / span >
< span class = "identifier" > assert< / span > < span class = "special" > (< / span > < span class = "identifier" > bind_1st< / span > < span class = "special" > (< / span > < a href = "http://www.sgi.com/tech/stl/plus.html" target = "_top" > < code class = "computeroutput" > < span class = "identifier" > std< / span > < span class = "special" > ::< / span > < span class = "identifier" > plus< / span > < / code > < / a > < span class = "special" > < < / span > < span class = "keyword" > float< / span > < span class = "special" > > (),< / span > < span class = "number" > 1< / span > < span class = "special" > )(< / span > < span class = "number" > 0.5f< / span > < span class = "special" > )< / span > < span class = "special" > ==< / span > < span class = "number" > 1.5f< / span > < span class = "special" > );< / span >
< span class = "special" > }< / span >
< / pre >
< a name = "fusion.functional.adapters.unfused_generic.see_also" > < / a > < h5 >
2007-02-25 22:02:27 +00:00
< a name = "id1215428" > < / a >
2007-02-15 23:11:24 +00:00
< a href = "unfused_generic.html#fusion.functional.adapters.unfused_generic.see_also" > See
also< / a >
< / h5 >
< div class = "itemizedlist" > < ul type = "disc" >
< li > < a href = "unfused_lvalue_args.html" title = "unfused_lvalue_args" > < code class = "computeroutput" > < span class = "identifier" > unfused_lvalue_args< / span > < / code > < / a > < / li >
< li > < a href = "unfused_rvalue_args.html" title = "unfused_rvalue_args" > < code class = "computeroutput" > < span class = "identifier" > unfused_rvalue_args< / span > < / code > < / a > < / li >
< li > < a href = "unfused_typed.html" title = "unfused_typed" > < code class = "computeroutput" > < span class = "identifier" > unfused_typed< / span > < / code > < / a > < / li >
< li > < a href = "../../support/deduce.html" title = "deduce" > < code class = "computeroutput" > < span class = "identifier" > deduce< / span > < / code > < / a > < / li >
< li > < a href = "../../support/deduce_sequence.html" title = "deduce_sequence" > < code class = "computeroutput" > < span class = "identifier" > deduce_sequence< / span > < / code > < / a > < / li >
< / ul > < / div >
< / div >
< table xmlns:rev = "http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width = "100%" > < tr >
< td align = "left" > < / td >
2007-02-25 22:02:27 +00:00
< td align = "right" > < small > Copyright <20> 2001-2007 Joel de Guzman, Dan Marsden, Tobias
Schwinger< / small > < / td >
2007-02-15 23:11:24 +00:00
< / tr > < / table >
< hr >
< div class = "spirit-nav" >
< a accesskey = "p" href = "fused_function_object.html" > < img src = "../../../images/prev.png" alt = "Prev" > < / a > < a accesskey = "u" href = "../adapters.html" > < img src = "../../../images/up.png" alt = "Up" > < / a > < a accesskey = "h" href = "../../../index.html" > < img src = "../../../images/home.png" alt = "Home" > < / a > < a accesskey = "n" href = "unfused_lvalue_args.html" > < img src = "../../../images/next.png" alt = "Next" > < / a >
< / div >
< / body >
< / html >
