Additional properties of binary recursion on Nat

This file documents additional properties of binary recursion, which allows us to more easily work with operations which do depend on the number of leading zeros in the binary representation of n. For example, we can more easily work with Nat.bits and Nat.size.

See also: Nat.bitwise, Nat.pow (for various lemmas about size and shiftLeft/shiftRight), and Nat.digits.

def Nat.boddDiv2 : ℕ → Bool × ℕ

boddDiv2 n returns a 2-tuple of type (Bool, Nat) where the Bool value indicates whether n is odd or not and the Nat value returns ⌊n/2⌋

Equations

• Nat.boddDiv2 0 = (false, 0)
• n.succ.boddDiv2 = match n.boddDiv2 with | (false, m) => (true, m) | (true, m) => (false, m.succ)

def Nat.div2 (n : ℕ) : ℕ

div2 n = ⌊n/2⌋ the greatest integer smaller than n/2

Equations

• n.div2 = n.boddDiv2.2

def Nat.bodd (n : ℕ) : Bool

bodd n returns true if n is odd

Equations

• n.bodd = n.boddDiv2.1

@[simp]

theorem Nat.bodd_zero : Nat.bodd 0 = false

theorem Nat.bodd_one : Nat.bodd 1 = true

theorem Nat.bodd_two : Nat.bodd 2 = false

@[simp]

theorem Nat.bodd_succ (n : ℕ) : n.succ.bodd = !n.bodd

@[simp]

theorem Nat.bodd_add (m : ℕ) (n : ℕ) : (m + n).bodd = xor m.bodd n.bodd

@[simp]

theorem Nat.bodd_mul (m : ℕ) (n : ℕ) : (m * n).bodd = (m.bodd && n.bodd)

theorem Nat.mod_two_of_bodd (n : ℕ) : n % 2 = bif n.bodd then 1 else 0

@[simp]

theorem Nat.div2_zero : Nat.div2 0 = 0

theorem Nat.div2_one : Nat.div2 1 = 0

theorem Nat.div2_two : Nat.div2 2 = 1

@[simp]

theorem Nat.div2_succ (n : ℕ) : n.succ.div2 = bif n.bodd then n.div2.succ else n.div2

theorem Nat.bodd_add_div2 (n : ℕ) : (bif n.bodd then 1 else 0) + 2 * n.div2 = n

theorem Nat.div2_val (n : ℕ) : n.div2 = n / 2

def Nat.bit (b : Bool) : ℕ → ℕ

bit b appends the digit b to the binary representation of its natural number input.

Equations

• Nat.bit b = bif b then fun (x : ℕ) => 2 * x + 1 else fun (x : ℕ) => 2 * x

theorem Nat.bit_val (b : Bool) (n : ℕ) : Nat.bit b n = 2 * n + bif b then 1 else 0

theorem Nat.bit_decomp (n : ℕ) : Nat.bit n.bodd n.div2 = n

def Nat.bitCasesOn {C : ℕ → Sort u} (n : ℕ) (h : (b : Bool) → (n : ℕ) → C (Nat.bit b n)) : C n

For a predicate C : Nat → Sort*, if instances can be constructed for natural numbers of the form bit b n, they can be constructed for any given natural number.

Equations

• n.bitCasesOn h = ⋯ ▸ h n.bodd n.div2

theorem Nat.bit_zero : Nat.bit false 0 = 0

def Nat.shiftLeft' (b : Bool) (m : ℕ) : ℕ → ℕ

shiftLeft' b m n performs a left shift of m n times and adds the bit b as the least significant bit each time. Returns the corresponding natural number

Equations

• Nat.shiftLeft' b m 0 = m
• Nat.shiftLeft' b m n.succ = Nat.bit b (Nat.shiftLeft' b m n)

@[simp]

theorem Nat.shiftLeft'_false {m : ℕ} (n : ℕ) : Nat.shiftLeft' false m n = m <<< n

@[simp]

theorem Nat.shiftLeft_eq' (m : ℕ) (n : ℕ) : m.shiftLeft n = m <<< n

Lean takes the unprimed name for Nat.shiftLeft_eq m n : m <<< n = m * 2 ^ n.

@[simp]

theorem Nat.shiftRight_eq (m : ℕ) (n : ℕ) : m.shiftRight n = m >>> n

theorem Nat.binaryRec_decreasing {n : ℕ} (h : n ≠ 0) : n.div2 < n

