• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Community
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
      • Warnings
      • Primitives
      • Use-set
      • Syntax
      • Getting-started
      • Utilities
      • Loader
        • Preprocessor
        • Vl-loadconfig
        • Lexer
        • Vl-loadstate
        • Parser
          • Parse-expressions
          • Parse-udps
          • Vl-genelements
          • Parse-paramdecls
          • Parse-blockitems
          • Parse-utils
          • Parse-insts
            • Special-note-about-blank-ports
            • Vl-parse-list-of-named-port-connections-2012
            • Vl-parse-udp-or-module-instantiation
            • Vl-parse-udp-instance
            • Vl-parse-list-of-ordered-port-connections
            • Vl-parse-list-of-ordered-parameter-assignments
            • Vl-parse-list-of-named-port-connections-2005
            • Vl-parse-list-of-named-parameter-assignments
            • Vl-parse-1+-udp-instances
            • Vl-parse-module-instance
            • Vl-parse-1+-module-instances
            • Vl-parse-udp-instantiation
            • Vl-parse-parameter-value-assignment
            • Vl-parse-named-port-connection
            • Vl-parse-named-parameter-assignment
            • Vl-parse-module-instantiation
            • Vl-parse-list-of-parameter-assignments
            • Vl-parse-list-of-named-port-connections
            • Vl-parse-param-expression
            • Vl-parse-list-of-port-connections
          • Parse-datatype
          • Parse-functions
          • Parse-datatypes
          • Parse-strengths
          • Vl-parse-genvar-declaration
          • Vl-parse
          • Parse-ports
          • Seq
          • Parse-packages
        • Vl-load-merge-descriptions
        • Scope-of-defines
        • Vl-load-file
        • Vl-flush-out-descriptions
        • Vl-description
        • Vl-loadresult
        • Vl-read-file
        • Vl-find-basename/extension
        • Vl-find-file
        • Vl-read-files
        • Extended-characters
        • Vl-load
        • Vl-load-main
        • Vl-load-description
        • Vl-descriptions-left-to-load
        • Inject-warnings
        • Vl-load-descriptions
        • Vl-load-files
        • Vl-load-summary
        • Vl-collect-modules-from-descriptions
        • Vl-descriptionlist
      • Transforms
      • Lint
      • Mlib
      • Server
      • Kit
      • Printer
      • Esim-vl
      • Well-formedness
    • Sv
    • Fgl
    • Vwsim
    • Vl
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Parse-insts

Vl-parse-module-instance

Signature

(vl-parse-module-instance modname paramargs 
                          atts &key (tokstream 'tokstream) 
                          (config 'config)) 
 
  → 
(mv errmsg? value new-tokstream)

Arguments

config — Guard (vl-loadconfig-p config).

Definitions and Theorems

Function: vl-parse-module-instance-fn

(defun vl-parse-module-instance-fn
       (modname paramargs atts tokstream config)
 (declare (xargs :stobjs (tokstream)))
 (declare (xargs :guard (vl-loadconfig-p config)))
 (declare (ignorable config))
 (declare (xargs :guard (and (stringp modname)
                             (vl-paramargs-p paramargs)
                             (vl-atts-p atts))))
 (let ((__function__ 'vl-parse-module-instance))
  (declare (ignorable __function__))
  (seq
     tokstream
     (instname := (vl-match-token :vl-idtoken))
     (when (vl-is-token? :vl-lbrack)
           (range := (vl-parse-range)))
     (:= (vl-match-token :vl-lparen))
     (unless (vl-is-token? :vl-rparen)
             (portargs := (vl-parse-list-of-port-connections)))
     (:= (vl-match-token :vl-rparen))
     (return (make-vl-modinst
                  :loc (vl-token->loc instname)
                  :instname (vl-idtoken->name instname)
                  :modname modname
                  :range range
                  :paramargs paramargs
                  :portargs (or portargs
                                (make-vl-arguments-plain :args nil))
                  :atts atts)))))

Theorem: vl-parse-module-instance-fails-gracefully

(defthm vl-parse-module-instance-fails-gracefully
 (implies
  (mv-nth 0
          (vl-parse-module-instance modname paramargs atts))
  (not (mv-nth 1
               (vl-parse-module-instance modname paramargs atts)))))

Theorem: vl-warning-p-of-vl-parse-module-instance

(defthm vl-warning-p-of-vl-parse-module-instance
 (iff
    (vl-warning-p
         (mv-nth 0
                 (vl-parse-module-instance modname paramargs atts)))
    (mv-nth 0
            (vl-parse-module-instance modname paramargs atts))))

Theorem: vl-parse-module-instance-result

(defthm vl-parse-module-instance-result
 (implies
  (and (and (force (stringp modname))
            (force (vl-paramargs-p paramargs))
            (force (vl-atts-p atts))))
  (equal
   (vl-modinst-p
        (mv-nth 1
                (vl-parse-module-instance modname paramargs atts)))
   (not
      (mv-nth 0
              (vl-parse-module-instance modname paramargs atts))))))

Theorem: vl-parse-module-instance-count-strong

(defthm vl-parse-module-instance-count-strong
 (and
  (<=
    (vl-tokstream-measure
         :tokstream
         (mv-nth 2
                 (vl-parse-module-instance modname paramargs atts)))
    (vl-tokstream-measure))
  (implies
   (not (mv-nth 0
                (vl-parse-module-instance modname paramargs atts)))
   (<
    (vl-tokstream-measure
         :tokstream
         (mv-nth 2
                 (vl-parse-module-instance modname paramargs atts)))
    (vl-tokstream-measure))))
 :rule-classes ((:rewrite) (:linear)))