Partial application

<h2 id="motivation">Motivation</h2>
Intuitively, partial function application says "if you fix the first <a href="/facts/Parameter_(computer_science)/LcuLbbSq">arguments</a> of the function, you get a function of the remaining arguments". For example, if function div(x,y) = x/y, then div with the parameter x fixed at 1 is another function: div1(y) = div(1,y) = 1/y. This is the same as the function inv that returns the multiplicative inverse of its argument, defined by inv(y) = 1/y.
The practical motivation for partial application is that very often the functions obtained by supplying some but not all of the arguments to a function are useful; for example, many languages have a function or operator similar to plus_one. Partial application makes it easy to define these functions, for example by creating a function that represents the addition operator with 1 bound as its first argument.

<h2 id="implementations">Implementations</h2>
In languages such as <a href="/facts/ML_(programming_language)/RfwxASRF">ML</a>, <a href="/facts/Haskell_(programming_language)/4Htv9WLu">Haskell</a> and <a href="/facts/F_Sharp_(programming_language)/jdXHnYz5">F#</a>, functions are defined in <a href="/facts/Currying/AmD3PP5B">curried</a> form by default. Supplying fewer than the total number of arguments is referred to as partial application.
In languages with <a href="/facts/First-class_functions/dtMzp81k">first-class functions</a>, one can define curry, uncurry and papply to perform currying and partial application explicitly. This might incur a greater run-time overhead due to the creation of additional <a href="/facts/Closure_(computer_science)/droP22Xn">closures</a>, while Haskell can use more efficient techniques.<a class="footnote-ref" id="fnref:1" href="#fn:1">1</a>
<a href="/facts/Scala_(programming_language)/ebL8o6AK">Scala</a> implements optional partial application with placeholder, e.g. def add(x: Int, y: Int) = {x+y}; add(1, _: Int) returns an incrementing function. Scala also supports multiple parameter lists as currying, e.g. def add(x: Int)(y: Int) = {x+y}; add(1) _.
<a href="/facts/Clojure/3JRNxKXx">Clojure</a> implements partial application using the partial function defined in its core library.<a class="footnote-ref" id="fnref:2" href="#fn:2">2</a>
The <a href="/facts/C%252B%252B/Et0F2qn9">C++</a> standard library provides bind(function, args..) to return a <a href="/facts/Function_object/zC9SWfeu">function object</a> that is the result of partial application of the given arguments to the given function. Since <a href="/facts/C%252B%252B20/hwpB1Vzp">C++20</a> the function bind_front(function, args...) is also provided which binds the first sizeof...(args) arguments of the function to the args. In contrast, bind allows binding any of the arguments of the function passed to it, not just the first ones. Alternatively, <a href="/facts/Anonymous_function/2vdyE4zL">lambda expressions</a> can be used:

int f(int a, int b);
auto f_partial = [](int a) { return f(a, 123); };
assert(f_partial(456) == f(456, 123) );

In <a href="/facts/Java_(programming_language)/9ScgFyAL">Java</a>, MethodHandle.bindTo partially applies a function to its first argument.<a class="footnote-ref" id="fnref:3" href="#fn:3">3</a>
Alternatively, since Java 8, lambdas can be used:

public static <A, B, R> Function<B, R> partialApply(BiFunction<A, B, R> biFunc, A value) {
 return b -> biFunc.apply(value, b);
}

In <a href="/facts/Raku_(programming_language)/9eYW7vRJ">Raku</a>, the <a href="https://docs.perl6.org/routine/assuming">assuming</a> method creates a new function with fewer parameters.<a class="footnote-ref" id="fnref:4" href="#fn:4">4</a>
The <a href="/facts/Python_(programming_language)/YbuGqofa">Python</a> standard library module functools includes the partial function, allowing positional and named argument bindings, returning a new function.<a class="footnote-ref" id="fnref:5" href="#fn:5">5</a>
In <a href="/facts/XQuery/47Ep0fSS">XQuery</a>, an argument placeholder (?) is used for each non-fixed argument in a partial function application.<a class="footnote-ref" id="fnref:6" href="#fn:6">6</a>

<h2 id="definitions">Definitions</h2>
In the <a href="/facts/Simply_typed_lambda_calculus/5RQlXLjy">simply typed lambda calculus</a> with <a href="/facts/Function_type/CmbusBzk">function</a> and <a href="/facts/Product_type/y6Qj08vW">product types</a> (λ→,×) partial application, currying and uncurrying can be defined as

