# Basics

The source code for this module: Basics.ard

The source code for the exercises: BasicsEx.ard

In this module we explain the syntax and some key constructs of the Arend language, required to get started with writing definitions, propositions and proofs.

Arend has the following kinds of definitions: functions, data definitions, classes and records. As of now, we only consider functions and data definitions, exposition of classes and records is deferred to Records and Classes.

Some of the most basic definitions are built into the language and contained in the module Prelude. For example, Prelude contains types Nat and Int of natural and integer numbers respectively and the equality type =.

# Lexical structure

All keywords in Arend start with backslash \. For example, function and data definitions start with keywords \func and \data respectively.

Numerals, if they occur in terms, are always interpreted as elements of types Nat or Int: non-negative numerals are of type Nat, negative numerals are of type Int.

Arend allows considerable amount of freedom in the choice of identifiers. With a few exceptions, names of definitions, variables
etc may contain upper or lower case letters, digits and characters from the list `~!@#$%^&*-+=<>?/|[]:_`

.

# Functions

Function definitions start with the keyword \func. Functions in Arend are mathematical functions.
In particular, this means that they are *pure* and do not interact with the environment via input-output.

The simplest definition of a function must contain the name of a function
and its body. For example, the zero constant function `f`

without parameters can be defined as follows:

```
\func f => 0 -- constant function
{- Haskell:
f = 0
-}
```

The body of f is just the numeral 0 of type Nat. The result type Nat of f in this case is inferred by the typechecker, but it can also be specified explicitly:

```
\func f' : Nat => 0 -- constant with explicit type
{- Haskell:
f :: Nat
f = 0
-}
```

In case a function has parameters, they can be specified together with their types just after the name of the function as shown below:

```
\func id (x : Nat) => x -- identity function on natural numbers
\func id' (x : Nat) : Nat => x -- the same, but with explicit result type
{- Haskell:
id :: Nat -> Nat
id x = x
-}
\func foo (x _ : Nat) (_ : Int) => x -- simply returning the first argument
{- Haskell:
foo :: Nat -> Nat -> Int -> Nat
foo x y z = x
-}
```

As demonstrated in the definition of foo, if a parameter is not used, you can omit the specification
of its name by using the symbol `_`

. Also, if several consecutive parameters have the same type, they can be merged:
(x _ : Nat) is equivalent to (x : Nat) (_ : Nat).

Note that in contrast to Haskell, types of parameters should always be specified:

```
-- \func id'' x => x -- this definition is not correct!
{- Haskell:
id'' x = x
-}
```

Equivalently, parameters of a function can be moved from the signature to the body by means of lambda expressions:

```
-- types of parameters cannot be infered as before
\func foo' => \lam (x _ : Nat) (_ : Int) => x
-- but types of parameters can be omitted if the result type is specified explicitly
\func foo'' : Nat -> Nat -> Int -> Nat => \lam x _ _ => x
{- Haskell:
foo'' :: Nat -> Nat -> Int -> Nat
foo'' = \x y z -> x
-}
```

In the examples above we specified the bodies of functions by simply writing a term after the symbol =>.
Of course, there are more sophisticated ways to define the body of a function, for example, in case the function is recursive.
Namely, functions can also be defined by *pattern matching*, we will consider such functions below.

# Infix operators

By default all binary operators, just as normal functions, are prefix. In order to define an infix operator one should specify before the name of the operator one of the keywords \infix, \infixl or \infixr together with a positive integer for priority:

```
\func \infixl 6 $$ (x y : Nat) => x
\func test => 3 $$ 7 -- test returns 3
{- Haskell:
infixl 6 $$
($$) x y = x
test = 3 $$ 7
-}
```

Priority can be any positive integer between 1 and 9.

Any binary operator, even if it was not declared as infix, can be used in infix form by means of surrounding it with ` `.

```
\func ff (x y : Nat) => x
\func ff_test => 0 `ff` 1
{- Haskell:
ff x y = x
ff_test = 3 `ff` 7
-}
```

Any infix operator can also be used in the prefix from:

```
\func \infix 6 %% (x y : Nat) => x
\func %%-test => %% 3 7 -- no need to surround %% with ( )
{- Haskell:
infix 5 %%
(%%) x y = x
pp_test = (%%) 3 7
-}
```

**Exercise 1:** Define priorities of the functions f1, f2, f3, f4, f5 and f6 so that the function ‘test’ typechecks.

```
\func f1 (x y : Nat) => x
\func f2 : Nat => 0
\func f3 (f : Nat -> Nat) (z : Nat) : Int => 0
\func f4 : Nat => 0
\func f5 => f1
\func f6 => f4
\func test => f1 f2 f3 f4 f5 f6
```

