# Function composition (computer science)

In computer science, function composition is an act or mechanism to combine simple functions to build more complicated ones. Like the usual composition of functions in mathematics, the result of each function is passed as the argument of the next, and the result of the last one is the result of the whole.

Programmers frequently apply functions to results of other functions, and almost all programming languages allow it. In some cases, the composition of functions is interesting as a function in its own right, to be used later. Such a function can always be defined but languages with first-class functions make it easier.

The ability to easily compose functions encourages factoring (breaking apart) functions for maintainability and code reuse. More generally, big systems might be built by composing whole programs.

Narrowly speaking, function composition applies to functions that operate on a finite amount of data, each step sequentially processing it before handing it to the next. Functions that operate on potentially infinite data (a stream or other codata) are known as filters, and are instead connected in a pipeline, which is analogous to function composition and can execute concurrently.

## Composing function calls

For example, suppose we have two functions $f$ and $g$ , as in $z=f(y)$ and $y=g(x)$ . Composing them means we first compute $y=g(x)$ , and then use $y$ to compute $z=f(y)$ . Here is the example in the C language:

```float x, y, z;
// ...
y = g(x);
z = f(y);
```

The steps can be combined if we don't give a name to the intermediate result:

```z = f(g(x));
```

Despite differences in length, these two implementations compute the same result. The second implementation requires only one line of code and is colloquially referred to as a "highly composed" form. Readability and hence maintainability is one advantage of highly composed forms, since they require fewer lines of code, minimizing a program's "surface area". DeMarco and Lister empirically verify an inverse relationship between surface area and maintainability. On the other hand, it may be possible to overuse highly composed forms. A nesting of too many functions may have the opposite effect, making the code less maintainable.

In a stack-based language, functional composition is even more natural: it is performed by concatenation, and is usually the primary method of program design. The above example in Forth:

```g f
```

Which will take whatever was on the stack before, apply g, then f, and leave the result on the stack. See postfix composition notation for the corresponding mathematical notation.

## Naming the composition of functions

Now suppose that the combination of calling f() on the result of g() is frequently useful, and which we want to name foo() to be used as a function in its own right.

In most languages, we can define a new function implemented by composition. Example in C:

```float foo(float x) {
return f(g(x));
}
```

(the long form with intermediates would work as well.) Example in Forth:

```  : foo g f ;
```

In languages such as C, the only way to create a new function is to define it in the program source, which means that functions can't be composed at run time. An evaluation of an arbitrary composition of predefined functions, however, is possible:

```#include <stdio.h>

typedef int FXN(int);

int f(int x) { return x+1; }
int g(int x) { return x*2; }
int h(int x) { return x-3; }

int eval(FXN *fs[], int size, int x)
{
for (int i=0; i<size; i++) x = (*fs[i])(x);

return x;
}

int main()
{
// ((6+1)*2)-3 = 11
FXN *arr[] = {f,g,h};
printf("%d\n", eval(arr, 3, 6));

// ((6-3)*2)+1 = 7
arr = f;  arr = h;
printf("%d\n", eval(arr, 3, 6));
}
```

## First-class composition

In functional programming languages, function composition can be naturally expressed as a higher-order function or operator. In other programming languages you can write your own mechanisms to perform function composition.

In Haskell, the example given above becomes:

```foo = f . g
```

using the built-in composition operator (.), which can be read as f after g or g composed with f.

The composition operator itself can be defined in Haskell using a lambda expression:

```(.) :: (b -> c) -> (a -> b) -> a -> c
f . g = \x -> f (g x)
```

The first lines describes the type of (.) - it takes a pair of functions and returns a function. Note that Haskell doesn't require specification of the exact input and output types of f and g, only the relations between them (f must accept what g returns). This makes (.) a polymorphic operator.

### Lisp

Variants of Lisp, especially Scheme, the interchangeability of code and data together with the treatment of functions lend themselves extremely well for a recursive definition of a variadic compositional operator.