papply
(((a × b) → c) × a) → (b → c) = λ(f, x). λy. f (x, y)
curry
((a × b) → c) → (a → (b → c)) = λf. λx. λy. f (x, y)
uncurry
(a → (b → c)) → ((a × b) → c) = λf. λ(x, y). f x y
Note that curry papply = curry.

<h2 id="mathematical-formulation-and-examples">Mathematical formulation and examples</h2>
Partial application can be a useful way to define several useful notions in mathematics. 
Given sets 
 
 
 
 X
 ,
 Y
 
 
 {\displaystyle X,Y}
 
 and 
 
 
 
 Z
 
 
 {\displaystyle Z}
 
, and a function 
 
 
 
 f
 :
 X
 ×
 Y
 →
 Z
 
 
 {\displaystyle f:X\times Y\rightarrow Z}
 
, one can define the function

f
        (
        
        ⋅
        
        ,
        −
        )
        :
        X
        →
        (
        Y
        →
        Z
        )
        ,
      
    
    {\displaystyle f(\,\cdot \,,-):X\rightarrow (Y\rightarrow Z),}

where 
 
 
 
 (
 Y
 →
 Z
 )
 
 
 {\displaystyle (Y\rightarrow Z)}
 
 is the set of functions 
 
 
 
 Y
 →
 Z
 
 
 {\displaystyle Y\rightarrow Z}
 
. The image of 
 
 
 
 x
 ∈
 X
 
 
 {\displaystyle x\in X}
 
 under this map is 
 
 
 
 f
 (
 x
 ,
 
 ⋅
 
 )
 :
 Y
 →
 Z
 
 
 {\displaystyle f(x,\,\cdot \,):Y\rightarrow Z}
 
. This is the function which sends 
 
 
 
 y
 ∈
 Y
 
 
 {\displaystyle y\in Y}
 
 to 
 
 
 
 f
 (
 x
 ,
 y
 )
 
 
 {\displaystyle f(x,y)}
 
. There are often structures on 
 
 
 
 X
 ,
 Y
 ,
 Z
 
 
 {\displaystyle X,Y,Z}
 
 which mean that the image of 
 
 
 
 f
 (
 
 ⋅
 
 ,
 −
 )
 
 
 {\displaystyle f(\,\cdot \,,-)}
 
 restricts to some subset of functions 
 
 
 
 Y
 →
 Z
 
 
 {\displaystyle Y\rightarrow Z}
 
, as illustrated in the following examples.

<h3>Group actions</h3>
A <a href="/facts/Group_action/Vh9VtUUw">group action</a> can be understood as a function 
 
 
 
 ∗
 :
 G
 ×
 X
 →
 X
 
 
 {\displaystyle *:G\times X\rightarrow X}
 
. The partial evaluation 
 
 
 
 ρ
 :
 G
 →
 
 Sym
 
 (
 X
 )
 ⊂
 (
 X
 →
 X
 )
 
 
 {\displaystyle \rho :G\rightarrow {\text{Sym}}(X)\subset (X\rightarrow X)}
 
 restricts to the group of bijections from 
 
 
 
 X
 
 
 {\displaystyle X}
 
 to itself. The group action axioms further ensure 
 
 
 
 ρ
 
 
 {\displaystyle \rho }
 
 is a <a href="/facts/Group_homomorphism/sDguaNYs">group homomorphism</a>.

<h3>Inner-products and canonical map to the dual</h3>
An <a href="/facts/Inner-product/HoyjElEy">inner-product</a> on a vector space 
 
 
 
 V
 
 
 {\displaystyle V}
 
 over a field 
 
 
 
 K
 
 
 {\displaystyle K}
 
 is a map 
 
 
 
 ϕ
 :
 V
 ×
 V
 →
 K
 
 
 {\displaystyle \phi :V\times V\rightarrow K}
 
. The partial evaluation provides a canonical map to the <a href="/facts/Dual_vector_space/4Uw4Knz1">dual vector space</a>, 
 
 
 
 ϕ
 (
 
 ⋅
 
 ,
 −
 )
 :
 V
 →
 
 V
 
 ∗
 
 
 ⊂
 (
 V
 →
 K
 )
 
 
 {\displaystyle \phi (\,\cdot \,,-):V\rightarrow V^{*}\subset (V\rightarrow K)}
 