@[irreducible]

def Nat.binaryRec {C : ℕ → Sort u} (z : C 0) (f : (b : Bool) → (n : ℕ) → C n → C (Nat.bit b n)) (n : ℕ) : C n

A recursion principle for bit representations of natural numbers. For a predicate C : Nat → Sort*, if instances can be constructed for natural numbers of the form bit b n, they can be constructed for all natural numbers.

Equations

• Nat.binaryRec z f n = if n0 : n = 0 then ⋯.mpr z else let n' := n.div2; let_fun _x := ⋯; ⋯.mpr (f n.bodd n' (Nat.binaryRec z f n'))

def Nat.size : ℕ → ℕ

size n : Returns the size of a natural number in bits i.e. the length of its binary representation

Equations

• Nat.size = Nat.binaryRec 0 fun (x : Bool) (x : ℕ) => Nat.succ

def Nat.bits : ℕ → List Bool

bits n returns a list of Bools which correspond to the binary representation of n, where the head of the list represents the least significant bit

Equations

• Nat.bits = Nat.binaryRec [] fun (b : Bool) (x : ℕ) (IH : List Bool) => b :: IH

def Nat.ldiff : ℕ → ℕ → ℕ

ldiff a b performs bitwise set difference. For each corresponding pair of bits taken as booleans, say aᵢ and bᵢ, it applies the boolean operation aᵢ ∧ ¬bᵢ to obtain the iᵗʰ bit of the result.

Equations

• Nat.ldiff = Nat.bitwise fun (a b : Bool) => a && !b

@[simp]

theorem Nat.binaryRec_zero {C : ℕ → Sort u} (z : C 0) (f : (b : Bool) → (n : ℕ) → C n → C (Nat.bit b n)) : Nat.binaryRec z f 0 = z

bitwise ops

theorem Nat.bodd_bit (b : Bool) (n : ℕ) : (Nat.bit b n).bodd = b

theorem Nat.div2_bit (b : Bool) (n : ℕ) : (Nat.bit b n).div2 = n

theorem Nat.shiftLeft'_add (b : Bool) (m : ℕ) (n : ℕ) (k : ℕ) : Nat.shiftLeft' b m (n + k) = Nat.shiftLeft' b (Nat.shiftLeft' b m n) k

theorem Nat.shiftLeft'_sub (b : Bool) (m : ℕ) {n : ℕ} {k : ℕ} : k ≤ n → Nat.shiftLeft' b m (n - k) = Nat.shiftLeft' b m n >>> k

theorem Nat.shiftLeft_sub (m : ℕ) {n : ℕ} {k : ℕ} : k ≤ n → m <<< (n - k) = m <<< n >>> k

theorem Nat.testBit_bit_zero (b : Bool) (n : ℕ) : (Nat.bit b n).testBit 0 = b

theorem Nat.bodd_eq_one_and_ne_zero (n : ℕ) : n.bodd = (1 &&& n != 0)

theorem Nat.testBit_bit_succ (m : ℕ) (b : Bool) (n : ℕ) : (Nat.bit b n).testBit m.succ = n.testBit m

theorem Nat.binaryRec_eq {C : ℕ → Sort u} {z : C 0} {f : (b : Bool) → (n : ℕ) → C n → C (Nat.bit b n)} (h : f false 0 z = z) (b : Bool) (n : ℕ) : Nat.binaryRec z f (Nat.bit b n) = f b n (Nat.binaryRec z f n)

boddDiv2_eq and bodd

@[simp]

theorem Nat.boddDiv2_eq (n : ℕ) : n.boddDiv2 = (n.bodd, n.div2)

@[simp]

theorem Nat.div2_bit0 (n : ℕ) : (2 * n).div2 = n

theorem Nat.div2_bit1 (n : ℕ) : (2 * n + 1).div2 = n

bit0 and bit1

theorem Nat.bit_add (b : Bool) (n : ℕ) (m : ℕ) : Nat.bit b (n + m) = Nat.bit false n + Nat.bit b m

theorem Nat.bit_add' (b : Bool) (n : ℕ) (m : ℕ) : Nat.bit b (n + m) = Nat.bit b n + Nat.bit false m

theorem Nat.bit_ne_zero (b : Bool) {n : ℕ} (h : n ≠ 0) : Nat.bit b n ≠ 0

@[simp]