# Data definitions

Data definitions allow to define new *inductive* and *higher-inductive* types by specifying their ‘‘generating’’ elements,
called *constructors*.

In the simplest case, when constructors do not have parameters, an inductive type is just a finite set formed by its constructors. For example, the empty type Empty, the one-element unit type Unit and the two-element type Bool of boolean values with two constructors true and false can be defined as follows:

```
\data Empty
{- Haskell:
data Empty
-}
\data Unit | unit
{- Haskell:
data Unit = Unit
-}
\data Bool | false | true
{- Haskell:
data Bool = False | True
-}
```

Defining a function on Bool naturally corresponds to specifying its values on true
and false via the mechanism called *pattern matching*. For example, functions not and
if can be defined as follows:

```
\func not (x : Bool) : Bool \with -- keyword \with can be omitted
| true => false
| false => true
{- Haskell:
not :: Bool -> Bool
not True = False
not False = True
-}
\func if (x : Bool) (t e : Nat) : Nat \elim x
| true => t
| false => e
{- Haskell:
if :: Bool -> Nat -> Nat -> Nat
if True t e = t
if False t e = e
-}
```

Typically, inductive types have constructors with parameters. In contrast to parameters of functions, it is allowed to write cons T instead of cons (_ : T).

Types of these parameters may refer to the inductive type
itself, for example, as we will shortly see in case of the type of natural numbers. However, there is an important restriction:
all occurrences of an inductive type in types of parameters of constructors must be *strictly positive*. This means that
the inductive type cannot occur to the left of ->. If such definitions were allowed, it would have been possible to
define the type of ‘‘all untyped lambda terms’’ K. In particular, non-terminating terms
could have been coded as elements of K.

```
\data K | k (K -> K)
\func I => k (\lam x => x)
\func Kc => k (\lam x => k (\lam _ => x))
\func app (f a : K) : K \elim f
| k f' => f' a
\func omega => k (\lam x => app x x)
```

Let us turn to another example: the type of natural numbers. Definitions of the type Nat and of operations +, * from Prelude can be reproduced as follows:

```
\data Nat | zero | suc Nat
-- the following functions are equivalent
\func three => suc (suc (suc zero))
\func three' => 3
-- there is no limit on the size of numbers
\func bigNumber => 1000000000000000000000000
\func \infixl 6 + (x y : Nat) : Nat \elim y
| 0 => x
| suc y => suc (x + y)
{- Haskell:
(+) :: Nat -> Nat -> Nat
x + Zero = x
x + Suc y = Suc (x + y)
-}
-- If n is a variable, then n + 2 evaluates to suc (suc n),
-- but 2 + n does not as it is already in the normal form.
-- This behaviour depends on the definition of +, namely,
-- the argument chosen for pattern matching.
\func \infixl 7 * (x y : Nat) : Nat \elim y
| 0 => 0
| suc y => x * y + x
{- Haskell:
(*) :: Nat -> Nat -> Nat
x * Zero = 0
x * Suc y = x * y + x
-}
```

This is not the only way to define a type of natural numbers. The definition above corresponds to unary representation of natural numbers. The type of binary natural numbers can be defined as follows:

```
\data BinNat
| zero'
| sh+1 BinNat -- x*2+1
| sh+2 BinNat -- x*2+2
```

Efficiency-wise this definition is obviously much better. However, it is much less convenient for proofs by induction, than the definition of Nat above. And actually the type Nat from Prelude is efficient as well, because actual implementations of arithmetic operations differ from those above and efficiently hard coded in ad hoc way.

**Exercise 2:** Define the function ‘if’, which takes a boolean value b and two elements of an arbitrary type A and return the first element when b equals to true and the second one otherwise.

**Exercise 3:** Define || via ‘if’.

**Exercise 4:** Define the power and the factorial functions for natural numbers.

```
\func \infixr 8 ^ (x y : Nat) => {?}
\func fac (x : Nat) => {?}
```

**Exercise 5:** Define mod and gcd.

# Termination, div

Functions can be recursive, but they cannot refer to themselves in an arbitrary way. If the recursion were unrestricted, every proposition could have been trivially proven:

`\func theorem : 0 = 1 => theorem`

Moreover, the typechecking procedure in dependently typed language needs to check termination. Consequently, the language cannot be Turing complete, because typechecking becomes undecidable in this case.

Intensional Martin-Lof type theory avoids this kind of issues by ensuring that all definable functions are total, that is
their evaluation terminates on every input.
It is thus typical for theorem provers, that have Martin-Lof type theory in the core of their type system, to require
all functions to terminate and all recursive functions to be defined by *structural recursion*. And this also
applies to Arend.

For example, consider the division function div for natural numbers. An obvious but not correct definition may look like this:

`\func div (x y : Nat) : Nat => if (x < y) 0 (suc (div (x - y) y))`

There are two problems with this definition. Firstly, evaluation of div x 0 does not terminate. Secondly, the recursion is not structural. Structural recursion requires arguments of recursive calls to be structurally simpler than the original argument.

A recursive function can often be turned into structurally recursive function by introducing additional parameter, which decreases with the increase of the level of recursive calls. Initial value of this parameter can be set to an upper bound to the number of recursive steps:

```
\func div (x y : Nat) => div' x x y
\where
\func div' (s x y : Nat) : Nat \elim s
| 0 => 0
| suc s => if (x < y) 0 (suc (div' s (x - y) y))
```

# Polymorphism

Some definitions are polymorphic, that is they can be naturally parameterised by a type. Such definitions can be stated with the use of the type \Type of all types. For example, the polymorphic identity function can be stated as follows:

```
\func id (A : \Type) (a : A) => a
{- Haskell:
id :: a -> a
id x = x
-}
\func idType : \Pi (A : \Type) (a : A) -> A => id
{- Haskell:
idType :: a -> a
idType = id
-}
```

The type \Pi (a : A) -> B is the type of dependent functions, which generalizes the type of ordinary functions A -> B. The codomain of a dependent function may vary dependening on the argument. For example, the type \Pi (b : Bool) -> if b Nat Bool is the type of functions which accept an argument of type Bool and return either a natural number or a boolean value, depending its argument. If we pass true to such a function, it returns an element of Nat; otherwise, it returns an element of Bool.

The type \Pi (A : \Type) (a : A) -> A can be equivalently written as \Pi (A : \Type) -> A -> A since its codomain does not depend on the second argument. This is the type functions which accept a type A and return a function of type A -> A.

Note that \Type is not a type of *all* types: the famous Girard’s paradox states that intensional Martin-Lof’s
type theory is inconsistent with the type of all types.
This problem is solved with a hierarchy of universes, which will be discussed later.
Fortunately, the user does not need to care about these levels for the most part.
Levels are inferred automatically and hidden from the user, unless he or she uses forbidden circularities, in which case typechecker will generate an error.

# Implicit arguments

It is quite often the case that some arguments in a function application are completely determined by others. In such cases user may ask typechecker to infer these arguments by writing _ in place of them. For example, an application of id function defined above may look as follows:

`\func idTest => id _ 0`

In this case the typechecker can infer Nat as the value of the first argument, because it must be the type of the second argument, which is Nat. If the typechecker fails to infer an argument, it generates an error.

If a parameter of a definition is expected to be always or most of the times determined by others, it can be specified
as *implicit* by surrounding it in curly braces. In this case the corresponding arguments can be skipped altogether:

```
\func id' {A : \Type} (a : A) => a
\func id'Test => id' 0
\func id'Test' => id' {Nat} 0 -- implicit arguments can be specifyed explicitly
```

Of course, the argument inference algorithm is limited and it cannot do too fancy things. Consider, for instance, the following example:

`\func example' {n : Nat} (p : n + n = 3) => 0`

In this case the inference algorithm will fail to infer n from the type of p since n occurs only inside the invocation of the function +. For example, in the invocation example’ pp, where pp : 8 = 3, the algorithm will not infer that n is 4.

On the other hand, the algorithm will be able infer n and m in the following example:

```
\func example'' {n m : Nat} (p : suc n = m) => 0
\func example''Test (pp : 8 = 3) => example'' pp
```

The difference is that in this case n and m occur in invocations of \data (= is defined via Path, which is a data type) and the constructor suc. Since \data and constructors are injective, the algorithm can always infer n and m in such cases. For example, in the invocation example’’ pp, where pp : 8 = 3, the algorithm will infer that m must be 3 and n must be 7.

# List, append

By now we have discussed all the things necessary to properly define the polymorphic type of lists:

```
\data List (A : \Type) | nil | cons A (List A)
{- Haskell:
data List a = Nil | Cons a (List a)
-}
-- Constructors have implicit parameters for each of the parameters of data type
\func emptyList => nil {Nat}
-- Operator 'append'
\func \infixl 6 ++ {A : \Type} (xs ys : List A) : List A \elim xs
| nil => ys
| cons x xs => cons x (xs ++ ys)
{- Haskell:
(++) :: List a -> List A -> List a
Nil ++ ys = ys
cons x xs ++ ys = cons x (xs ++ ys)
-}
```

**Exercise 6:** Define the map function.

**Exercise 7:** Define the transpose function. It takes a list of lists considered as a matrix and returns a list of lists which represents the transposed matrix.

# Tuples and Sigma-types

