Draft — This is a work in progress, not an official release of the Haskell 2010 Revised Language Report.

3 Expressions

In this chapter, we describe the syntax and informal semantics of Haskell expressions, including their translations into the Haskell kernel, where appropriate. Except in the case of let expressions, these translations preserve both the static and dynamic semantics. Free variables and constructors used in these translations always refer to entities defined by the Prelude. For example, “concatMap” used in the translation of list comprehensions (Section 3.11) means the concatMap defined by the Prelude, regardless of whether or not the identifier “concatMap” is in scope where the list comprehension is used, and (if it is in scope) what it is bound to.

exp→infixexp::[context=>]type(expression type signature)
|infixexp
infixexp→lexpqopinfixexp
|-infixexp(prefix negation)
|lexp
lexp→\apat1…apat𝑛->exp(lambda abstraction, 𝑛≥1)
|letdeclsinexp(let expression)
|ifexp[;]thenexp[;]elseexp(conditional)
|caseexpof{alts}(case expression)
|do{stmts}(do expression)
|fexp
fexp→[fexp]aexp(function application)
aexp→qvar(variable)
|gcon(general constructor)
|literal
|(exp)(parenthesized expression)
|(exp1,…,exp𝑘)(tuple, 𝑘≥2)
|[exp1,…,exp𝑘](list, 𝑘≥1)
|[exp1[,exp2]..[exp3]](arithmetic sequence)
|[exp|qual1,…,qual𝑛](list comprehension, 𝑛≥1)
|(infixexpqop)(left section)
|(qop⟨-⟩infixexp)(right section)
|qcon{fbind1,…,fbind𝑛}(labeled construction, 𝑛≥0)
|aexp⟨qcon⟩{fbind1,…,fbind𝑛}(labeled update, 𝑛≥1)

Expressions involving infix operators are disambiguated by the operator’s fixity (see Section 4.4.2). Consecutive unparenthesized operators with the same precedence must both be either left or right associative to avoid a syntax error. Given an unparenthesized expression “𝑥qop(𝑎,𝑖)𝑦qop(𝑏,𝑗)𝑧” (where qop(𝑎,𝑖) means an operator with associativity 𝑎 and precedence 𝑖), parentheses must be added around either 𝑥qop(𝑎,𝑖)𝑦 or 𝑦qop(𝑏,𝑗)𝑧 when 𝑖=𝑗 unless 𝑎=𝑏=l or 𝑎=𝑏=r.

An example algorithm for resolving expressions involving infix operators is given in Section 10.6.

Negation is the only prefix operator in Haskell; it has the same precedence as the infix - operator defined in the Prelude (see Section 4.4.2, Figure 1).

The grammar is ambiguous regarding the extent of lambda abstractions, let expressions, and conditionals. The ambiguity is resolved by the meta-rule that each of these constructs extends as far to the right as possible.

Sample parses are shown below.

ThisParses as
f x + g y(f x) + (g y)
- f x + y(- (f x)) + y
let {...} in x + ylet {...} in (x + y)
z + let {...} in x + yz + (let {...} in (x + y))
f x y :: Int(f x y) :: Int
\ x -> a+b :: Int\x -> ((a+b) :: Int)

For the sake of clarity, the rest of this section will assume that expressions involving infix operators have been resolved according to the fixities of the operators.

3.1 Errors

Errors during expression evaluation, denoted by ⊥ (“bottom”), are indistinguishable by a Haskell program from non-termination. Since Haskell is a non-strict language, all Haskell types include ⊥. That is, a value of any type may be bound to a computation that, when demanded, results in an error. When evaluated, errors cause immediate program termination and cannot be caught by the user. The Prelude provides two functions to directly cause such errors:

error     :: String -> a
undefined :: a

A call to error terminates execution of the program and returns an appropriate error indication to the operating system. It should also display the string in some system-dependent manner. When undefined is used, the error message is created by the compiler.

Translations of Haskell expressions use error and undefined to explicitly indicate where execution time errors may occur. The actual program behavior when an error occurs is up to the implementation. The messages passed to the error function in these translations are only suggestions; implementations may choose to display more or less information when an error occurs.

3.2 Variables, Constructors, Operators, and Literals

aexp→qvar(variable)
|gcon(general constructor)
|literal
gcon→()
|[]
|(,{,})
|qcon
var→varid|(varsym)(variable)
qvar→qvarid|(qvarsym)(qualified variable)
con→conid|(consym)(constructor)
qcon→qconid|(gconsym)(qualified constructor)
varop→varsym|`varid`(variable operator)
qvarop→qvarsym|`qvarid`(qualified variable operator)
conop→consym|`conid`(constructor operator)
qconop→gconsym|`qconid`(qualified constructor operator)
op→varop|conop(operator)
qop→qvarop|qconop(qualified operator)
gconsym→:|qconsym

Haskell provides special syntax to support infix notation. An operator is a function that can be applied using infix syntax (Section 3.4), or partially applied using a section (Section 3.5).

An operator is either an operator symbol, such as + or $$, or is an ordinary identifier enclosed in grave accents (backquotes), such as `op`. For example, instead of writing the prefix application op x y, one can write the infix application x `op` y. If no fixity declaration is given for op then it defaults to highest precedence and left associativity (see Section 4.4.2).

Dually, an operator symbol can be converted to an ordinary identifier by enclosing it in parentheses. For example, (+) x y is equivalent to x + y, and foldr (*) 1 xs is equivalent to foldr (\x y -> x*y) xs.

Special syntax is used to name some constructors for some of the built-in types, as found in the production for gcon and literal. These are described in Section 6.1.

An integer literal represents the application of the function fromInteger to the appropriate value of type Integer. Similarly, a floating point literal stands for an application of fromRational to a value of type Rational (that is, Ratio Integer).

