• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Community
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
    • Sv
    • Fgl
    • Vwsim
    • Vl
      • Syntax
      • Loader
        • Preprocessor
        • Vl-loadconfig
        • Vl-loadstate
        • Lexer
        • Parser
          • Parse-expressions
          • Parse-udps
          • Parse-statements
          • Parse-property
            • Vl-parse-property-list-of-arguments
            • Vl-parse-sequence-match-item
            • Vl-parse-property-actual-arg
            • Vl-parse-scoped-or-hierarchical-identifier
            • Vl-parse-cycledelayrange
            • Vl-parse-sequence-abbrev
            • Vl-parse-boolean-abbrev
            • Vl-parse-1+-expression-or-dists-separated-by-commas
            • Vl-parse-property-acceptop
            • Vl-parse-dist-item
            • Vl-parse-sequence-match-item-list
            • Vl-parse-property-spec
            • Vl-parse-impl-prop-expr-op
            • Vl-parse-expression-or-dist
            • Vl-parse-dist-list
            • Vl-alternating-propexpr/op-list-p
            • Vl-left-associate-alternating-propexpr/op-list
            • Vl-left-associate-delay-se-tail
            • Vl-delay-se-tail-p
            • Vl-parse-1+-named-property-list-of-arguments
            • Vl-parse-property-low-prec-unary
            • Vl-parse-within-sequence-expr-aux
            • Vl-parse-throughout-sequence-expr
            • Vl-parse-or-property-expr-aux
            • Vl-parse-intersect-sequence-expr-aux
            • Vl-parse-intersect-sequence-expr
            • Vl-parse-delay-sequence-expr
            • Vl-parse-assign-sequence-expr
            • Vl-parse-and-property-expr-aux
            • Vl-parse-1+-property-case-items
            • Vl-parse-within-sequence-expr
            • Vl-parse-or-property-expr
            • Vl-parse-instance-property-expr
            • Vl-parse-iff-property-expr
            • Vl-parse-delay-sequence-expr-tail
            • Vl-parse-and-property-expr
            • Vl-parse-until-property-expr
            • Vl-parse-strength-property-expr
            • Vl-parse-repeat-sequence-expr
            • Vl-parse-property-expr
            • Vl-parse-property-case-item
            • Vl-parse-not-property-expr
            • Vl-parse-impl-property-expr
            • Vl-parse-firstmatch-sequence-expr
          • Vl-genelements
          • Parse-paramdecls
          • Parse-blockitems
          • Parse-utils
          • Parse-insts
          • Parse-functions
          • Parse-assignments
          • Parse-clocking
          • Parse-strengths
          • Vl-parse-genvar-declaration
          • Vl-parse
          • Parse-netdecls
          • Parse-asserts
          • Vl-maybe-parse-lifetime
          • Parse-dpi-import-export
          • Parse-ports
          • Parse-timeunits
          • Seq
          • Parse-packages
          • Parse-eventctrl
        • Vl-load-merge-descriptions
        • Vl-find-basename/extension
        • Vl-load-file
        • Vl-loadresult
        • Scope-of-defines
        • Vl-find-file
        • Vl-flush-out-descriptions
        • Vl-description
        • Vl-read-file
        • Vl-includeskips-report-gather
        • Vl-load-main
        • Extended-characters
        • Vl-load
        • Vl-load-description
        • Vl-descriptions-left-to-load
        • Inject-warnings
        • Vl-preprocess-debug
        • Vl-write-preprocessor-debug-file
        • Vl-read-file-report-gather
        • Vl-load-descriptions
        • Vl-load-files
        • Translate-off
        • Vl-load-read-file-hook
        • Vl-read-file-report
        • Vl-loadstate-pad
        • Vl-load-summary
        • Vl-collect-modules-from-descriptions
        • Vl-loadstate->warnings
        • Vl-iskips-report
        • Vl-descriptionlist
      • Warnings
      • Getting-started
      • Utilities
      • Printer
      • Kit
      • Mlib
      • Transforms
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Parse-property