. If this is the inner-product of a <a href="/facts/Hilbert_space/aDFMh4lV">Hilbert space</a>, the <a href="/facts/Riesz_representation_theorem/9CjKDUII">Riesz representation theorem</a> ensures this is an <a href="/facts/Isomorphism/pj8KgkxU">isomorphism</a>.

<h3>Cross-products and the adjoint map for Lie algebras</h3>
The partial application of the cross product 
 
 
 
 ×
 
 
 {\displaystyle \times }
 
 on 
 
 
 
 
 
 R
 
 
 3
 
 
 
 
 {\displaystyle \mathbb {R} ^{3}}
 
 is 
 
 
 
 ×
 (
 
 ⋅
 
 ,
 −
 )
 :
 
 
 R
 
 
 3
 
 
 ↦
 
 End
 
 (
 
 
 R
 
 
 3
 
 
 )
 
 
 {\displaystyle \times (\,\cdot \,,-):\mathbb {R} ^{3}\mapsto {\text{End}}(\mathbb {R} ^{3})}
 
. The image of the vector 
 
 
 
 
 u
 
 
 
 {\displaystyle \mathbf {u} }
 
 is a linear map 
 
 
 
 
 T
 
 
 u
 
 
 
 
 
 {\displaystyle T_{\mathbf {u} }}
 
 such that 
 
 
 
 
 T
 
 
 u
 
 
 
 (
 
 v
 
 )
 =
 
 u
 
 ×
 
 v
 
 
 
 {\displaystyle T_{\mathbf {u} }(\mathbf {v} )=\mathbf {u} \times \mathbf {v} }
 
. The components of 
 
 
 
 
 T
 
 
 u
 
 
 
 
 
 {\displaystyle T_{\mathbf {u} }}
 
 can be found to be 
 
 
 
 (
 
 T
 
 
 u
 
 
 
 
 )
 
 i
 j
 
 
 =
 
 ϵ
 
 i
 j
 k
 
 
 
 u
 
 k
 
 
 
 
 {\displaystyle (T_{\mathbf {u} })_{ij}=\epsilon _{ijk}u_{k}}
 
.
This is closely related to the <a href="/facts/Adjoint_map/bWG4c2su">adjoint map</a> for <a href="/facts/Lie_algebras/n2gAUkNq">Lie algebras</a>. Lie algebras are equipped with a bracket 
 
 
 
 [
 
 ⋅
 
 ,
 
 ⋅
 
 ]
 :
 
 
 g
 
 
 ×
 
 
 g
 
 
 →
 
 
 g
 
 
 
 
 {\displaystyle [\,\cdot \,,\,\cdot \,]:{\mathfrak {g}}\times {\mathfrak {g}}\rightarrow {\mathfrak {g}}}
 
. The partial application gives a map 
 
 
 
 
 ad
 
 :
 
 
 g
 
 
 →
 
 End
 
 (
 
 
 g
 
 
 )
 
 
 {\displaystyle {\text{ad}}:{\mathfrak {g}}\rightarrow {\text{End}}({\mathfrak {g}})}
 
. The axioms for the bracket ensure this map is a homomorphism of Lie algebras.

<h2 id="see-also">See also</h2>
<ul><li><a href="/facts/%25CE%2597-conversion/DaD3RuQ4">η-conversion</a></li>
<li><a href="/facts/POP-2/5hdL9dPY">POP-2</a></li>
<li><a href="/facts/Restriction_(mathematics)/JV59DhKy">Restriction (mathematics)</a>, the more general phenomenon of restricting a function to a subset of its domain</li></ul>