Translation: The integer literal 𝑖 is equivalent to 𝚏𝚛𝚘𝚖𝙸𝚗𝚝𝚎𝚐𝚎𝚛𝑖, where fromInteger is a method in class Num (see Section 6.4.1).

The floating point literal 𝑓 is equivalent to 𝚏𝚛𝚘𝚖𝚁𝚊𝚝𝚒𝚘𝚗𝚊𝚕(𝑛𝚁𝚊𝚝𝚒𝚘.%𝑑), where fromRational is a method in class Fractional and Ratio.% constructs a rational from two integers, as defined in the module Data.Ratio from the standard library. The integers 𝑛 and 𝑑 are chosen so that 𝑛/𝑑=𝑓.

3.3 Curried Applications and Lambda Abstractions

fexp→[fexp]aexp(function application)
lexp→\apat1…apat𝑛->exp(lambda abstraction 𝑛≥1)

Function application is written 𝑒1𝑒2. Application associates to the left, so the parentheses may be omitted in (f x) y. Because 𝑒1 could be a data constructor, partial applications of data constructors are allowed.

Lambda abstractions are written \𝑝1…𝑝𝑛->𝑒, where the 𝑝𝑖 are patterns. An expression such as \x:xs->x is syntactically incorrect; it may legally be written as \(x:xs)->x.

The set of patterns must be linear—no variable may appear more than once in the set.

Translation: The following identity holds:

\𝑝1…𝑝𝑛->𝑒=\𝑥1…𝑥𝑛->𝚌𝚊𝚜𝚎(𝑥1,…,𝑥𝑛)𝚘𝚏(𝑝1,…,𝑝𝑛)->𝑒

where the 𝑥𝑖 are new identifiers.

Given this translation combined with the semantics of case expressions and pattern matching described in Section 3.18.4, if the pattern fails to match, then the result is ⊥.

3.4 Operator Applications

infixexp→lexpqopinfixexp
|-infixexp(prefix negation)
|lexp
qop→qvarop|qconop(qualified operator)

The form 𝑒1qop𝑒2 is the infix application of binary operator qop to expressions 𝑒1 and 𝑒2.

The special form −𝑒 denotes prefix negation, the only prefix operator in Haskell, and is syntax for 𝚗𝚎𝚐𝚊𝚝𝚎(𝑒). The binary - operator does not necessarily refer to the definition of - in the Prelude; it may be rebound by the module system. However, unary - will always refer to the negate function defined in the Prelude. There is no link between the local meaning of the - operator and unary negation.

Prefix negation has the same precedence as the infix operator - defined in the Prelude (see Table 1). Because e1-e2 parses as an infix application of the binary operator -, one must write e1(-e2) for the alternative parsing. Similarly, (-) is syntax for \x y -> x-y, as with any infix operator, and does not denote \x -> -x—one must use negate for that.

Translation: The following identities hold:

𝑒1op𝑒2=(op)𝑒1𝑒2−𝑒=𝚗𝚎𝚐𝚊𝚝𝚎(𝑒)

3.5 Sections

aexp→(infixexpqop)(left section)
|(qop⟨-⟩infixexp)(right section)

Sections are written as (op𝑒) or (𝑒op), where op is a binary operator and 𝑒 is an expression. Sections are a convenient syntax for partial application of binary operators.

