		Search-engine friendly clone of the ACL2 documentation.

Vl-expr-expandsizes

Vl-weirdint-atom-expandsizes

Propagate the final width and type of an expression into a weird integer atom.

Signature
(vl-weirdint-atom-expandsizes x finalwidth finaltype ctx warnings) → (mv successp warnings new-x)
Arguments: x — Guard (vl-expr-p x).; finalwidth — Guard (natp finalwidth).; finaltype — Guard (vl-exprtype-p finaltype).; ctx — Guard (vl-context-p ctx).; warnings — Guard (vl-warninglist-p warnings).
Returns: successp — Type (booleanp successp).; warnings — Type (vl-warninglist-p warnings).; new-x — Type (vl-expr-p new-x).

Definitions and Theorems

Function: vl-weirdint-atom-expandsizes

(defun vl-weirdint-atom-expandsizes
       (x finalwidth finaltype ctx warnings)
 (declare (xargs :guard (and (vl-expr-p x)
                             (natp finalwidth)
                             (vl-exprtype-p finaltype)
                             (vl-context-p ctx)
                             (vl-warninglist-p warnings))))
 (declare
      (xargs :guard (and (vl-atom-p x)
                         (vl-fast-weirdint-p (vl-atom->guts x)))))
 (let ((__function__ 'vl-weirdint-atom-expandsizes))
  (declare (ignorable __function__))
  (b*
   ((x (vl-expr-fix x))
    (guts (vl-atom->guts x))
    (finalwidth (lnfix finalwidth))
    (finaltype (vl-exprtype-fix finaltype))
    (ctx (vl-context-fix ctx))
    ((vl-weirdint guts) guts)
    ((when (> guts.origwidth finalwidth))
     (mv
      nil
      (fatal
       :type :vl-programming-error
       :msg
       "~a0: origwidth > finalwidth when expanding ~a1. This ~
                         indicates a serious bug in our sizing code."
       :args (list ctx x))
      x))
    ((unless (or (eq guts.origtype finaltype)
                 (and (eq guts.origtype :vl-signed)
                      (eq finaltype :vl-unsigned))))
     (mv
      nil
      (fatal
       :type :vl-programming-error
       :msg
       "~a0: origtype is ~s1 but finaltype is ~s2 when ~
                         expanding ~a3.  This indicates a serious bug in our ~
                         typing code."
       :args (list ctx guts.origtype finaltype x))
      x))
    ((when (= guts.origwidth finalwidth))
     (b* ((new-guts (if (eq guts.origtype finaltype)
                        guts
                      (change-vl-weirdint guts
                                          :origwidth finalwidth
                                          :origtype finaltype)))
          (new-x (change-vl-atom x
                                 :guts new-guts
                                 :finalwidth finalwidth
                                 :finaltype finaltype)))
       (mv t (ok) new-x)))
    ((when (eq finaltype :vl-unsigned))
     (b* ((new-bits (append (replicate (- finalwidth guts.origwidth)
                                       :vl-0val)
                            (list-fix guts.bits)))
          (new-guts (change-vl-weirdint guts
                                        :bits new-bits
                                        :origwidth finalwidth
                                        :origtype finaltype))
          (new-x (change-vl-atom x
                                 :guts new-guts
                                 :finalwidth finalwidth
                                 :finaltype finaltype)))
       (mv t (ok) new-x)))
    (sign-bit (car guts.bits))
    (new-bits (append (replicate (- finalwidth guts.origwidth)
                                 sign-bit)
                      (list-fix guts.bits)))
    (new-guts (change-vl-weirdint guts
                                  :bits new-bits
                                  :origwidth finalwidth))
    (new-x (change-vl-atom x
                           :guts new-guts
                           :finalwidth finalwidth
                           :finaltype finaltype))
    ((unless guts.wasunsized)
     (mv t (ok) new-x))
    (minorp (eq sign-bit :vl-0val))
    (warnings
     (warn
      :type
      (if minorp :vl-warn-integer-size-minor
        :vl-warn-integer-size)
      :msg
      (if minorp
       "~a0: the unsized integer ~a1 occurs in a context that ~
                        is larger than 32-bits.  In rare cases (particularly ~
                        involving right-shifts), the resulting expression may ~
                        produce different results on Verilog implementations ~
                        with different integer sizes; consider adding an ~
                        explicit size to this number."
       "~a0: the unsized integer ~a1 occurs in a signed context ~
                      that is larger than 32-bits; it is likely that this ~
                      could cause the expression results to differ between ~
                      Verilog implementations that have different integer ~
                      sizes.  Adding an explicit size to this number is ~
                      recommended.")
      :args (list ctx x))))
   (mv t warnings new-x))))

Theorem: booleanp-of-vl-weirdint-atom-expandsizes.successp

(defthm booleanp-of-vl-weirdint-atom-expandsizes.successp
  (b* (((mv ?successp ?warnings ?new-x)
        (vl-weirdint-atom-expandsizes
             x finalwidth finaltype ctx warnings)))
    (booleanp successp))
  :rule-classes :type-prescription)

Theorem: vl-warninglist-p-of-vl-weirdint-atom-expandsizes.warnings

(defthm vl-warninglist-p-of-vl-weirdint-atom-expandsizes.warnings
  (b* (((mv ?successp ?warnings ?new-x)
        (vl-weirdint-atom-expandsizes
             x finalwidth finaltype ctx warnings)))
    (vl-warninglist-p warnings))
  :rule-classes :rewrite)

Theorem: vl-expr-p-of-vl-weirdint-atom-expandsizes.new-x

(defthm vl-expr-p-of-vl-weirdint-atom-expandsizes.new-x
  (b* (((mv ?successp ?warnings ?new-x)
        (vl-weirdint-atom-expandsizes
             x finalwidth finaltype ctx warnings)))
    (vl-expr-p new-x))
  :rule-classes :rewrite)

Theorem: warning-irrelevance-of-vl-weirdint-atom-expandsizes

(defthm warning-irrelevance-of-vl-weirdint-atom-expandsizes
 (let
  ((ret1 (vl-weirdint-atom-expandsizes
              x finalwidth finaltype ctx warnings))
   (ret2
     (vl-weirdint-atom-expandsizes x finalwidth finaltype nil nil)))
  (implies (syntaxp (not (and (equal ctx ''nil)
                              (equal warnings ''nil))))
           (and (equal (mv-nth 0 ret1) (mv-nth 0 ret2))
                (equal (mv-nth 2 ret1)
                       (mv-nth 2 ret2))))))

Theorem: no-change-loserp-of-vl-weirdint-atom-expandsizes

(defthm no-change-loserp-of-vl-weirdint-atom-expandsizes
  (let ((ret (vl-weirdint-atom-expandsizes
                  x finalwidth finaltype ctx warnings)))
    (implies (not (mv-nth 0 ret))
             (equal (mv-nth 2 ret)
                    (vl-expr-fix x)))))

Theorem: vl-expr-welltyped-p-of-vl-weirdint-atom-expandsizes

(defthm vl-expr-welltyped-p-of-vl-weirdint-atom-expandsizes
  (let ((ret (vl-weirdint-atom-expandsizes
                  x finalwidth finaltype ctx warnings)))
    (implies (and (mv-nth 0 ret)
                  (force (vl-atom-p x))
                  (force (vl-weirdint-p (vl-atom->guts x))))
             (vl-expr-welltyped-p (mv-nth 2 ret)))))

Theorem: vl-expr->finalwidth-of-vl-weirdint-atom-expandsizes

(defthm vl-expr->finalwidth-of-vl-weirdint-atom-expandsizes
  (let ((ret (vl-weirdint-atom-expandsizes
                  x finalwidth finaltype ctx warnings)))
    (implies (and (mv-nth 0 ret)
                  (force (vl-atom-p x))
                  (force (vl-weirdint-p (vl-atom->guts x))))
             (equal (vl-expr->finalwidth (mv-nth 2 ret))
                    (lnfix finalwidth)))))

Theorem: vl-expr->finaltype-of-vl-weirdint-atom-expandsizes

(defthm vl-expr->finaltype-of-vl-weirdint-atom-expandsizes
  (let ((ret (vl-weirdint-atom-expandsizes
                  x finalwidth finaltype ctx warnings)))
    (implies (and (mv-nth 0 ret)
                  (force (vl-atom-p x))
                  (force (vl-weirdint-p (vl-atom->guts x))))
             (equal (vl-expr->finaltype (mv-nth 2 ret))
                    (vl-exprtype-fix finaltype)))))

Theorem: vl-weirdint-atom-expandsizes-of-vl-expr-fix-x

(defthm vl-weirdint-atom-expandsizes-of-vl-expr-fix-x
 (equal
    (vl-weirdint-atom-expandsizes (vl-expr-fix x)
                                  finalwidth finaltype ctx warnings)
    (vl-weirdint-atom-expandsizes
         x finalwidth finaltype ctx warnings)))

Theorem: vl-weirdint-atom-expandsizes-vl-expr-equiv-congruence-on-x

(defthm vl-weirdint-atom-expandsizes-vl-expr-equiv-congruence-on-x
  (implies (vl-expr-equiv x x-equiv)
           (equal (vl-weirdint-atom-expandsizes
                       x finalwidth finaltype ctx warnings)
                  (vl-weirdint-atom-expandsizes
                       x-equiv
                       finalwidth finaltype ctx warnings)))
  :rule-classes :congruence)

Theorem: vl-weirdint-atom-expandsizes-of-nfix-finalwidth

(defthm vl-weirdint-atom-expandsizes-of-nfix-finalwidth
  (equal (vl-weirdint-atom-expandsizes x (nfix finalwidth)
                                       finaltype ctx warnings)
         (vl-weirdint-atom-expandsizes
              x finalwidth finaltype ctx warnings)))

Theorem: vl-weirdint-atom-expandsizes-nat-equiv-congruence-on-finalwidth

(defthm
    vl-weirdint-atom-expandsizes-nat-equiv-congruence-on-finalwidth
 (implies
      (acl2::nat-equiv finalwidth finalwidth-equiv)
      (equal (vl-weirdint-atom-expandsizes
                  x finalwidth finaltype ctx warnings)
             (vl-weirdint-atom-expandsizes x finalwidth-equiv
                                           finaltype ctx warnings)))
 :rule-classes :congruence)

Theorem: vl-weirdint-atom-expandsizes-of-vl-exprtype-fix-finaltype

(defthm vl-weirdint-atom-expandsizes-of-vl-exprtype-fix-finaltype
  (equal (vl-weirdint-atom-expandsizes
              x finalwidth (vl-exprtype-fix finaltype)
              ctx warnings)
         (vl-weirdint-atom-expandsizes
              x finalwidth finaltype ctx warnings)))

Theorem: vl-weirdint-atom-expandsizes-vl-exprtype-equiv-congruence-on-finaltype

(defthm
 vl-weirdint-atom-expandsizes-vl-exprtype-equiv-congruence-on-finaltype
 (implies
  (vl-exprtype-equiv finaltype finaltype-equiv)
  (equal
       (vl-weirdint-atom-expandsizes
            x finalwidth finaltype ctx warnings)
       (vl-weirdint-atom-expandsizes x finalwidth
                                     finaltype-equiv ctx warnings)))
 :rule-classes :congruence)

Theorem: vl-weirdint-atom-expandsizes-of-vl-context-fix-ctx

(defthm vl-weirdint-atom-expandsizes-of-vl-context-fix-ctx
 (equal (vl-weirdint-atom-expandsizes x finalwidth
                                      finaltype (vl-context-fix ctx)
                                      warnings)
        (vl-weirdint-atom-expandsizes
             x finalwidth finaltype ctx warnings)))

Theorem: vl-weirdint-atom-expandsizes-vl-context-equiv-congruence-on-ctx

(defthm
    vl-weirdint-atom-expandsizes-vl-context-equiv-congruence-on-ctx
 (implies
  (vl-context-equiv ctx ctx-equiv)
  (equal
       (vl-weirdint-atom-expandsizes
            x finalwidth finaltype ctx warnings)
       (vl-weirdint-atom-expandsizes x finalwidth
                                     finaltype ctx-equiv warnings)))
 :rule-classes :congruence)

Theorem: vl-weirdint-atom-expandsizes-of-vl-warninglist-fix-warnings

(defthm vl-weirdint-atom-expandsizes-of-vl-warninglist-fix-warnings
 (equal
    (vl-weirdint-atom-expandsizes x finalwidth finaltype
                                  ctx (vl-warninglist-fix warnings))
    (vl-weirdint-atom-expandsizes
         x finalwidth finaltype ctx warnings)))

Theorem: vl-weirdint-atom-expandsizes-vl-warninglist-equiv-congruence-on-warnings

(defthm
 vl-weirdint-atom-expandsizes-vl-warninglist-equiv-congruence-on-warnings
 (implies
  (vl-warninglist-equiv warnings warnings-equiv)
  (equal
       (vl-weirdint-atom-expandsizes
            x finalwidth finaltype ctx warnings)
       (vl-weirdint-atom-expandsizes x finalwidth
                                     finaltype ctx warnings-equiv)))
 :rule-classes :congruence)