• 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
          • Parse-datatype
          • Parse-functions
          • Parse-datatypes
          • Parse-strengths
          • Vl-parse-genvar-declaration
          • Vl-parse
          • Parse-ports
            • Parse-port-types
            • Sv-ansi-portdecls
            • Creating-portdecls/vardecls
            • Sv-non-ansi-portdecls
            • Verilog-2005-ports
            • Sv-ansi-port-interpretation
              • Vl-process-subsequent-ansi-port
              • Vl-process-first-ansi-port
              • Vl-process-subsequent-ansi-ports
              • Vl-nettype-for-parsed-ansi-port
              • Vl-parse-module-port-list-top-2012
              • Vl-process-ansi-ports
              • Vl-port-starts-ansi-port-list-p
              • Vl-parse-module-port-list-top
              • Vl-genelementlist->portdecls
            • Verilog-2005-portdecls
          • 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

• Sv-ansi-port-interpretation

Vl-parse-module-port-list-top-2012

SystemVerilog-2012 only. Top-level function for parsing port lists in both ANSI and non-ANSI styles.

Signature

(vl-parse-module-port-list-top-2012 &key (tokstream 'tokstream) 
                                    (config 'config)) 
 
  → 
(mv errmsg? value new-tokstream)

Arguments

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

See sv-ansi-portdecls and sv-non-ansi-portdecls. We match the following, contrived grammar rule:

vl_module_port_list ::= list_of_ports
                      | [list_of_port_declarations]

Definitions and Theorems

Function: vl-parse-module-port-list-top-2012-fn

(defun vl-parse-module-port-list-top-2012-fn (tokstream config)
 (declare (xargs :stobjs (tokstream)))
 (declare (xargs :guard (vl-loadconfig-p config)))
 (declare (ignorable config))
 (let ((__function__ 'vl-parse-module-port-list-top-2012))
  (declare (ignorable __function__))
  (seq
   tokstream
   (unless (vl-is-token? :vl-lparen)
           (return (make-vl-parsed-ports :ansi-p nil
                                         :ports nil
                                         :portdecls nil
                                         :vardecls nil)))
   (:= (vl-match))
   (when (vl-is-token? :vl-rparen)
         (:= (vl-match))
         (return (make-vl-parsed-ports :ansi-p nil
                                       :ports nil
                                       :portdecls nil
                                       :vardecls nil)))
   (return-raw
    (b*
     ((backup (vl-tokstream-save))
      ((mv err port1 tokstream)
       (seq tokstream
            (atts := (vl-parse-0+-attribute-instances))
            (port1 := (vl-parse-ansi-port-declaration atts))
            (return port1)))
      (ansi-p (and (not err)
                   (vl-port-starts-ansi-port-list-p port1)))
      (tokstream (vl-tokstream-restore backup))
      ((when ansi-p)
       (seq
        tokstream
        (parsed := (vl-parse-1+-ansi-port-declarations))
        (:= (vl-match-token :vl-rparen))
        (return-raw
         (b* ((pstate (vl-tokstream->pstate))
              (warnings (vl-parsestate->warnings pstate))
              ((mv warnings ports portdecls vardecls)
               (vl-process-ansi-ports parsed warnings))
              (pstate (vl-parsestate-set-warnings warnings pstate))
              (tokstream (vl-tokstream-update-pstate pstate)))
          (seq
            tokstream
            (return (make-vl-parsed-ports :ansi-p t
                                          :ports ports
                                          :portdecls portdecls
                                          :vardecls vardecls))))))))
     (seq tokstream
          (ports := (vl-parse-1+-ports-separated-by-commas))
          (:= (vl-match-token :vl-rparen))
          (return (make-vl-parsed-ports :ansi-p nil
                                        :ports ports
                                        :portdecls nil
                                        :vardecls nil))))))))

Theorem: vl-parse-module-port-list-top-2012-fails-gracefully

(defthm vl-parse-module-port-list-top-2012-fails-gracefully
  (implies (mv-nth 0 (vl-parse-module-port-list-top-2012))
           (not (mv-nth 1
                        (vl-parse-module-port-list-top-2012)))))

Theorem: vl-warning-p-of-vl-parse-module-port-list-top-2012

(defthm vl-warning-p-of-vl-parse-module-port-list-top-2012
 (iff (vl-warning-p (mv-nth 0 (vl-parse-module-port-list-top-2012)))
      (mv-nth 0
              (vl-parse-module-port-list-top-2012))))

Theorem: vl-parse-module-port-list-top-2012-result

(defthm vl-parse-module-port-list-top-2012-result
  (implies
       (and t)
       (equal (vl-parsed-ports-p
                   (mv-nth 1 (vl-parse-module-port-list-top-2012)))
              (not (mv-nth 0
                           (vl-parse-module-port-list-top-2012))))))

Theorem: vl-parse-module-port-list-top-2012-count-weak

(defthm vl-parse-module-port-list-top-2012-count-weak
 (<=
    (vl-tokstream-measure
         :tokstream (mv-nth 2 (vl-parse-module-port-list-top-2012)))
    (vl-tokstream-measure))
 :rule-classes ((:rewrite) (:linear)))