Syntactic precedence rules apply to sections as follows. (op𝑒) is legal if and only if (𝑥op𝑒) parses in the same way as (𝑥op(𝑒)); and similarly for (𝑒op. For example, (*a+b) is syntactically invalid, but (+a*b) and (*(a+b)) are valid. Because (+) is left associative, (a+b+) is syntactically correct, but (+a+b) is not; the latter may legally be written as (+(a+b)). As another example, the expression

  (let n = 10 in n +)

is invalid because, by the let/lambda meta-rule (Section 3), the expression

  (let n = 10 in n + x)

parses as

  (let n = 10 in (n + x))

rather than

  ((let n = 10 in n) + x)

Because - is treated specially in the grammar, (−exp) is not a section, but an application of prefix negation, as described in the preceding section. However, there is a subtract function defined in the Prelude such that (𝚜𝚞𝚋𝚝𝚛𝚊𝚌𝚝exp) is equivalent to the disallowed section. The expression (+(−exp)) can serve the same purpose.

Translation: The following identities hold:

(op𝑒)=\𝑥->𝑥op𝑒(𝑒op)=\𝑥->𝑒op𝑥

where op is a binary operator, 𝑒 is an expression, and 𝑥 is a variable that does not occur free in 𝑒.

3.6 Conditionals

lexp→ifexp[;]thenexp[;]elseexp

A conditional expression has the form 𝚒𝚏𝑒1𝚝𝚑𝚎𝚗𝑒2𝚎𝚕𝚜𝚎𝑒3 and returns the value of 𝑒2 if the value of 𝑒1 is True, 𝑒3 if 𝑒1 is False, and ⊥ otherwise.

Translation: The following identity holds:

𝚒𝚏𝑒1𝚝𝚑𝚎𝚗𝑒2𝚎𝚕𝚜𝚎𝑒3=𝚌𝚊𝚜𝚎𝑒1𝚘𝚏{𝚃𝚛𝚞𝚎->𝑒2;𝙵𝚊𝚕𝚜𝚎->𝑒3}

where True and False are the two nullary constructors from the type Bool, as defined in the Prelude. The type of 𝑒1 must be Bool; 𝑒2 and 𝑒3 must have the same type, which is also the type of the entire conditional expression.

3.7 Lists

infixexp→exp1qopexp2
aexp→[exp1,…,exp𝑘](𝑘≥1)
|gcon
gcon→[]
|qcon
qcon→(gconsym)
qop→qconop
qconop→gconsym
gconsym→:

Lists are written [𝑒1,…,𝑒𝑘], where 𝑘≥1. The list constructor is :, and the empty list is denoted []. Standard operations on lists are given in the Prelude (see Section 6.1.3, and Chapter 9 notably Section 9.1).

Translation: The following identity holds:

[𝑒1,…,𝑒𝑘]=𝑒1:(𝑒2:(…(𝑒𝑘:[])))

where : and [] are constructors for lists, as defined in the Prelude (see Section 6.1.3). The types of 𝑒1 through 𝑒𝑘 must all be the same (call it 𝑡), and the type of the overall expression is [t] (see Section 4.1.2).

The constructor “:” is reserved solely for list construction; like [], it is considered part of the language syntax, and cannot be hidden or redefined. It is a right-associative operator, with precedence level 5 (Section 4.4.2).

3.8 Tuples

aexp→(exp1,…,exp𝑘)(𝑘≥2)
|qcon
qcon→(,{,})

Tuples are written (𝑒1,…,𝑒𝑘), and may be of arbitrary length 𝑘≥2. The constructor for an 𝑛-tuple is denoted by (,…,), where there are 𝑛−1 commas. Thus (a,b,c) and (,,) a b c denote the same value. Standard operations on tuples are given in the Prelude (see Section 6.1.4 and Chapter 9).

Translation: (𝑒1,…,𝑒𝑘) for 𝑘≥2 is an instance of a 𝑘-tuple as defined in the Prelude, and requires no translation. If 𝑡1 through 𝑡𝑘 are the types of 𝑒1 through 𝑒𝑘, respectively, then the type of the resulting tuple is (𝑡1,…,𝑡𝑘) (see Section 4.1.2).

3.9 Unit Expressions and Parenthesized Expressions

aexp→gcon
|(exp)
gcon→()

The form (𝑒) is simply a parenthesized expression, and is equivalent to 𝑒. The unit expression () has type () (see Section 4.1.2). It is the only member of that type apart from ⊥, and can be thought of as the “nullary tuple” (see Section 6.1.5).

Translation: (𝑒) is equivalent to 𝑒.

3.10 Arithmetic Sequences

aexp→[exp1[,exp2]..[exp3]]

The arithmetic sequence [𝑒1,𝑒2..𝑒3] denotes a list of values of type 𝑡, where each of the 𝑒𝑖 has type 𝑡, and 𝑡 is an instance of class Enum.

Translation: Arithmetic sequences satisfy these identities:

[ 𝑒1 ..]=enumFrom 𝑒1
[ 𝑒1, 𝑒2 ..]=enumFromThen 𝑒1 𝑒2
[ 𝑒1 .. 𝑒2 ]=enumFromTo 𝑒1 𝑒2
[ 𝑒1, 𝑒2 .. 𝑒3 ]=enumFromThenTo 𝑒1 𝑒2 𝑒3

where enumFrom, enumFromThen, enumFromTo, and enumFromThenTo are class methods in the class Enum as defined in the Prelude (see Section 6.3.4).

The semantics of arithmetic sequences therefore depends entirely on the instance declaration for the type t. See Section 6.3.4 for more details of which Prelude types are in Enum and their semantics.

3.11 List Comprehensions

aexp→[exp|qual1,…,qual𝑛](list comprehension, 𝑛≥1)
qual→pat<-exp(generator)
|letdecls(local declaration)
|exp(boolean guard)

A list comprehension has the form [𝑒|𝑞1,…,𝑞𝑛], 𝑛≥1, where the 𝑞𝑖 qualifiers are either

Such a list comprehension returns the list of elements produced by evaluating 𝑒 in the successive environments created by the nested, depth-first evaluation of the generators in the qualifier list. Binding of variables occurs according to the normal pattern matching rules (see Section 3.18), and if a match fails then that element of the list is simply skipped over. Thus:

[ x |  xs   <- [ [(1,2),(3,4)], [(5,4),(3,2)] ],
      (3,x) <- xs ]

yields the list [4,2]. If a qualifier is a boolean guard, it must evaluate to True for the previous pattern match to succeed. As usual, bindings in list comprehensions can shadow those in outer scopes; for example:

[𝑥|𝑥<-𝑥,𝑥<-𝑥]=[𝑧|𝑦<-𝑥,𝑧<-𝑦]

Translation: List comprehensions satisfy these identities, which may be used as a translation into the kernel:

[𝑒|𝚃𝚛𝚞𝚎]=[𝑒]
[𝑒|𝑞]=[𝑒|𝑞,𝚃𝚛𝚞𝚎]
[𝑒|𝑏,𝑄]=𝚒𝚏𝑏𝚝𝚑𝚎𝚗[𝑒,𝑄]𝚎𝚕𝚜𝚎[]
[𝑒|𝑝<-𝑙,𝑄]=𝚕𝚎𝚝 𝚘𝚔=[𝑒|𝑄]
𝚘𝚔_=[]
𝚒𝚗 𝚌𝚘𝚗𝚌𝚊𝚝𝙼𝚊𝚙 𝚘𝚔𝑙
[𝑒|𝚕𝚎𝚝decls,𝑄]=𝚕𝚎𝚝decls𝚒𝚗[𝑒|𝑄]

where 𝑒 ranges over expressions, 𝑝 over patterns, 𝑙 over list-valued expressions, 𝑏 over boolean expressions, decls over declaration lists, 𝑞 over qualifiers, and 𝑄 over sequences of qualifiers. ok is a fresh variable. The function concatMap, and boolean value True, are defined in the Prelude.

As indicated by the translation of list comprehensions, variables bound by let have fully polymorphic types while those defined by <- are lambda bound and are thus monomorphic (see Section 4.5.4).

3.12 Let Expressions

lexp→letdeclsinexp

Let expressions have the general form 𝚕𝚎𝚝{𝑑1;…;𝑑𝑛}𝚒𝚗𝑒, and introduce a nested, lexically-scoped, mutually-recursive list of declarations (let is often called letrec). The scope of the declarations is the expression 𝑒 and the right hand side of the declarations. Declarations are described in Chapter 4. Pattern bindings are matched lazily; an implicit ~ makes these patterns irrefutable. For example,

𝚕𝚎𝚝(𝑥,𝑦)=𝚞𝚗𝚍𝚎𝚏𝚒𝚗𝚎𝚍 𝚒𝚗𝑒

does not cause an execution-time error until x or y is evaluated.

Translation: The dynamic semantics of the expression 𝚕𝚎𝚝{𝑑1;…;𝑑𝑛}𝚒𝚗𝑒0 are captured by this translation: After removing all type signatures, each declaration 𝑑𝑖 is translated into an equation of the form 𝑝𝑖=𝑒𝑖, where 𝑝𝑖 and 𝑒𝑖 are patterns and expressions respectively, using the translation in Section 4.4.3. Once done, these identities hold, which may be used as a translation into the kernel:

𝚕𝚎𝚝{𝑝1=𝑒1;…;𝑝𝑛=𝑒𝑛}𝚒𝚗𝑒0=𝚕𝚎𝚝(∼𝑝1,…,∼𝑝𝑛)=(𝑒1,…,𝑒𝑛)𝚒𝚗𝑒0
𝚕𝚎𝚝𝑝=𝑒1𝚒𝚗𝑒0=𝚌𝚊𝚜𝚎𝑒1𝚘𝚏∼𝑝->𝑒0
where no variable in 𝑝 appears free in 𝑒1
𝚕𝚎𝚝𝑝=𝑒1𝚒𝚗𝑒0=𝚕𝚎𝚝𝑝=𝚏𝚒𝚡(\∼𝑝->𝑒1)𝚒𝚗𝑒0

where fix is the least fixpoint operator. Note the use of the irrefutable patterns ~p. This translation does not preserve the static semantics because the use of case precludes a fully polymorphic typing of the bound variables. The static semantics of the bindings in a let expression are described in Section 4.4.3.

3.13 Case Expressions

lexp→caseexpof {alts}
alts→alt1;…;alt𝑛(𝑛≥1)
alt→pat->exp[wheredecls]
|patgdpat[wheredecls]
|(empty alternative)
gdpat→guards->exp[gdpat]
guards→|guard1,…,guard𝑛(𝑛≥1)
guard→pat<-infixexp(pattern guard)
|letdecls(local declaration)
|infixexp(boolean guard)

A case expression has the general form

𝚌𝚊𝚜𝚎𝑒𝚘𝚏{𝑝1match1;…;𝑝𝑛match𝑛}

where each match𝑖 is of the general form

|gs𝑖1->𝑒𝑖1…|gs𝑖𝑚𝑖->𝑒𝑖𝑚𝑖𝚠𝚑𝚎𝚛𝚎decls𝑖

(Notice that in the syntax rule for guards, the “|” is a terminal symbol, not the syntactic metasymbol for alternation.) Each alternative 𝑝𝑖match𝑖 consists of a pattern 𝑝𝑖 and its matches, match𝑖. Each match in turn consists of a sequence of pairs of guards gsij and bodies 𝑒ij (expressions), followed by optional bindings (decls𝑖) that scope over all of the guards and expressions of the alternative.

A guard has one of the following forms:

An alternative of the form

pat->exp𝚠𝚑𝚎𝚛𝚎decls

is treated as shorthand for:

pat|𝚃𝚛𝚞𝚎 ->exp𝚠𝚑𝚎𝚛𝚎decls

A case expression must have at least one alternative and each alternative must have at least one body. Each body must have the same type, and the type of the whole expression is that type.

A case expression is evaluated by pattern matching the expression 𝑒 against the individual alternatives. The alternatives are tried sequentially, from top to bottom. If 𝑒 matches the pattern of an alternative, then the guarded expressions for that alternative are tried sequentially from top to bottom in the environment of the case expression extended first by the bindings created during the matching of the pattern, and then by the decls𝑖 in the where clause associated with that alternative.

For each guarded expression, the comma-separated guards are tried sequentially from left to right. If all of them succeed, then the corresponding expression is evaluated in the environment extended with the bindings introduced by the guards. That is, the bindings that are introduced by a guard (either by using a let clause or a pattern guard) are in scope in the following guards and the corresponding expression. If any of the guards fail, then this guarded expression fails and the next guarded expression is tried.

If none of the guarded expressions for a given alternative succeed, then matching continues with the next alternative. If no alternative succeeds, then the result is ⊥. Pattern matching is described in Section 3.18, with the formal semantics of case expressions in Section 3.18.4.

A note about parsing. The expression

  case x of { (a,_) | let b = not a in b :: Bool -> a }

is tricky to parse correctly. It has a single unambiguous parse, namely

  case x of { (a,_) | (let b = not a in b :: Bool) -> a }

However, the phrase Bool -> a is syntactically valid as a type, and parsers with limited lookahead may incorrectly commit to this choice, and hence reject the program. Programmers are advised, therefore, to avoid guards that end with a type signature — indeed that is why a guard contains an infixexp not an exp.

3.14 Do Expressions

lexp→do {stmts}(do expression)
stmts→stmt1…stmt𝑛exp[;](𝑛≥0)
stmt→exp;
|pat<-exp;
|letdecls;
|;(empty statement)

A do expression provides a more conventional syntax for monadic programming. It allows an expression such as

  putStr "x: "    >>
  getLine         >>= \l ->
  return (words l)

to be written in a more traditional way as:

  do putStr "x: "
     l <- getLine
     return (words l)

Translation: Do expressions satisfy these identities, which may be used as a translation into the kernel, after eliminating empty stmts:

𝚍𝚘{𝑒}=𝑒
𝚍𝚘{𝑒;stmts}=𝑒>>𝚍𝚘{stmts}
𝚍𝚘{𝑝<-𝑒;stmts}=𝚕𝚎𝚝 𝚘𝚔𝑝=𝚍𝚘{stmts}
𝚘𝚔_=𝚏𝚊𝚒𝚕 "..."
𝚒𝚗𝑒>>=𝚘𝚔
𝚍𝚘{𝚕𝚎𝚝decls;stmts}=𝚕𝚎𝚝decls𝚒𝚗 𝚍𝚘{stmts}

The ellipsis “...” stands for a compiler-generated error message, passed to fail, preferably giving some indication of the location of the pattern-match failure; the functions >>, >>=, and fail are operations in the class Monad, as defined in the Prelude; and ok is a fresh identifier.

As indicated by the translation of do, variables bound by let have fully polymorphic types while those defined by <- are lambda bound and are thus monomorphic.

3.15 Datatypes with Field Labels

A datatype declaration may optionally define field labels (see Section 4.2.1). These field labels can be used to construct, select from, and update fields in a manner that is independent of the overall structure of the datatype.

Different datatypes cannot share common field labels in the same scope. A field label can be used at most once in a constructor. Within a datatype, however, a field label can be used in more than one constructor provided the field has the same typing in all constructors. To illustrate the last point, consider:

  data S = S1 { x :: Int } | S2 { x :: Int }   -- OK
  data T = T1 { y :: Int } | T2 { y :: Bool }  -- BAD

Here S is legal but T is not, because y is given inconsistent typings in the latter.

3.15.1 Field Selection

aexp→qvar

Field labels are used as selector functions. When used as a variable, a field label serves as a function that extracts the field from an object. Selectors are top level bindings and so they may be shadowed by local variables but cannot conflict with other top level bindings of the same name. This shadowing only affects selector functions; in record construction (Section 3.15.2) and update (Section 3.15.3), field labels cannot be confused with ordinary variables.

Translation: A field label 𝑓 introduces a selector function defined as:

𝑓𝑥=𝚌𝚊𝚜𝚎𝑥𝚘𝚏{𝐶1𝑝11…𝑝1𝑘->𝑒1;…;𝐶𝑛𝑝𝑛1…𝑝𝑛𝑘->𝑒𝑛}

where 𝐶1…𝐶𝑛 are all the constructors of the datatype containing a field labeled with 𝑓, 𝑝𝑖𝑗 is 𝑦 when 𝑓 labels the 𝑗th component of 𝐶𝑖 or _ otherwise, and 𝑒𝑖 is 𝑦 when some field in 𝐶𝑖 has a label of 𝑓 or undefined otherwise.

3.15.2 Construction Using Field Labels

aexp→qcon{fbind1,…,fbind𝑛}(labeled construction, 𝑛≥0)
fbind→qvar=exp

A constructor with labeled fields may be used to construct a value in which the components are specified by name rather than by position. Unlike the braces used in declaration lists, these are not subject to layout; the { and } characters must be explicit. (This is also true of field updates and field patterns.) Construction using field labels is subject to the following constraints:

The expression F {}, where F is a data constructor, is legal whether or not F was declared with record syntax (provided F has no strict fields — see the fourth bullet above); it denotes 𝐹⊥1…⊥𝑛, where 𝑛 is the arity of F.

Translation: In the binding 𝑓=𝑣, the field 𝑓 labels 𝑣.

𝐶{bs}=𝐶(pick1𝐶bs𝚞𝚗𝚍𝚎𝚏𝚒𝚗𝚎𝚍)…(pick𝑘𝐶bs𝚞𝚗𝚍𝚎𝚏𝚒𝚗𝚎𝚍)

where 𝑘 is the arity of 𝐶.

The auxiliary function pick𝑖𝐶bs𝑑 is defined as follows:

If the 𝑖th component of a constructor 𝐶 has the field label 𝑓, and if 𝑓=𝑣 appears in the binding list bs , then pick𝑖𝐶bs𝑑 is 𝑣. Otherwise, pick𝑖𝐶bs𝑑 is the default value 𝑑.

3.15.3 Updates Using Field Labels

aexp→aexp⟨qcon⟩{fbind1,…,fbind𝑛}(labeled update, 𝑛≥1)

Values belonging to a datatype with field labels may be non-destructively updated. This creates a new value in which the specified field values replace those in the existing value. Updates are restricted in the following ways:

Translation: Using the prior definition of pick,

𝑒{bs}=𝚌𝚊𝚜𝚎𝑒𝚘𝚏
𝐶1𝑣1…𝑣𝑘1->𝐶1(pick1𝐶1bs𝑣1)…(pick𝑘1𝐶1bs𝑣𝑘1)
…
𝐶𝑗𝑣1…𝑣𝑘𝑗->𝐶𝑗(pick1𝐶𝑗bs𝑣1)…(pick𝑘𝑗𝐶𝑗bs𝑣𝑘𝑗)
_ -> 𝚎𝚛𝚛𝚘𝚛 "𝚄𝚙𝚍𝚊𝚝𝚎 𝚎𝚛𝚛𝚘𝚛"

where {𝐶1,…,𝐶𝑗} is the set of constructors containing all labels in bs, and 𝑘𝑖 is the arity of 𝐶𝑖.

Here are some examples using labeled fields:

data T    = C1 {f1,f2 :: Int}
          | C2 {f1 :: Int,
                f3,f4 :: Char}
ExpressionTranslation
C1 {f1 = 3}C1 3 undefined
C2 {f1 = 1, f4 = 'A', f3 = 'B'}C2 1 'B' 'A'
x {f1 = 1}case x of C1 _ f2 -> C1 1 f2
C2 _ f3 f4 -> C2 1 f3 f4

The field f1 is common to both constructors in T. This example translates expressions using constructors in field-label notation into equivalent expressions using the same constructors without field labels. A compile-time error will result if no single constructor defines the set of field labels used in an update, such as x {f2 = 1, f3 = 'x'}.

3.16 Expression Type-Signatures

Expression type-signatures have the form 𝑒::𝑡, where 𝑒 is an expression and 𝑡 is a type (Section 4.1.2); they are used to type an expression explicitly and may be used to resolve ambiguous typings due to overloading (see Section 4.3.4). The value of the expression is just that of exp. As with normal type signatures (see Section 4.4.1), the declared type may be more specific than the principal type derivable from exp, but it is an error to give a type that is more general than, or not comparable to, the principal type.

Translation:

𝑒::𝑡=𝚕𝚎𝚝{𝑣::𝑡;𝑣=𝑒}𝚒𝚗𝑣

3.17 Patterns

This section introduces the syntax of patterns (Section 3.17.1) and some of their important properties: Linearity (Section 3.17.2), refutability (Section 3.17.3) and failability (Section 3.17.4). The semantics of patterns in the context of case expressions, and how to evaluate them, is discussed in Section 3.18.

3.17.1 Syntax

Patterns have this syntax:

pat→lpatqconoppat(infix constructor)
|lpat
lpat→apat
|-(integer|float)(negative literal)
|gconapat1…apat𝑘(arity gcon=𝑘, 𝑘≥1)
apat→var[@apat](as pattern)
|gcon(arity gcon=0)
|qcon{fpat1,…,fpat𝑘}(labeled pattern, 𝑘≥0)
|literal
|_(wildcard)
|(pat)(parenthesized pattern)
|(pat1,…,pat)(tuple pattern, 𝑘≥2)
|[pat1,…,pat](list pattern, 𝑘≥1)
|~apat(irrefutable pattern)
fpat→qvar=pat
3.17.1.1 As-Patterns

Patterns of the form var@pat are called as-patterns, and allow one to use var as a name for the value being matched by pat. For example,

case e of { xs@(x:rest) -> if x==0 then rest else xs }

is equivalent to:

let { xs = e } in
  case xs of { (x:rest) -> if x==0 then rest else xs }
3.17.1.2 Wildcard Patterns

Patterns of the form _ are wildcards and are useful when some part of a pattern is not referenced on the right-hand-side. It is as if an identifier not used elsewhere were put in its place. For example,

case e of { [x,_,_]  ->  if x==0 then True else False }

is equivalent to:

case e of { [x,y,z]  ->  if x==0 then True else False }
3.17.1.3 Numeric Literal Patterns

Aside from the obvious static type constraints (for example, it is a static error to match a character against a boolean), the following static class constraints hold:

3.17.2 Linear Patterns

A pattern is linear if no variable appears more than once in it.

All patterns must be linear. For example, this definition is illegal:

f (x,x) = x     -- ILLEGAL; x used twice in pattern

3.17.3 Refutable and Irrefutable Patterns

Every pattern is either refutable or irrefutable. The irrefutable patterns are as follows:

All other patterns are refutable.

Refutability is a syntactic property that can be checked by inspecting the syntax of the pattern and consulting type declarations in the program. However, it is motivated by the following semantic property: Matching an irrefutable pattern is non-strict: the pattern matches even if the value to be matched is ⊥. Matching an irrefutable pattern against a value can therefore never diverge or fail (cp. Section 3.18.1). Matching a refutable pattern is strict: if the value to be matched is ⊥ the match diverges.

3.17.4 Failable and Failure-Free Patterns

Every pattern is either failable or failure-free. The failure-free patterns are as follows:

All other patterns are failable.

Every irrefutable pattern is also failure-free, but not vice-versa: for example (x, y) is failure-free but refutable.

Failability is a syntactic property that can be checked by inspecting the syntax of the pattern and consulting type declarations in the program. However, it is motivated by the following semantic property: Matching a failure-free pattern against a value can never fail (cp. Section 3.18.1).

3.18 Pattern Matching

Patterns appear in lambda abstractions, function definitions, pattern bindings, list comprehensions, do expressions, and case expressions. However, the first five of these ultimately translate into case expressions, so defining the semantics of pattern matching for case expressions is sufficient.

3.18.1 Outcomes of Matching a Pattern Against a Value

Patterns are matched against values, which can have one of three results:

  1. it may fail. For example, matching the pattern True against the value False fails.
  2. it may succeed, returning a binding for each variable in the pattern. For example, matching the pattern [x,y] against the value [2,3] succeeds and binds x to the value 2 and y to the value 3.
  3. it may diverge. For example, matching the pattern True against the value ⊥ diverges. In that case the overall computation of which the pattern is a part also diverges (i.e. returns ⊥).

3.18.2 Informal Semantics of Pattern Matching

Pattern matching proceeds from left to right, and outside to inside, according to the following rules:

  1. Matching the pattern var against a value 𝑣 always succeeds and binds var to 𝑣.
  2. Matching the pattern ∼apat against a value 𝑣 always succeeds. The free variables in apat are bound to the appropriate values if matching apat against 𝑣 would otherwise succeed, and to ⊥ if matching apat against 𝑣 fails or diverges. (Binding does not imply evaluation.)

    Operationally, this means that no matching is done on a ∼apat pattern until one of the variables in apat is used. At that point the entire pattern is matched against the value, and if the match fails or diverges, so does the overall computation.

  3. Matching the wildcard pattern _ against any value always succeeds, and no binding is done.
  4. Matching the pattern conpat against a value, where con is a constructor defined by newtype, depends on the value:

    • If the value is of the form con𝑣, then pat is matched against 𝑣.
    • If the value is ⊥, then pat is matched against ⊥.

    That is, constructors associated with newtype serve only to change the type of a value.

  5. Matching the pattern conpat1…pat𝑛 against a value, where con is a constructor defined by data, depends on the value:

    • If the value is of the form con𝑣1…𝑣𝑛, sub-patterns are matched left-to-right against the components of the data value; if all matches succeed, the overall match succeeds; the first to fail or diverge causes the overall match to fail or diverge, respectively.
    • If the value is of the form con′𝑣1…𝑣𝑚, where con is a different constructor to con′, the match fails.
    • If the value is ⊥, the match diverges.
  6. Matching against a constructor using labeled fields is the same as matching ordinary constructor patterns except that the fields are matched in the order they are named in the field list. All fields listed must be declared by the constructor; fields may not be named more than once. Fields not named by the pattern are ignored (matched against _).
  7. Matching a numeric, character, or string literal pattern 𝑘 against a value 𝑣 succeeds if 𝑣==𝑘, where == is overloaded based on the type of the pattern. The match diverges if this test diverges.

    The interpretation of numeric literals is exactly as described in Section 3.2; that is, the overloaded function fromInteger or fromRational is applied to an Integer or Rational literal (resp) to convert it to the appropriate type.

  8. Matching an as-pattern var@apat against a value 𝑣 is the result of matching apat against 𝑣, augmented with the binding of var to 𝑣. If the match of apat against 𝑣 fails or diverges, then so does the overall match.
3.18.2.1 Examples
  1. If the pattern ['a','b'] is matched against [′𝑥′,⊥], then 'a' fails to match against 'x', and the result is a failed match. But if ['a','b'] is matched against [⊥,′𝑥′], then attempting to match 'a' against ⊥ causes the match to diverge.

  2. These examples demonstrate refutable vs. irrefutable (Section 3.17.3) matching:

    (\ ~(x,y) -> 0) ⊥⇒0
    (\ (x,y) -> 0) ⊥⇒⊥
    (\ ~[x] -> 0) []⇒0
    (\ ~[x] -> x) []⇒⊥
    (\ ~[x, ~(a,b)] -> x [(0,1),⊥]⇒(0,1)
    (\ ~[x, (a,b)] -> x [(0,1),⊥]⇒⊥
    (\ (x:xs) -> x:x:xs) ⊥⇒⊥
    (\ ~(x:xs) -> x:x:xs) ⊥⇒⊥:⊥:⊥
  3. Consider the following declarations:

    newtype N = N Bool
    data    D = D !Bool

    These examples illustrate the difference in pattern matching between types defined by data and newtype:

    (\ (N True) -> True) ⊥⇒⊥
    (\ (D True) -> True) ⊥⇒⊥
    (\ ~(D True) -> True) ⊥⇒True

    Additional examples may be found in Section 4.2.3.

3.18.3 Guards

Top level patterns in case expressions and the set of top level patterns in function or pattern bindings may have zero or more associated guards. See Section 3.13 for the syntax and semantics of guards.

The guard semantics have an influence on the strictness characteristics of a function or case expression. In particular, an otherwise irrefutable pattern may be evaluated because of a guard. For example, in

f :: (Int,Int,Int) -> [Int] -> Int
f ~(x,y,z) [a] | (a == y) = 1

both a and y will be evaluated by == in the guard.

3.18.4 Formal Semantics of Pattern Matching

The semantics of all pattern matching constructs other than case expressions are defined by giving identities that relate those constructs to case expressions. The semantics of case expressions themselves are in turn given as a series of identities, in Figure 1 – Figure 2. Any implementation should behave so that these identities hold; it is not expected that it will use them directly, since that would generate rather inefficient code.

In Figure 1 – Figure 2: 𝑒, 𝑒′ and 𝑒𝑖 are expressions; 𝑔𝑖 and gs𝑖 are guards and sequences of guards respectively; 𝑝 and 𝑝𝑖 are patterns; 𝑣, 𝑥, and 𝑥𝑖 are variables; 𝐾 and 𝐾′ are algebraic datatype (data) constructors (including tuple constructors); and 𝑁 is a newtype constructor.

Rule (b) matches a general source-language case expression, regardless of whether it actually includes guards—if no guards are written, then True is substituted for the guards gs𝑖,𝑗 in the match𝑖 forms. Subsequent identities manipulate the resulting case expression into simpler and simpler forms.

Rule (h) in Listing 3 involves the overloaded operator ==; it is this rule that defines the meaning of pattern matching against overloaded constants.

These identities all preserve the static semantics. Rules (d), (e), (j), and (q) use a lambda rather than a let; this indicates that variables bound by case are monomorphically typed (Section 4.1.4).

(a)
𝚌𝚊𝚜𝚎𝑒𝚘𝚏{ alts }=(\𝑣->𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ alts }) 𝑒
where 𝑣 is a new variable
(b)

𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑝1 match1;…;𝑝𝑛 match𝑛 }
=𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑝1 match1;
_ ->…𝚌𝚊𝚜𝚎𝑣𝚘𝚏{
𝑝𝑛 match𝑛;
_ -> 𝚎𝚛𝚛𝚘𝚛 "𝙽𝚘 𝚖𝚊𝚝𝚌𝚑"}…}
where each match𝑖 has the form