<h2 id="further-reading">Further reading</h2>
<ul><li><a href="/facts/Simon_Marlow/cB5L1czA">Marlow, Simon</a>; <a href="/facts/Simon_Peyton_Jones/SaVmBaaG">Peyton Jones, Simon</a> (2004), <a href="http://research.microsoft.com/en-us/um/people/simonpj/papers/eval-apply/eval-apply-icfp.ps">"Making a Fast Curry: Push/Enter vs. Eval/Apply for Higher-order Languages"</a>, ICFP '04 Proceedings of the ninth ACM SIGPLAN international conference on Functional programming</li>
<li><a href="/facts/Benjamin_C._Pierce/m9DKUgML">Benjamin C. Pierce</a> et al. <a href="https://www.cis.upenn.edu/~bcpierce/sf/current/Poly.html#lab126">"Partial Application"</a>, <a href="https://web.archive.org/web/20160521182324/http://www.cis.upenn.edu/~bcpierce/sf/current/Poly.html#lab126">Archived</a> 2016-05-21 at the <a href="/facts/Wayback_Machine/nmQ3a6JC">Wayback Machine</a> <a href="https://www.cis.upenn.edu/~bcpierce/sf/current/Poly.html#lab127">"Digression: Currying"</a>. <a href="https://web.archive.org/web/20160521182324/http://www.cis.upenn.edu/~bcpierce/sf/current/Poly.html#lab127">Archived</a> 2016-05-21 at the <a href="/facts/Wayback_Machine/nmQ3a6JC">Wayback Machine</a> Software Foundations.</li></ul>
<h2 id="external-links">External links</h2>
<ul><li><a href="http://rosettacode.org/wiki/Partial_function_application">Partial function application</a> on Rosetta code.</li>
<li><a href="http://www.haskell.org/haskellwiki/Partial_application">Partial application</a> at Haskell Wiki</li>
<li><a href="http://www.haskell.org/haskellwiki/Constant_applicative_form">Constant applicative form</a> at Haskell Wiki</li>
<li><a href="https://blogs.janestreet.com/the-dangers-of-being-too-partial/">The dangers of being too partial</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1">Marlow & Peyton Jones 2004 - Marlow, Simon; Peyton Jones, Simon (2004), "Making a Fast Curry: Push/Enter vs. Eval/Apply for Higher-order Languages", ICFP '04 Proceedings of the ninth ACM SIGPLAN international conference on Functional programming <a href="http://research.microsoft.com/en-us/um/people/simonpj/papers/eval-apply/eval-apply-icfp.ps" target="_blank">http://research.microsoft.com/en-us/um/people/simonpj/papers/eval-apply/eval-apply-icfp.ps</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></li>
<li id="fn:2">"clojure/clojure, partial function". GitHub. Retrieved 2020-07-18. <a href="https://github.com/clojure/clojure/blob/653b8465845a78ef7543e0a250078eea2d56b659/src/clj/clojure/core.clj#L2614" target="_blank">https://github.com/clojure/clojure/blob/653b8465845a78ef7543e0a250078eea2d56b659/src/clj/clojure/core.clj#L2614</a> <a href="#fnref:2" class="footnote-back-ref">↩</a></li>
<li id="fn:3">"MethodHandle (Java Platform SE 7)". docs.oracle.com. Retrieved 2018-09-12. <a href="https://docs.oracle.com/javase/7/docs/api/java/lang/invoke/MethodHandle.html#bindTo(java.lang.Object)" target="_blank">https://docs.oracle.com/javase/7/docs/api/java/lang/invoke/MethodHandle.html#bindTo(java.lang.Object)</a> <a href="#fnref:3" class="footnote-back-ref">↩</a></li>
<li id="fn:4">"Method assuming". docs.perl6.org. Retrieved 2018-09-12. <a href="https://docs.perl6.org/routine/assuming" target="_blank">https://docs.perl6.org/routine/assuming</a> <a href="#fnref:4" class="footnote-back-ref">↩</a></li>
<li id="fn:5">"10.2. functools — Higher-order functions and operations on callable objects — Python 3.7.0 documentation". docs.python.org. Retrieved 2018-09-12. <a href="https://docs.python.org/3/library/functools.html#functools.partial" target="_blank">https://docs.python.org/3/library/functools.html#functools.partial</a> <a href="#fnref:5" class="footnote-back-ref">↩</a></li>
<li id="fn:6">"XQuery 3.1: An XML Query Language". www.w3.org. Retrieved 2018-09-12. <a href="https://www.w3.org/TR/2017/REC-xquery-31-20170321/#dt-partial-function-application" target="_blank">https://www.w3.org/TR/2017/REC-xquery-31-20170321/#dt-partial-function-application</a> <a href="#fnref:6" class="footnote-back-ref">↩</a></li>
</ol>

Partial application open-in-new

Partial application