Given two types A and B, one can construct the type \Sigma A B of pairs (a, b), where a : A and b : B. The type \Sigma A B is equivalent to the data type defined as follows:

`\data Pair | pair A B`

More generally, for any family of types A1, …, An one can form the type \Sigma A1 … An of tuples (a1, …, an), where ai : Ai. A trivial example – the type \Sigma, which is equivalemt to the one-element type Unit.

The tuples can be dependent in the sense that Ai can depend on a1, …, a{i-1}. Let us give a few examples of dependent \Sigma-types:

- The type \Sigma (A : \Type) (A -> A) consists of pairs (A,f), where A is a type and f is a function of type A -> A.
- The type \Sigma (b : Bool) (if b Nat Bool) consists of pairs (b,e), where b is a boolean value and the type of e is if b Nat Bool. In particular, pairs (true,7) and (false,true) belong to this type, but pairs (false,7) and (true,true) do not.
- We will see that, for every pair of natural numbers n,m : Nat, there is a type n < m of proofs that one of them is less than the other. Then we can define the type \Sigma (n : Nat) (n <= 10) which consists of natural numbers less than 10. To be more precise, it consists of pairs (n,p), where n is a natural number and p is a proof that it less than 10.
- More interesting example – the type \Sigma (n : Nat) (\Sigma (k : Nat) (n = k * k)) of natural numbers n that are full squares: its elements are pairs (n, p), where n is a natural number and p : \Sigma (k : Nat) (n = k * k) is a proof that n is a square.

If x is an element of type \Sigma A1 … An, i-th component of x, where i is a numeral, can be accessed by the projection operator x.i. Note that eta equivalence holds for Sigma-types: if x : \Sigma A1… An, then (x.1, …, x.n) is computationally equal to x.

# Type synonyms

There is no need for type synonyms in dependently types language since we can simply define a function returning the type, synonym of which is being defined:

```
\func NatList => List Nat
{- Haskell:
type NatList = List Nat
-}
```

# Namespaces and modules

Each definition can be accompanied by \where block in the end. In contrast to Haskell, \where block is attached to the whole definition, not to a particular clause:

`\func f => g \where \func g => 0`

Definitions in \where block in almost all respects behave just as normal definitions. The only difference is that it has different namespace:

`\func gTest => f.g`

Alternatively, one can use \let, which is, however, limited and simpler than ‘let’ in Haskell. In Arend, \let cannot contain recursive functions and each variable can only depend on previous variables:

```
\func letExample => \let
| x => 1
| y => x + x
\in x + y * y
```

Definitions in Arend can be grouped in *modules*:

```
\module M1 \where {
\func f => 82
\func g => 77
\func h => 25
}
-- definitions f, g and h are unavailable in the current namespace
-- they should be accessed with the prefix M1.
\func moduleTest => (M1.f,M1.g,M1.h)
```

If a module is opened by the \open command, then its definitions can be accessed directly without the prefix:

```
\module M2 \where {
\open M1
\func t => f
\func t' => g
\func t'' => h
}
```

It is possible to open just some particular definitions in a module:

```
\module M3 \where {
\open M1(f,g)
\func t => f
\func t' => g
\func t'' => M1.h -- h is not opened and must be accessed with prefix
}
```

For every definition there is a corresponding module:

```
\module M4 \where {
\func functionModule => 34
\where {
\func f1 => 42
\func f2 => 61
\func f3 => 29
}
\func t => functionModule.f1
\func t' => functionModule.f2
\func t'' => (f1, f3)
\where \open functionModule(f1,f3)
-- this \open affects everything in \where-block for t''as well as t''
}
```

In case there are clashes between names of definitions in different modules, these definitions can be either hidden or renamed:

```
\module M5 \where {
\open M2 \hiding (t') -- open all definitions except for t'
\open M3 (t \as M3_t) -- open just t and rename it to M3_t
\open M4 \using (t \as M4_t) -- open all definition and rename t to M4_t
\func t'' => (M3_t, M4_t, t', t, functionModule, functionModule.f1, functionModule.f2, functionModule.f3)
\func t''' => (t'', M2.t'', M4.t'')
-- t'' in the current module clashes with t'' from M2 and M4,
-- the latter definitions should be accessed with prefix
}
```

The command \import X makes file X visible in the current file. Moreover, \import does everything that \open does, all the constructs for \open are applicable to \import as well:

```
-- The sources directory should contain a file named Test.ard (which contains definitions foobar and foobar2)
-- and a directory named TestDir with files Test.ard and Test2.ard in it.
\import Test (foobar \as foobar', foobar2)
\import TestDir.Test
-- if you want to make file visible, but do not want to make \open, you can write the fllowing:
\import TestDir.Test2()
```