Operation on tuples #
We interpret maps ∀ i : Fin n, α i as n-tuples of elements of possibly varying type α i,
(α 0, …, α (n-1)). A particular case is Fin n → α of elements with all the same type.
In this case when α i is a constant map, then tuples are isomorphic (but not definitionally equal)
to Vectors.
Main declarations #
There are three (main) ways to consider Fin n as a subtype of Fin (n + 1), hence three (main)
ways to move between tuples of length n and of length n + 1 by adding/removing an entry.
Adding at the start #
Fin.succ: Sendi : Fin ntoi + 1 : Fin (n + 1). This is defined in Core.Fin.cases: Induction/recursion principle forFin: To prove a property/define a function for allFin (n + 1), it is enough to prove/define it for0and fori.succfor alli : Fin n. This is defined in Core.Fin.cons: Turn a tuplef : Fin n → αand an entrya : αinto a tupleFin.cons a f : Fin (n + 1) → αby addingaat the start. In general, tuples can be dependent functions, in which casef : ∀ i : Fin n, α i.succanda : α 0. This is a special case ofFin.cases.Fin.tail: Turn a tuplef : Fin (n + 1) → αinto a tupleFin.tail f : Fin n → αby forgetting the start. In general, tuples can be dependent functions, in which caseFin.tail f : ∀ i : Fin n, α i.succ.
Adding at the end #
Fin.castSucc: Sendi : Fin ntoi : Fin (n + 1). This is defined in Core.Fin.lastCases: Induction/recursion principle forFin: To prove a property/define a function for allFin (n + 1), it is enough to prove/define it forlast nand fori.castSuccfor alli : Fin n. This is defined in Core.Fin.snoc: Turn a tuplef : Fin n → αand an entrya : αinto a tupleFin.snoc f a : Fin (n + 1) → αby addingaat the end. In general, tuples can be dependent functions, in which casef : ∀ i : Fin n, α i.castSuccanda : α (last n). This is a special case ofFin.lastCases.Fin.init: Turn a tuplef : Fin (n + 1) → αinto a tupleFin.init f : Fin n → αby forgetting the end. In general, tuples can be dependent functions, in which caseFin.init f : ∀ i : Fin n, α i.castSucc.
Adding in the middle #
For a pivot p : Fin (n + 1),
Fin.succAbove: Sendi : Fin ntoFin.succAboveCases: Induction/recursion principle forFin: To prove a property/define a function for allFin (n + 1), it is enough to prove/define it forpand forp.succAbove ifor alli : Fin n.Fin.insertNth: Turn a tuplef : Fin n → αand an entrya : αinto a tupleFin.insertNth f a : Fin (n + 1) → αby addingain positionp. In general, tuples can be dependent functions, in which casef : ∀ i : Fin n, α (p.succAbove i)anda : α p. This is a special case ofFin.succAboveCases.Fin.removeNth: Turn a tuplef : Fin (n + 1) → αinto a tupleFin.removeNth p f : Fin n → αby forgetting thep-th value. In general, tuples can be dependent functions, in which caseFin.removeNth f : ∀ i : Fin n, α (succAbove p i).
p = 0 means we add at the start. p = last n means we add at the end.
Miscellaneous #
Fin.find p: returns the first indexnwherep nis satisfied, andnoneif it is never satisfied.Fin.append a b: append two tuples.Fin.repeat n a: repeat a tuplentimes.
As a binary function, Fin.cons is injective.
Equivalence between tuples of length n + 1 and pairs of an element and a tuple of length n
given by separating out the first element of the tuple.
Equations
Instances For
Variant of append_left using Fin.castLE instead of Fin.castAdd.
In the previous section, we have discussed inserting or removing elements on the left of a
tuple. In this section, we do the same on the right. A difference is that Fin (n+1) is constructed
inductively from Fin n starting from the left, not from the right. This implies that Lean needs
more help to realize that elements belong to the right types, i.e., we need to insert casts at
several places.
Adding an element at the end of an n-tuple, to get an n+1-tuple. The name snoc comes from
cons (i.e., adding an element to the left of a tuple) read in reverse order.
Equations
Instances For
As a binary function, Fin.snoc is injective.
Equivalence between tuples of length n + 1 and pairs of an element and a tuple of length n
given by separating out the last element of the tuple.
Equations
Instances For
Recurse on an n+1-tuple by splitting it its initial n-tuple and its last element.
Equations
Instances For
Define a function on Fin (n + 1) from a value on i : Fin (n + 1) and values on each
Fin.succAbove i j, j : Fin n. This version is elaborated as eliminator and works for
propositions, see also Fin.insertNth for a version without an @[elab_as_elim]
attribute.
Equations
Instances For
A finite sequence of properties P holds for {0 , ... , m + n - 1} iff it holds separately for both {0 , ... , m - 1} and {m, ..., m + n - 1}.
Insert an element into a tuple at a given position. For i = 0 see Fin.cons,
for i = Fin.last n see Fin.snoc. See also Fin.succAboveCases for a version elaborated
as an eliminator.
Equations
Instances For
As a binary function, Fin.insertNth is injective.
Equivalence between tuples of length n + 1 and pairs of an element and a tuple of length n
given by separating out the p-th element of the tuple.
This is Fin.insertNth as an Equiv.
Equations
Instances For
Given an (n + 2)-tuple m and two indexes i : Fin (n + 1) and j : Fin (n + 2),
one can remove jth element from m, then remove ith element from the result,
or one can remove (j.succAbove i)th element from m,
then remove (i.predAbove j)th element from the result.
These two operations correspond to removing the same two elements in a different order,
so they result in the same n-tuple.
If find p = some i, then p i holds