		Search-engine friendly clone of the ACL2 documentation.

Integer-operations

Uint-add

Addition of unsigned integer values.

Signature
(uint-add left-operand right-operand) → result
Arguments: left-operand — Guard (uintp left-operand).; right-operand — Guard (uintp right-operand).
Returns: result — Type (uintp result).

Definitions and Theorems

Function: uint-add

(defun uint-add (left-operand right-operand)
  (declare (xargs :guard (and (uintp left-operand)
                              (uintp right-operand))))
  (b* ((size (uint->size left-operand))
       (x (uint->value left-operand))
       (y (uint->value right-operand)))
    (make-uint :size (uint->size left-operand)
               :value (loghead size (+ x y)))))

Theorem: uintp-of-uint-add

(defthm uintp-of-uint-add
  (b* ((result (uint-add left-operand right-operand)))
    (uintp result))
  :rule-classes :rewrite)

Theorem: uint-add-of-uint-fix-left-operand

(defthm uint-add-of-uint-fix-left-operand
  (equal (uint-add (uint-fix left-operand)
                   right-operand)
         (uint-add left-operand right-operand)))

Theorem: uint-add-uint-equiv-congruence-on-left-operand

(defthm uint-add-uint-equiv-congruence-on-left-operand
  (implies (uint-equiv left-operand left-operand-equiv)
           (equal (uint-add left-operand right-operand)
                  (uint-add left-operand-equiv right-operand)))
  :rule-classes :congruence)

Theorem: uint-add-of-uint-fix-right-operand

(defthm uint-add-of-uint-fix-right-operand
  (equal (uint-add left-operand (uint-fix right-operand))
         (uint-add left-operand right-operand)))

Theorem: uint-add-uint-equiv-congruence-on-right-operand

(defthm uint-add-uint-equiv-congruence-on-right-operand
  (implies (uint-equiv right-operand right-operand-equiv)
           (equal (uint-add left-operand right-operand)
                  (uint-add left-operand right-operand-equiv)))
  :rule-classes :congruence)