• 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
                • Vl-parse-port-reference
                • Vl-parse-1+-ports-separated-by-commas
                  • Vl-parse-1+-port-references-separated-by-commas
                  • Vl-parse-nonnull-port
                  • Vl-parse-port-expression
                • Sv-ansi-port-interpretation
                • 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
    • Verilog-2005-ports

    Vl-parse-1+-ports-separated-by-commas

    Matches port { ',' port }, possibly producing blank ports!

    Signature
    (vl-parse-1+-ports-separated-by-commas &key (tokstream 'tokstream) 
                                           (config 'config)) 
     
      → 
    (mv errmsg? value new-tokstream)
    Arguments
    config — Guard (vl-loadconfig-p config).

    Definitions and Theorems

    Function: vl-parse-1+-ports-separated-by-commas-fn

    (defun vl-parse-1+-ports-separated-by-commas-fn (tokstream config)
      (declare (xargs :stobjs (tokstream)))
      (declare (xargs :guard (vl-loadconfig-p config)))
      (declare (ignorable config))
      (let ((__function__ 'vl-parse-1+-ports-separated-by-commas))
        (declare (ignorable __function__))
        (seq tokstream
             (when (vl-is-token? :vl-rparen)
                   (loc := (vl-current-loc))
                   (return (list (make-vl-regularport :name nil
                                                      :expr nil
                                                      :loc loc))))
             (when (vl-is-token? :vl-comma)
                   (loc := (vl-current-loc))
                   (:= (vl-match))
                   (rest := (vl-parse-1+-ports-separated-by-commas))
                   (return (cons (make-vl-regularport :name nil
                                                      :expr nil
                                                      :loc loc)
                                 rest)))
             (first := (vl-parse-nonnull-port))
             (when (vl-is-token? :vl-comma)
                   (:= (vl-match))
                   (rest := (vl-parse-1+-ports-separated-by-commas)))
             (return (cons first rest)))))

    Theorem: vl-parse-1+-ports-separated-by-commas-fails-gracefully

    (defthm vl-parse-1+-ports-separated-by-commas-fails-gracefully
      (implies (mv-nth 0
                       (vl-parse-1+-ports-separated-by-commas))
               (not (mv-nth 1
                            (vl-parse-1+-ports-separated-by-commas)))))

    Theorem: vl-warning-p-of-vl-parse-1+-ports-separated-by-commas

    (defthm vl-warning-p-of-vl-parse-1+-ports-separated-by-commas
     (iff
         (vl-warning-p (mv-nth 0
                               (vl-parse-1+-ports-separated-by-commas)))
         (mv-nth 0
                 (vl-parse-1+-ports-separated-by-commas))))

    Theorem: vl-parse-1+-ports-separated-by-commas-result

    (defthm vl-parse-1+-ports-separated-by-commas-result
     (implies
      (and t)
      (vl-portlist-p (mv-nth 1
                             (vl-parse-1+-ports-separated-by-commas)))))

    Theorem: vl-parse-1+-ports-separated-by-commas-true-listp

    (defthm vl-parse-1+-ports-separated-by-commas-true-listp
      (true-listp (mv-nth 1
                          (vl-parse-1+-ports-separated-by-commas)))
      :rule-classes :type-prescription)

    Theorem: vl-parse-1+-ports-separated-by-commas-count-weak

    (defthm vl-parse-1+-ports-separated-by-commas-count-weak
     (<=
       (vl-tokstream-measure
            :tokstream (mv-nth 2
                               (vl-parse-1+-ports-separated-by-commas)))
       (vl-tokstream-measure))
     :rule-classes ((:rewrite) (:linear)))