• 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
              • Vl-parse-procedural-continuous-assignments
              • Vl-parse-task-enable
              • Vl-parse-event-trigger
              • Vl-parse-blocking-or-nonblocking-assignment
              • Vl-parse-tf-call
                • Vl-parse-subroutine-call-statement
                • Vl-parse-system-tf-call
                • Vl-make-case-statement
                • Vl-parse-system-task-enable
                • Vl-parse-operator-assignment/inc/dec
                • Vl-parse-disable-statement
                • Vl-filter-parsed-caseitemlist
                • Vl-parse-subroutine-call
                • Vl-parse-1+-id=expr-pairs
                • Vl-parse-case-keyword
                • Vl-actionblock
                • Vl-parse-1+-for-variable-declarations
                • Vl-parse-1+-for-init-assignments
                • Vl-parse-foreach-statement-array-part
                • Vl-parse-for-variable-declaration
                • Vl-parse-1+-for-step-assigns
                • Vl-maybe-parse-assert-deferral
                • Vl-parse-statement-2012-aux
                • Vl-parse-return-statement
                • Vl-parse-for-initialization
                • Vl-parse-unique-priority
                • Vl-parse-statement-top
                • Vl-parse-foreach-loop-variables
                • Vl-parse-case-statement
                • Vl-assign-op-expr
                • Vl-maybe-inject-block-name-into-assertion
                • Vl-parse-for-step
                • Vl-parse-concurrent-assertion-statement
                • Vl-parse-statement-wrapped
                • Vl-parse-statement-2005-aux
                • Vl-foreach-vardecls-from-loopvars
                • Vl-parse-immediate-assertion-statement
                • Vl-inc-or-dec-expr
                • Vl-parse-par-block
                • Vl-parse-seq-block
                • Vl-parse-statement-or-null
                • Vl-parse-procedural-assertion-statement
                • Vl-parse-action-block
                • Vl-parse-case-item
                • Vl-parse-expect-property-statement
                • Vl-parse-statement
                • Vl-parse-statement-aux
                • Vl-parse-1+-case-items
                • *vl-assignment-operators*
              • Parse-property
              • 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-statements

    Vl-parse-tf-call

    Parse a tf_call. SystemVerilog-2012 Only.

    Signature
    (vl-parse-tf-call &key (tokstream 'tokstream) (config 'config)) 
      → 
    (mv errmsg? value new-tokstream)
    Arguments
    config — Guard (vl-loadconfig-p config).

    Original grammar rules:

    tf_call ::= ps_or_hierarchical_tf_identifier
                   { attribute_instance }
                   [ '(' list_of_arguments ')' ]
    
    ps_or_hierarchical_tf_identifier ::= [package_scope] tf_identifier
                                       | hierarchical_tf_identifier
    
    hierarchical_tf_identifier ::= hierarchical_identifier
    tf_identifier ::= identifier

    So this is just:

    tf_call ::= [package_scope] identifier {attribute_instance} [ '(' list_of_arguments ')' ]
              | hierarchical_identifier    {attribute_instance} [ '(' list_of_arguments ')' ]

    Definitions and Theorems

    Function: vl-parse-tf-call-fn

    (defun vl-parse-tf-call-fn (tokstream config)
      (declare (xargs :stobjs (tokstream)))
      (declare (xargs :guard (vl-loadconfig-p config)))
      (declare (ignorable config))
      (let ((__function__ 'vl-parse-tf-call))
        (declare (ignorable __function__))
        (seq tokstream (loc := (vl-current-loc))
             (id :s= (vl-parse-scoped-hid))
             (atts := (vl-parse-0+-attribute-instances))
             (unless (vl-is-token? :vl-lparen)
                     (return (make-vl-callstmt :id id
                                               :typearg nil
                                               :systemp nil
                                               :voidp nil
                                               :args nil
                                               :atts atts
                                               :loc loc)))
             (:= (vl-match))
             (when (vl-is-token? :vl-rparen)
                   (:= (vl-match))
                   (return (make-vl-callstmt :id id
                                             :typearg nil
                                             :systemp nil
                                             :voidp nil
                                             :args nil
                                             :atts atts
                                             :loc loc)))
             (args := (vl-parse-1+-expressions-separated-by-commas))
             (:= (vl-match-token :vl-rparen))
             (return (make-vl-callstmt :id id
                                       :typearg nil
                                       :systemp nil
                                       :voidp nil
                                       :args args
                                       :atts atts
                                       :loc loc)))))

    Theorem: vl-parse-tf-call-fails-gracefully

    (defthm vl-parse-tf-call-fails-gracefully
      (implies (mv-nth 0 (vl-parse-tf-call))
               (not (mv-nth 1 (vl-parse-tf-call)))))

    Theorem: vl-warning-p-of-vl-parse-tf-call

    (defthm vl-warning-p-of-vl-parse-tf-call
      (iff (vl-warning-p (mv-nth 0 (vl-parse-tf-call)))
           (mv-nth 0 (vl-parse-tf-call))))

    Theorem: vl-parse-tf-call-result

    (defthm vl-parse-tf-call-result
      (implies (and t)
               (equal (vl-stmt-p (mv-nth 1 (vl-parse-tf-call)))
                      (not (mv-nth 0 (vl-parse-tf-call))))))

    Theorem: vl-parse-tf-call-count-strong

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

    Theorem: vl-stmt-kind-of-vl-parse-tf-call

    (defthm vl-stmt-kind-of-vl-parse-tf-call
      (b* (((mv err stmt ?tokstream)
            (vl-parse-tf-call)))
        (implies (not err)
                 (equal (vl-stmt-kind stmt)
                        :vl-callstmt))))