# 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:
The steps can be combined if we don't give a name to the intermediate result:
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:
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:
(the long form with intermediates would work as well.) Example in Forth:
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:

## 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.

### Haskell

In Haskell, the example foo = f  ∘  g given above becomes:
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:
The first line describes the type of (.) - it takes a pair of functions, f,  g and returns a function (the lambda expression on the second line). Note that Haskell doesn't require specification of the exact input and output types of f and g; the a, b, c, and x are placeholders; only the relation between f,  g matters (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.

### 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.
Additionally, you can define function composition:
In dialect that does not support inline definition using braces, the traditional definition is available:

### Raku

Raku like Haskell has a built in function composition operator, the main difference is it is spelled as ∘ or o.
Also like Haskell you could define the operator yourself. In fact the following is the Raku code used to define it in the Rakudo implementation.

### Nim

Nim supports uniform function call syntax, which allows for arbitrary function composition through the method syntax . operator.

### Python

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

### JavaScript

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

### C#

In C# we can define it as an Extension method which takes Funcs f and g, and produces a new Func:

### Ruby

Languages like Ruby let you construct a binary operator yourself:
However, a native function composition operator was introduced in Ruby 2.6:

## 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.
* Steele (1994) directly applied function composition to the assemblage of building blocks known as 'monads' in the Haskell programming language.
* Meyer (1988) addressed the software reuse problem in terms of composability.
* Abadi & Lamport (1993) formally defined a proof rule for functional composition that assures a program's safety and liveness.
* Kracht (2001) identified a strengthened form of compositionality by placing it into a semiotic system and applying it to the problem of structural ambiguity frequently encountered in computational linguistics.
* van Gelder & Port (1993) examined the role of compositionality in analog aspects of natural language processing.
* According to a review by Gibbons (2002), formal treatment of composition underlies validation of component assembly in visual programming languages like IBM's Visual Age for the Java language.

## 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 they became a design pattern of operating systems.
Imperative procedures with side effects violate referential transparency and therefore are not cleanly composable. However if one considers the "state of the world" before and after running the code as its input and output, one gets a clean function. Composition of such functions corresponds to running the procedures one after the other. The monad formalism uses this idea to incorporate side effects and input/output (I/O) into functional languages.