Vl-parse-sequence-match-item

Matches sequence_match_item.

Signature

(vl-parse-sequence-match-item &key (tokstream 'tokstream) 
                              (config 'config)) 
 
  → 
(mv errmsg? value new-tokstream)

Arguments

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

After reviewing the grammar, I think sequence_match_items are essentially just a subset of expressions and can probably be best represented just as expressions. The main grammar rule is:

sequence_match_item ::= operator_assignment
                      | inc_or_dec_expression
                      | subroutine_call

If you dive down into this, the complexity really explodes. The details of inc_or_dec_expression and operator_assignment involve variable_lvalue terms which are really complex and which we haven't tried to entirely support yet in our expressions. Meanwhile subroutine_call can include randomize_call which leads to a huge bunch of constraint_block stuff and there are also other parts of subroutine_call like array_manipulation_call that we haven't tried to implement at all.

But all of this stuff is also a problem in our ordinary expressions; we have

expression ::= primary
             | '(' operator_assignment ')'
             | inc_or_dec_expression
             | ...

primary ::= function_subroutine_call
          | ...

function_subroutine_call ::= subroutine_call

So all of these kinds of things can directly be expressions.

Definitions and Theorems

Function: vl-parse-sequence-match-item-fn

(defun vl-parse-sequence-match-item-fn (tokstream config)
 (declare (xargs :stobjs (tokstream)))
 (declare (xargs :guard (vl-loadconfig-p config)))
 (declare (ignorable config))
 (let ((__function__ 'vl-parse-sequence-match-item))
  (declare (ignorable __function__))
  (seq
   tokstream
   (expr := (vl-parse-mintypmax-expression))
   (when
    (and
     expr
     (vl-expr-case
      expr (:vl-call t)
      (:vl-unary
       (member
           expr.op
           '(:vl-unary-preinc :vl-unary-predec
                              :vl-unary-postinc :vl-unary-postdec)))
      (:vl-binary
        (member expr.op
                '(:vl-binary-assign
                      :vl-binary-plusassign :vl-binary-minusassign
                      :vl-binary-timesassign :vl-binary-divassign
                      :vl-binary-remassign :vl-binary-andassign
                      :vl-binary-orassign :vl-binary-xorassign
                      :vl-binary-shlassign :vl-binary-shrassign
                      :vl-binary-ashlassign :vl-binary-ashrassign)))
      (& nil)))
    (return expr))
   (return-raw
        (vl-parse-error
             "Illegal expression for sequence_match_item.")))))

Theorem: vl-parse-sequence-match-item-fails-gracefully

(defthm vl-parse-sequence-match-item-fails-gracefully
  (implies (mv-nth 0 (vl-parse-sequence-match-item))
           (not (mv-nth 1 (vl-parse-sequence-match-item)))))

Theorem: vl-warning-p-of-vl-parse-sequence-match-item

(defthm vl-warning-p-of-vl-parse-sequence-match-item
  (iff (vl-warning-p (mv-nth 0 (vl-parse-sequence-match-item)))
       (mv-nth 0 (vl-parse-sequence-match-item))))

Theorem: vl-parse-sequence-match-item-result

(defthm vl-parse-sequence-match-item-result
  (implies
       (and t)
       (equal (vl-expr-p (mv-nth 1 (vl-parse-sequence-match-item)))
              (not (mv-nth 0 (vl-parse-sequence-match-item))))))

Theorem: vl-parse-sequence-match-item-count-strong

(defthm vl-parse-sequence-match-item-count-strong
 (and
  (<= (vl-tokstream-measure
           :tokstream (mv-nth 2 (vl-parse-sequence-match-item)))
      (vl-tokstream-measure))
  (implies
       (not (mv-nth 0 (vl-parse-sequence-match-item)))
       (< (vl-tokstream-measure
               :tokstream (mv-nth 2 (vl-parse-sequence-match-item)))
          (vl-tokstream-measure))))
 :rule-classes ((:rewrite) (:linear)))