theorem Nat.bitCasesOn_bit {C : ℕ → Sort u} (H : (b : Bool) → (n : ℕ) → C (Nat.bit b n)) (b : Bool) (n : ℕ) : (Nat.bit b n).bitCasesOn H = H b n

@[simp]

theorem Nat.bitCasesOn_bit0 {C : ℕ → Sort u} (H : (b : Bool) → (n : ℕ) → C (Nat.bit b n)) (n : ℕ) : (2 * n).bitCasesOn H = H false n

@[simp]

theorem Nat.bitCasesOn_bit1 {C : ℕ → Sort u} (H : (b : Bool) → (n : ℕ) → C (Nat.bit b n)) (n : ℕ) : (2 * n + 1).bitCasesOn H = H true n

theorem Nat.bit_cases_on_injective {C : ℕ → Sort u} : Function.Injective fun (H : (b : Bool) → (n : ℕ) → C (Nat.bit b n)) (n : ℕ) => n.bitCasesOn H

@[simp]

theorem Nat.bit_cases_on_inj {C : ℕ → Sort u} (H₁ : (b : Bool) → (n : ℕ) → C (Nat.bit b n)) (H₂ : (b : Bool) → (n : ℕ) → C (Nat.bit b n)) : ((fun (n : ℕ) => n.bitCasesOn H₁) = fun (n : ℕ) => n.bitCasesOn H₂) ↔ H₁ = H₂

theorem Nat.bit_eq_zero_iff {n : ℕ} {b : Bool} : Nat.bit b n = 0 ↔ n = 0 ∧ b = false

theorem Nat.bit_le (b : Bool) {m : ℕ} {n : ℕ} : m ≤ n → Nat.bit b m ≤ Nat.bit b n

theorem Nat.bit_lt_bit {m : ℕ} {n : ℕ} (a : Bool) (b : Bool) (h : m < n) : Nat.bit a m < Nat.bit b n

theorem Nat.binaryRec_eq' {C : ℕ → Sort u_1} {z : C 0} {f : (b : Bool) → (n : ℕ) → C n → C (Nat.bit b n)} (b : Bool) (n : ℕ) (h : f false 0 z = z ∨ (n = 0 → b = true)) : Nat.binaryRec z f (Nat.bit b n) = f b n (Nat.binaryRec z f n)

The same as binaryRec_eq, but that one unfortunately requires f to be the identity when appending false to 0. Here, we allow you to explicitly say that that case is not happening, i.e. supplying n = 0 → b = true.

def Nat.binaryRec' {C : ℕ → Sort u_1} (z : C 0) (f : (b : Bool) → (n : ℕ) → (n = 0 → b = true) → C n → C (Nat.bit b n)) (n : ℕ) : C n

The same as binaryRec, but the induction step can assume that if n=0, the bit being appended is true

Equations

• Nat.binaryRec' z f = Nat.binaryRec z fun (b : Bool) (n : ℕ) (ih : C n) => if h : n = 0 → b = true then f b n h ih else ⋯.mpr z

def Nat.binaryRecFromOne {C : ℕ → Sort u_1} (z₀ : C 0) (z₁ : C 1) (f : (b : Bool) → (n : ℕ) → n ≠ 0 → C n → C (Nat.bit b n)) (n : ℕ) : C n

The same as binaryRec, but special casing both 0 and 1 as base cases

Equations

• Nat.binaryRecFromOne z₀ z₁ f n = Nat.binaryRec' z₀ (fun (b : Bool) (n : ℕ) (h : n = 0 → b = true) (ih : C n) => if h' : n = 0 then ⋯.mpr (⋯.mpr z₁) else f b n h' ih) n

@[simp]

theorem Nat.zero_bits : Nat.bits 0 = []

@[simp]

theorem Nat.bits_append_bit (n : ℕ) (b : Bool) (hn : n = 0 → b = true) : (Nat.bit b n).bits = b :: n.bits

@[simp]

theorem Nat.bit0_bits (n : ℕ) (hn : n ≠ 0) : (2 * n).bits = false :: n.bits

@[simp]

theorem Nat.bit1_bits (n : ℕ) : (2 * n + 1).bits = true :: n.bits

@[simp]

theorem Nat.one_bits : Nat.bits 1 = [true]

theorem Nat.bodd_eq_bits_head (n : ℕ) : n.bodd = n.bits.headI

theorem Nat.div2_bits_eq_tail (n : ℕ) : n.div2.bits = n.bits.tail