# List comprehension

A list comprehension is a syntactic construct available in some programming languages for creating a list based on existing lists. It follows the form of the mathematical set-builder notation (set comprehension) as distinct from the use of map and filter functions.

## Overview

Consider the following example in set builder notation.

$S=\{\,2\cdot x\mid x \in \mathbb{N},\ x^2>3\,\}$

This can be read, "S is the set of all numbers "2 times x" where x is an item in the set of natural numbers ($\mathbb{N}$), for which x squared is greater than 3."

In this annotated version of the example:

$S=\{\,\underbrace{2\cdot x}_{\color{Violet}\text{output function}}\mid \underbrace{x}_{\color{Violet}\text{variable}} \in \underbrace{\mathbb{N}}_{\color{Violet}\text{input set}},\ \underbrace{x^2>3}_{\color{Violet}\text{predicate}}\,\}$
• x is the variable representing members of an input set.
• $\mathbb{N}$ represents the input set, which in this example is the set of natural numbers
• x2 > 3 is a predicate function acting as a filter on members of the input set.
• $2\cdot x$ is an output function producing members of the new set from members of the input set that satisfy the predicate function.
• {} brackets contain the expression
• $\mid$ , the vertical bar and the comma are separators.

A list comprehension has the same syntactic components to represent generation of a list in order from an input list or iterator:

• A variable representing members of an input list.
• An input list (or iterator).
• An optional predicate expression.
• And an output expression producing members of the output list from members of the input iterable that satisfy the predicate.

The order of generation of members of the output list is based on the order of items in the input.

In Haskell's list comprehension syntax, this set-builder construct would be written similarly, as:

s = [ 2*x | x <- [0..], x^2 > 3 ]


Here, the list [0..] represents $\mathbb{N}$, x^2>3 represents the predicate, and 2*x represents the output expression.

List comprehensions give results in a defined order (unlike the members of sets); and list comprehensions may generate the members of a list in order, rather than produce the entirety of the list thus allowing, for example, the previous Haskell definition of the members of an infinite list.

## History

The SETL programming language (later 1960s) had a set formation construct, and the computer algebra system AXIOM (1973) has a similar construct that processes streams, but the first use of the term "comprehension" for such constructs was in Rod Burstall and John Darlington's description of their functional programming language NPL from 1977.

Smalltalk block context messages which constitute list comprehensions have been in that language since at least Smalltalk-80.

Burstall and Darlington's work with NPL influenced many functional programming languages during the 1980s but not all included list comprehensions. An exception was the influential pure lazy functional programming language Miranda which was released in 1985. The subsequently developed standard pure lazy functional language, Haskell, includes many of Miranda's features including list comprehensions. The Python programming language was heavily influenced by the pure lazy school of functional programming and adopted list comprehensions. Pure functional programming remains a niche while Python achieved wider adoption which introduced list comprehensions to a wider audience.

Comprehensions were proposed as a query notation for databases[1] and were implemented in the Kleisli database query language.[2]

## Examples in different programming languages

The following provides a few examples of specific syntax used in programming languages.

Although the original example denotes an infinite list, few languages can express that, so in some of those cases we show how to take a subset of {0,1,...,100} rather than a subset of $\mathbb{N}$.

### B-Prolog

L @= [Y : X in 1..100, [Y], (X*X>3, Y is 2*X)]


A list of the form [T : E1 in D1, ..., En in Dn, LocalVars, Goal] is interpreted as a list comprehension in calls to @=/2 and constraints. A list comprehension is translated into a foreach construct with an accumulator.

### Clojure

Clojure generates infinite lazy sequences (similar to Haskell's lazy lists or Python's generators). Use take to get the first N results from the infinite sequence.

(take 20 (for [x (iterate inc 0) :when (> (* x x) 3)] (* 2 x)))


### Common Lisp

List comprehensions can be expressed with the loop macro's collect keyword. Conditionals are expressed with if, as follows:

(loop for x from 0 to 100 if (> (* x x) 3) collect (* 2 x))


An infinite lazy sequence can be created in a variety of ways, such as the CLOS object system or a yield macro.

### Erlang

The same example in Erlang:

 S = [2*X || X <- lists:seq(0,100), X*X > 3].


### F#

The F# generator comprehension has the list comprehension syntax elements. Generator comprehensions can be used to generate Lists, Sequences (lazy lists) and Arrays (not discussed here).

