		Search-engine friendly clone of the ACL2 documentation.

Replicate-insts

Vl-module-replicate

Eliminate gate and module instance arrays from a module.

Signature
(vl-module-replicate x ss) → new-x
Arguments: x — Module to simplify.
Guard (vl-module-p x).; ss — Guard (vl-scopestack-p ss).
Returns: new-x — Rewritten version of X, where any gate or module instance arrays have been replaced by an explicit list of instances.
Type (vl-module-p new-x).

Definitions and Theorems

Function: vl-module-replicate

(defun vl-module-replicate (x ss)
  (declare (xargs :guard (and (vl-module-p x)
                              (vl-scopestack-p ss))))
  (let ((__function__ 'vl-module-replicate))
    (declare (ignorable __function__))
    (b* ((x (vl-module-fix x))
         ((when (vl-module->hands-offp x)) x)
         (ss (vl-scopestack-push x ss))
         ((vl-module x) x)
         ((unless (or (vl-some-gateinst-array-p x.gateinsts)
                      (vl-some-modinst-array-p x.modinsts)))
          x)
         (nf (vl-starting-namefactory x))
         (warnings x.warnings)
         ((mv warnings new-gateinsts nf)
          (vl-replicate-gateinstlist x.gateinsts nf ss warnings))
         ((mv warnings new-modinsts nf)
          (vl-replicate-modinstlist x.modinsts nf ss warnings))
         (- (vl-free-namefactory nf))
         (x-prime (change-vl-module x
                                    :modinsts new-modinsts
                                    :gateinsts new-gateinsts
                                    :warnings warnings)))
      x-prime)))

Theorem: vl-module-p-of-vl-module-replicate

(defthm vl-module-p-of-vl-module-replicate
  (b* ((new-x (vl-module-replicate x ss)))
    (vl-module-p new-x))
  :rule-classes :rewrite)

Theorem: vl-module-replicate-of-vl-module-fix-x

(defthm vl-module-replicate-of-vl-module-fix-x
  (equal (vl-module-replicate (vl-module-fix x)
                              ss)
         (vl-module-replicate x ss)))

Theorem: vl-module-replicate-vl-module-equiv-congruence-on-x

(defthm vl-module-replicate-vl-module-equiv-congruence-on-x
  (implies (vl-module-equiv x x-equiv)
           (equal (vl-module-replicate x ss)
                  (vl-module-replicate x-equiv ss)))
  :rule-classes :congruence)

Theorem: vl-module-replicate-of-vl-scopestack-fix-ss

(defthm vl-module-replicate-of-vl-scopestack-fix-ss
  (equal (vl-module-replicate x (vl-scopestack-fix ss))
         (vl-module-replicate x ss)))

Theorem: vl-module-replicate-vl-scopestack-equiv-congruence-on-ss

(defthm vl-module-replicate-vl-scopestack-equiv-congruence-on-ss
  (implies (vl-scopestack-equiv ss ss-equiv)
           (equal (vl-module-replicate x ss)
                  (vl-module-replicate x ss-equiv)))
  :rule-classes :congruence)