• 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
              • Vl-parse-parameter-value-assignment-hack
              • Vl-erange-p
              • Vl-mixed-binop-list-p
              • Vl-parse-very-simple-type
              • Vl-mark-as-explicit-parens
              • Vl-parse-0+-scope-prefixes
                • Vl-parse-0+-attribute-instances
                • Vl-parse-op
                • Vl-parse-hierarchical-identifier
                • Vl-parse-pva-tail
                • Vl-parse-expression-top
                • Vl-parse-any-sort-of-concatenation
                • Vl-build-indexing-nest
                • Vl-erangetypelist-p
                • Vl-build-range-select-with
                • Vl-build-range-select
                • Vl-parse-simple-type
                • Vl-expr-has-any-atts-p
                • Vl-left-associate-mixed-binop-list
                • Vl-tack-scopes-onto-hid
                • Vl-parse-op-alist-p
                • Vl-make-guts-from-inttoken
                • Vl-parse-range-expression
                • Vl-parse-slice-size
                • Vl-parse-concatenation
                • Vl-parse-stream-expression
                • Vl-parse-1+-stream-expressions-separated-by-commas
                • Vl-parse-stream-concatenation
                • Vl-parse-primary
                • Vl-parse-0+-bracketed-expressions
                • Vl-parse-system-function-call
                • Vl-parse-shift-expression-aux
                • Vl-parse-power-expression-aux
                • Vl-parse-mult-expression-aux
                • Vl-parse-mintypmax-expression
                • Vl-parse-logor-expression-aux
                • Vl-parse-logand-expression-aux
                • Vl-parse-indexed-id-2012
                • Vl-parse-indexed-id-2005
                • Vl-parse-equality-expression-aux
                • Vl-parse-equality-expression
                • Vl-parse-compare-expression-aux
                • Vl-parse-bitxor-expression-aux
                • Vl-parse-bitor-expression-aux
                • Vl-parse-bitand-expression-aux
                • Vl-parse-1+-open-value-ranges
                • Vl-parse-1+-keyval-expression-pairs
                • Vl-parse-unary-expression
                • Vl-parse-shift-expression
                • Vl-parse-qmark-expression
                • Vl-parse-primary-main
                • Vl-parse-primary-cast
                • Vl-parse-power-expression
                • Vl-parse-open-value-range
                • Vl-parse-nonprimary-cast
                • Vl-parse-mult-expression
                • Vl-parse-logor-expression
                • Vl-parse-logand-expression
                • Vl-parse-indexed-id
                • Vl-parse-impl-expression
                • Vl-parse-function-call
                • Vl-parse-expression
                • Vl-parse-compare-expression
                • Vl-parse-bitxor-expression
                • Vl-parse-bitor-expression
                • Vl-parse-bitand-expression
                • Vl-parse-assignment-pattern
                • Vl-parse-add-expression-aux
                • Vl-parse-add-expression
                • Vl-parse-1+-expressions-separated-by-commas
              • 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
              • 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-expressions

    Vl-parse-0+-scope-prefixes

    Match { id '::' } and return an expression list with all of the ids that have been matched.

    Signature
    (vl-parse-0+-scope-prefixes &key (tokstream 'tokstream) 
                                (config 'config)) 
     
      → 
    (mv errmsg? value new-tokstream)
    Arguments
    config — Guard (vl-loadconfig-p config).

    See also vl-parse-indexed-id-2012 and abstract-hids. We use this in the tricky case of parsing:

    { id '::' } hierarchical_identifier select

    But per our desired abstract HID representation, we want to keep all of the scoping stuff bundled up together, so we prefer to match it first, if it exists.

    Definitions and Theorems

    Function: vl-parse-0+-scope-prefixes-fn

    (defun vl-parse-0+-scope-prefixes-fn (tokstream config)
     (declare (xargs :stobjs (tokstream)))
     (declare (xargs :guard (vl-loadconfig-p config)))
     (declare (ignorable config))
     (let ((__function__ 'vl-parse-0+-scope-prefixes))
      (declare (ignorable __function__))
      (seq
       tokstream
       (unless (and (vl-is-token? :vl-idtoken)
                    (vl-lookahead-is-token?
                         :vl-scope (cdr (vl-tokstream->tokens))))
               (return nil))
       (first := (vl-match))
       (:= (vl-match))
       (rest := (vl-parse-0+-scope-prefixes))
       (return
        (cons
           (make-vl-atom
                :guts (make-vl-hidpiece :name (vl-idtoken->name first)))
           rest)))))

    Theorem: vl-parse-0+-scope-prefixes-never-fails

    (defthm vl-parse-0+-scope-prefixes-never-fails
      (not (mv-nth 0 (vl-parse-0+-scope-prefixes))))

    Theorem: vl-parse-0+-scope-prefixes-result

    (defthm vl-parse-0+-scope-prefixes-result
      (implies (and (not (mv-nth 0 (vl-parse-0+-scope-prefixes)))
                    (and t))
               (vl-exprlist-p (mv-nth 1 (vl-parse-0+-scope-prefixes)))))

    Theorem: vl-parse-0+-scope-prefixes-true-listp

    (defthm vl-parse-0+-scope-prefixes-true-listp
      (true-listp (mv-nth 1 (vl-parse-0+-scope-prefixes)))
      :rule-classes :type-prescription)

    Theorem: vl-parse-0+-scope-prefixes-count-strong-on-value

    (defthm vl-parse-0+-scope-prefixes-count-strong-on-value
     (and
        (<= (vl-tokstream-measure
                 :tokstream (mv-nth 2 (vl-parse-0+-scope-prefixes)))
            (vl-tokstream-measure))
        (implies
             (mv-nth 1 (vl-parse-0+-scope-prefixes))
             (< (vl-tokstream-measure
                     :tokstream (mv-nth 2 (vl-parse-0+-scope-prefixes)))
                (vl-tokstream-measure))))
     :rule-classes ((:rewrite) (:linear)))

    Theorem: vl-parse-0+-scope-prefixes-on-eof

    (defthm vl-parse-0+-scope-prefixes-on-eof
     (implies
      (not (consp (vl-tokstream->tokens)))
      (b* (((mv & val new-tokstream)
            (vl-parse-0+-scope-prefixes)))
       (and
        (not val)
        (not
            (consp (vl-tokstream->tokens :tokstream new-tokstream)))))))