		Search-engine friendly clone of the ACL2 documentation.

Integer-operations

Uint-sub

Subtraction of unsigned integer values.

Signature
(uint-sub 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-sub

(defun uint-sub (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-sub

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

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

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

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

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

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

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

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

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