|gs𝑖,1->𝑒𝑖,1;…;gs𝑖,𝑚𝑖->𝑒𝑖,𝑚𝑖𝚠𝚑𝚎𝚛𝚎{decls}
(c)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑝|gs1->𝑒1;…
|gs𝑛->𝑒𝑛𝚠𝚑𝚎𝚛𝚎{decls}
_ ->𝑒′ }
=𝚌𝚊𝚜𝚎𝑒′𝚘𝚏{ 𝑦->
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{
𝑝->𝚕𝚎𝚝{decls}𝚒𝚗
𝚌𝚊𝚜𝚎()𝚘𝚏{
()|gs1->𝑒1;
_ -> …𝚌𝚊𝚜𝚎()𝚘𝚏{
()|gs𝑛->𝑒𝑛;
_ ->𝑦 } … }
_ ->𝑦 }}
where 𝑦 is a new variable
(d)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{~𝑝->𝑒; _ -> 𝑒′}
=(\𝑥1…𝑥𝑛->𝑒)(𝚌𝚊𝚜𝚎𝑣𝚘𝚏{𝑝->𝑥1})…(𝚌𝚊𝚜𝚎𝑣𝚘𝚏{𝑝->𝑥𝑛})
where 𝑥1,…,𝑥𝑛 are all the variables in 𝑝
(e)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑥@𝑝->𝑒 ; _ ->𝑒′}
=𝚌𝚊𝚜𝚎𝑣𝚘𝚏{𝑝->(\𝑥->𝑒) 𝑣 ; _ ->𝑒′}
(f)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ _ ->𝑒 ; _ ->𝑒′ }=𝑒
Figure 1: Semantics of Case Expressions, Part 1
(g)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝐾𝑝1…𝑝𝑛->𝑒_ ->𝑒′ }
=𝚌𝚊𝚜𝚎𝑣𝚘𝚏{
𝐾 𝑥1…𝑥𝑛->𝚌𝚊𝚜𝚎𝑥1𝚘𝚏{
𝑝1->…𝚌𝚊𝚜𝚎𝑥𝑛𝚘𝚏{𝑝𝑛->𝑒; _ ->𝑒′}…
_ ->𝑒′}
_ ->𝑒′}
at least one of 𝑝1,…,𝑝𝑛 is not a variable; 𝑥1,…,𝑥𝑛 are new variables
(h)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑘->𝑒; _ ->𝑒′ }=𝚒𝚏(𝑣==𝑘)𝚝𝚑𝚎𝚗𝑒𝚎𝚕𝚜𝚎𝑒′
where 𝑘 is a numeric, character, or string literal
(i)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑥->𝑒; _ ->𝑒′ }=𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑥->𝑒 }
(j)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑥->𝑒 }=(\𝑥->𝑒) 𝑣
(k)
𝚌𝚊𝚜𝚎𝑁𝑣𝚘𝚏{ 𝑁𝑝->𝑒; _ ->𝑒′ }
=𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝑝->𝑒; _ ->𝑒′ }
where 𝑁 is a newtype constructor
(l)
𝚌𝚊𝚜𝚎⊥𝚘𝚏{ 𝑁 𝑝->𝑒; _ ->𝑒′ }=𝚌𝚊𝚜𝚎⊥𝚘𝚏{ 𝑝-> 𝑒 }
where 𝑁 is a newtype constructor
(m)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝐾{𝑓1=𝑝1,𝑓2=𝑝2,…}->𝑒; _ ->𝑒′ }
=𝚌𝚊𝚜𝚎𝑒′𝚘𝚏{
𝑦->
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{
𝐾{𝑓1=𝑝1}->
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{𝐾{𝑓2=𝑝2,…}->𝑒; _ ->𝑦};
_ ->𝑦}}
where 𝑓1,𝑓2,… are fields of constructor 𝐾; 𝑦 is a new variable
(n)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝐾{𝑓=𝑝}->𝑒; _ ->𝑒′ }
=𝚌𝚊𝚜𝚎𝑣𝚘𝚏{
𝐾𝑝1…𝑝𝑛->𝑒; _ ->𝑒′}
where 𝑝𝑖 is 𝑝 if 𝑓 labels the 𝑖th component of 𝐾, _ otherwise
(o)
𝚌𝚊𝚜𝚎𝑣𝚘𝚏{ 𝐾 { }->𝑒; _ ->𝑒′ }
=𝚌𝚊𝚜𝚎𝑣𝚘𝚏{
𝐾_…_->𝑒; _ ->𝑒′}
(p)
𝚌𝚊𝚜𝚎(𝐾′ 𝑒1…𝑒𝑚)𝚘𝚏{ 𝐾 𝑥1…𝑥𝑛->𝑒; _ ->𝑒′ }=𝑒′
where 𝐾 and 𝐾′ are distinct data constructors of arity 𝑛 and 𝑚, respectively
(q)
𝚌𝚊𝚜𝚎(𝐾𝑒1…𝑒𝑛)𝚘𝚏{ 𝐾𝑥1…𝑥𝑛->𝑒; _ ->𝑒′ }
=(\𝑥1…𝑥𝑛->𝑒)𝑒1…𝑒𝑛
where 𝐾 is a data constructor of arity 𝑛
(r)
𝚌𝚊𝚜𝚎⊥𝚘𝚏{ 𝐾𝑥1…𝑥𝑛->𝑒; _ ->𝑒′ }=⊥
where 𝐾 is a data constructor of arity 𝑛
Listing 3: Semantics of Case Expressions, Part 2
(s)
𝚌𝚊𝚜𝚎()𝚘𝚏{ ()|𝑔1,…,𝑔𝑛->𝑒; _ ->𝑒′ }
=𝚌𝚊𝚜𝚎()𝚘𝚏{
()|𝑔1->…𝚌𝚊𝚜𝚎()𝚘𝚏{
()|𝑔𝑛->𝑒;
_ ->𝑒′ } …
_ ->𝑒′ }
where 𝑦 is a new variable
(t)
𝚌𝚊𝚜𝚎()𝚘𝚏{ ()|𝑝<-𝑒0->𝑒; _ ->𝑒′ }
=𝚌𝚊𝚜𝚎𝑒0𝚘𝚏{ 𝑝->𝑒; _ ->𝑒′ }
(u)
𝚌𝚊𝚜𝚎()𝚘𝚏{ ()|𝚕𝚎𝚝decls->𝑒; _ ->𝑒′ }
=𝚕𝚎𝚝decls𝚒𝚗𝑒
(v)
𝚌𝚊𝚜𝚎()𝚘𝚏{ ()|𝑒0->𝑒; _ ->𝑒′ }
=𝚒𝚏𝑒0𝚝𝚑𝚎𝚗𝑒𝚎𝚕𝚜𝚎𝑒′
Figure 2: Semantics of Case Expressions, Part 3