```(define (compose . fs)
(if (null? fs) (lambda (x) x) ; if no argument is given, evaluates to the identity function
(lambda (x) ((car fs) ((apply compose (cdr fs)) x)))))

; examples
(string-append str "!"))

(define givebang
(compose string->symbol add-a-bang symbol->string))

(givebang 'set) ; ===> set!

; anonymous composition
((compose sqrt negate square) 5) ; ===> 0+5i
```

### APL

Many dialects of APL feature built in function composition using the symbol `∘`. This higher-order function extends function composition to dyadic application of the left side function such that `A f∘g B` is `A f g B`.

```foo←f∘g
```

Additionally, you can define function composition:

```o←{⍺⍺ ⍵⍵ ⍵}
```

In dialect that does not support inline definition using braces, the traditional definition is available:

```∇ r←(f o g)x
r←f g x
∇
```

### Perl

Perl 6 like Haskell has a built in function composition operator, the main difference is it is spelled as `∘` or `o`.

```my &foo = &f ∘ &g;
```

Also like Haskell you could define the operator yourself. In fact the following is the Perl 6 code used to define it in the Rakudo implementation.

```# the implementation has a slightly different line here because it cheats
proto sub infix:<∘> (&?, &?) is equiv(&[~]) is assoc<left> {*}

multi sub infix:<∘> () { *.self } # allows `[∘] @array` to work when `@array` is empty
multi sub infix:<∘> (&f) { &f }   # allows `[∘] @array` to work when `@array` has one element
multi sub infix:<∘> (&f, &g --> Block) {
(&f).count > 1
?? -> |args { f |g |args }
!! -> |args { f g |args }
}

# alias it to the "Texas" spelling ( everything is bigger, and ASCII in Texas )
my &infix:<o> := &infix:<∘>;
```

### Python

In Python, a way to define the composition for any group of functions, is using reduce function (use functools.reduce in Python 3):

```# available since v2.6
from functools import reduce

def compose(*funcs):
""" Compose a group of functions (f(g(h(...)))) into a single composite func. """
return reduce(lambda f, g: lambda x: f(g(x)), funcs)

# Example
f = lambda x: x+1
g = lambda x: x*2
h = lambda x: x-3

# Call the function x=10 : ((x-3)*2)+1 = 15
print(compose(f, g, h)(10))
```

### JavaScript

In JavaScript we can define it as a function which takes two functions f and g, and produces a function:

```function o(f, g) {
return function(x) {
return f(g(x));
}
}

// Alternatively, using the spread operator and lambda expressions in ES2015
const compose = (...fs) => (x) => fs.reduceRight((acc, f) => f(acc), x)
```

### C#

In C# we can define it as a Func which takes two Funcs f and g, and produces a Func:

```// Call example:
//   var c = Compose(f, g);
//
//   Func<int, bool> g = _ =>  ...
//   Func<bool, string> f = _ => ...

Func<TIn, TOut> Compose<TIn, TMid, TOut>(Func<TMid, TOut> f, Func<TIn, TMid> g) => _ => f(g(_));
```

### Ruby

Languages like Ruby let you construct a binary operator yourself:

```class Proc
def compose(other_fn)
->(*as) { other_fn.call(call(*as)) }
end
alias_method :+, :compose
end

f = ->(x) { x * 2 }
g = ->(x) { x ** 3 }
(f + g).call(12) # => 13824
```

However, a native function composition operator was introduced in Ruby 2.6:

```f = proc{|x| x + 2}
g = proc{|x| x * 3}
(f << g).call(3) # -> 11; identical to f(g(3))
(f >> g).call(3) # -> 15; identical to g(f(3))
```

## Research survey

Notions of composition, including the principle of compositionality and composability, are so ubiquitous that numerous strands of research have separately evolved. The following is a sampling of the kind of research in which the notion of composition is central.

## Large-scale composition

Whole programs or systems can be treated as functions, which can be readily composed if their inputs and outputs are well-defined pipelines allowing easy composition of filters were so successful that it became a design pattern of operating systems.

Imperative procedures with side effects violate referential transparency and therefore are not cleanly composable. However if you consider the "state of the world" before and after running the code as its input and output, you get a clean function. Composition of such functions corresponds to running the procedures one after the other. The monads formalism uses this idea to incorporate side effects and I/O into functional languages.