Generators are of the form [for x in collection do ... yield expr] for lists and seq {for x in collection do ... yield expr} for sequences. For example:

> seq { for x in 0..100 do
if x*x > 3 then yield 2*x } ;;
val it : seq<int> = seq [4; 6; 8; 10; ...]


### Falcon

The "comp" generic method family provides wide support for comprehension. For example, the "mfcomp" method can be applied to an array:

 s = [].mfcomp( { i => if i*i > 3: return 2*i; return oob(1)}, [1:101] )


Falcon can also use functional generators to provide input lists. For example, the following code uses a continuation to create a set of pairs.

 gen = Continuation( function( max, c )
i = 0
while i < max: c(++i)
return oob(0)
end )
data = [10,11,12]
s = Set().mfcomp( {x, y => x+y}, .[gen 3], data )


Method "comp" was introduced in version 0.9.6, and methods "mcomp" and "mfcomp" in version 0.9.6.2.

Please refer to the main example in the overview.

s = [ 2*x | x <- [0..], x^2 > 3 ]


Here, the list [0..] generates natural numbers one by one which get bound to variable x, x^2>3 represents the predicate that either accepts or rejects a given variable's value, and 2*x represents the result expression. There might be several generators and test predicates in one list compehension expression in Haskell, in effect defining nested loops, e.g.:

s = [ 2*x*y | x <- [0..], x^2 > 3, y <- [1,3..x], y^2 < 100-x^2]
--   for each x from 0 by 1:
--     if x^2 > 3:
--       for each y from 1 by 2 upto x:
--         if y^2 < 100 - x^2:
--           produce 2*x*y


The above expression becomes unproductive ("stuck") at some point, when new xs keep being generated only to be rejected later on. This is so because any test can only reject a value it is given, not any future ones (there is no cut mechanism here, in Prolog terms - a generator in general might produce its values unordered, like e.g. the above expression itself). This can be delt with using bounded list generators always or by enclosing a generator inside a take or takeWhile call, limiting the amount of generated values.

### JavaFX

Using the for statement and a boolean expression:

  var s = for (i in [1..100][n | n*n > 3]) { 2*i }


### JavaScript 1.8

Number.prototype.__iterator__=function(){for (var i=0; i<this; i++) yield i}
var s = [2*i for (i in 101) if (i*i>3)]


Or, without prototyping the Number object,

var range = function(start,end){for (var i=start; i<=end; i++) yield i}
var s = [2*i for (i in range(0,100)) if (i*i>3)]


### OCaml

OCaml Batteries Included has uniform comprehension syntax for lists, arrays, enumerations (like streams), lazy lists (like lists but evaluated on-demand), sets, hashtables, etc.

Comprehension are of the form [? expression | x <- enumeration ; condition; condition ; ... ?].

For instance,

#   [? 2 * x | x <- 0 -- max_int ; x * x > 3 ?];;
- : int Enum.t = <abstr>


or, to compute a list,

#   [? List: 2 * x | x <- 0 -- 5 ; x * x > 3 ?];;
- : int list = [4; 6; 8; 10]


or, to compute a set,

#   [? PSet: 2 * x | x <- 0 -- 5 ; x * x > 3 ?];;
- : int PSet.t = <abstr>


etc.

### Octave

GNU Octave can do list (vector) comprehensions in the form (vector expression)(vector condition).

For example,

octave:1> x=0:100; s=(2*x)(x.**2<3)
s =
0 2


### Pure

The same example in Pure:

s = [2*n | n=1..100; n*n > 3];


### Python

The Python programming language has a corresponding syntax for expressing list comprehensions. The near-equivalent in Python to the example above is as follows:

S = [2*x for x in range(101) if x**2 > 3]


List comprehensions were introduced in Python version 2.0.[3]

A generator expression may be used in Python versions 2.4 and above to achieve functional equivalence with S using a generator to iterate a (finite or infinite) sequence:

from itertools import count
S = (2*x for x in count() if x**2 > 3)


### Racket

Racket provides functional versions of for-loops, which are essentially list comprehension syntax:

(for/list ([x (in-range 100)] #:when (> (* x x) 3))
(* 2 x))


The imperative for can also be used, combined with Racket's generator library to produce an infinite generator:

(require racket/generator)
(generator ()
(for ([x (in-naturals)] #:when (> (* x x) 3))
(yield (* 2 x))))


### Scala

Using the for-comprehension:

val s = for (x <- Stream.from(0); if x*x > 3) yield 2*x


### Scheme

Although there is no standard list comprehension syntax in R5RS, many implementations provide an extension for this. For example, in Chicken Scheme:

(require-extension list-of)
(list-of (* 2 x) (x range 0 101) (> (* x x) 3))


### Smalltalk

((1 to: 100) select: [:x|x*x>3]) collect: [:x|2*x]


### Visual Prolog

S = [ 2*X || X = std::fromTo(1, 100), X^2 > 3 ]


0..100 | Where {$_ *$_ -gt 3} | ForEach {$_ * 2}  ## Similar constructs ### Monad comprehension In Haskell, a monad comprehension is a generalization of the list comprehension to other monads in functional programming. ### Set comprehension Version 3.x and 2.7 of the Python language introduces syntax for set comprehensions. Similar in form to list comprehensions, set comprehensions generate Python sets instead of lists. >>> s = {v for v in 'ABCDABCD' if v not in 'CB'} >>> print(s) {'A', 'D'} >>> type(s) <class 'set'> >>>  ### Dict comprehension Version 3.x and 2.7 of the Python language introduced a new syntax for dictionary comprehensions, similar in form to list comprehensions but which generate Python dicts instead of lists. >>> s = {key: val for key, val in enumerate('ABCD') if val not in 'CB'} >>> s {0: 'A', 3: 'D'} >>>  ### Parallel list comprehension The Glasgow Haskell Compiler has an extension called parallel list comprehension (also known as zip-comprehension) that permits multiple independent branches of qualifiers within the list comprehension syntax. Whereas qualifiers separated by commas are dependent ("nested"), qualifier branches separated by pipes are evaluated in parallel (this does not refer to any form of multithreadedness: it merely means that the branches are zipped). -- regular list comprehension a = [(x,y) | x <- [1..5], y <-[3..5]] -- [(1,3),(1,4),(1,5),(2,3),(2,4) ... -- zipped list comprehension b = [(x,y) | (x,y) <- zip [1..5] [3..5]] -- [(1,3),(2,4),(3,5)] -- parallel list comprehension c = [(x,y) | x <- [1..5] | y <- [3..5]] -- [(1,3),(2,4),(3,5)]  ### XQuery and XPath Like the original NPL use, these are fundamentally database access languages. This makes the comprehension concept more important, because it is computationally infeasible to retrieve the entire list and operate on it (the initial 'entire list' may be an entire XML database). In XPath, the expression: /library/book//paragraph[@style='first-in-chapter']  is conceptually evaluated as a series of "steps" where each step produces a list and the next step applies a filter function to each element in the previous step's output.[4] In XQuery, full XPath is available, but FLWOR statements are also used, which is a more powerful comprehension construct.[5] for$b in //book
where $b[@pages < 400] order by$b//title
return
<shortBook>
<title>{$b//title}</title> <firstPara>{($book//paragraph)[1]}</firstPara>
</shortBook>


Here the XPath //book is evaluated to create a sequence (aka list); the where clause is a functional "filter", the order by sorts the result, and the <shortBook>...</shortBook> XML snippet is actually an anonymous function that builds/transforms XML for each element in the sequence using the 'map' approach found in other functional languages.

So, in another functional language the above FLWOR statement may be implemented like this:

map(
newXML(shortBook, newXML(title, $1.title), newXML(firstPara,$1...))
filter(
lt(\$1.pages, 400),
xpath(//book)
)
)


### LINQ in C#

C# 3.0 has a group of related features called LINQ, which defines a set of query operators for manipulating list-like structures (object enumerations, SQL datasets, …). On top of these operators it offers a comprehension syntax, reminiscent of SQL:

var s = from x in Enumerable.Range(0, 100) where x*x > 3 select x*2;


### C++

List comprehensions can be constructed using the C++ STL algorithms remove_copy_if to select elements in a list and for_each to transform them.

#include <algorithm>
#include <list>

int linspace() { static int i=1; return i++; }
bool sqrle3(int x) { return x*x <= 3; }
void into2(int &x) { x*=2; }

int main()
{
list<int> N1(10), N2(10);
// N1 and N2 are both empty lists of 10 elements each
generate_n(N1.begin(), 10, linspace);
// N1 now contains 1,2,...,10
for_each(N2.begin(),
remove_copy_if(N1.begin(), N1.end(), N2.begin(), sqrle3),
into2);
// N2 now contains 4,6,...,20
}


There is some effort in providing C++ with list-comprehension constructs/syntax similar to the set builder notation.

• In Boost.Range[1] library there is a notion of adaptors[2] that can be applied by to any range and do filtering, transformation etc. With this library, the original Haskell example would look like (using Boost.Lambda[3] for anonymous filtering and transforming functions):
counting_range(1,10) | filtered( _1*_1 > 3 ) | transformed(ret<int>( _1*2 ))


Full example is here: http://codepad.org/y4bpgLJu

• This [6] implementation uses a macro and overloads the << operator. It evaluates any expression valid inside an 'if', and any variable name may be chosen. It's not threadsafe, however. Usage example:
list<int> N;
list<double> S;

for (int i = 0; i < 10; i++)
N.push_back(i);

S << list_comprehension(3.1415 * x, x, N, x*x > 3)

• This [7] implementation provides head/tail slicing using classes and operator overloading, and the | operator for filtering lists (using functions). Usage example:
bool even(int x) { return x % 2 == 0; }
bool x2(int &x) { x *= 2; return true; }

list<int> l, t;
int x, y;

for (int i = 0; i < 10; i++)
l.push_back(i);

(x, t) = l | x2;
(t, y) = t;

t = l < 9;
t = t < 7 | even | x2;


• The SELECT statement together with its FROM and WHERE clauses in SQL
• Programming language
• Mathematical notation
• Monads in functional programming for monads and monadic notation in general
• For other programming language constructs used to process sequences:
• For other programming language constructs copied from the mathematical notation:

## Notes and references

### Axiom

Wikimedia Foundation. 2010.

### Look at other dictionaries:

• Comparison of programming languages (list comprehension) — Programming language comparisons General comparison Basic syntax Basic instructions Arrays Associative arrays String operations …   Wikipedia

• Comprehension de liste — Compréhension de liste Une liste, comme un ensemble, peut être définie par la donnée d une propriété caractéristique de ses éléments, on dit qu on l a définie en compréhension. Comme cette construction offre des avantages de lisibilité et de… …   Wikipédia en Français

• Comprehension — has the following meanings: In general usage, and more specifically in reference to education and psychology, it has roughly the same meaning as understanding. Reading comprehension measures the understanding of a passage of text Comprehension… …   Wikipedia

• List of first-order theories — In mathematical logic, a first order theory is given by a set of axioms in somelanguage. This entry lists some of the more common examples used in model theory and some of their properties. PreliminariesFor every natural mathematical structure… …   Wikipedia

• List of Pokémon episodes — This is a list of episodes of the Pokémon animated series (ポケットモンスター, Poketto Monsutā?, Pocket Monsters). The division between seasons of Pokémon is based on the openings of each episode, and may not reflect the actual production season. The… …   Wikipedia

• List of philosophy topics (I-Q) — II and thou I Ching I Ching I proposition I Thou I Thou relationshipIaIamblichus (philosopher)IbYahya Ibn Adi Yahya Ibn Adi Ibn al Arabi Muhyi al Din Ibn al Arabi Abu Bakr Ibn Bajja Abu Bakr Ibn Bājja Abu Bakr Muhammad Ibn Yahya Ibn as Say igh… …   Wikipedia

• List of philosophy topics (A-C) — 110th century philosophy 11th century philosophy 12th century philosophy 13th century philosophy 14th century philosophy 15th century philosophy 16th century philosophy 17th century philosophy 18th century philosophy 19th century philosophy220th… …   Wikipedia

• List of Ig Nobel Prize winners — This is a list of Ig Nobel Prize winners from 1991 to the present day. A parody of the Nobel Prizes, the Ig Nobel Prizes are given each year in early October around the time the recipients of the genuine Nobel Prizes are announced for ten… …   Wikipedia

• List of education topics — This is a list of education topics. See also: Education, , and the List of basic education topics.: External link: [http://tools.wikimedia.de/ daniel/WikiSense/CategoryTree.php? wikilang=en wikifam=.wikipedia.org m=a art=on userlang=en… …   Wikipedia

• List of confidence tricks — This list of confidence tricks and scams should not be considered complete, but covers the most common examples. Confidence tricks and scams are difficult to classify, because they change often and often contain elements of more than one type.… …   Wikipedia