• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • Std
    • Proof-automation
    • Macro-libraries
    • ACL2
    • Interfacing-tools
    • Hardware-verification
      • Gl
      • Esim
      • Vl2014
      • Sv
      • Fgl
      • Vwsim
      • Vl
        • Syntax
        • Loader
        • Warnings
        • Getting-started
        • Utilities
        • Printer
        • Kit
        • Mlib
        • Transforms
          • Unparameterization
          • Elaborate
          • Addnames
          • Annotate
            • Increment-elim
            • Make-implicit-wires
              • Shadowcheck
                • Vl-shadowcheck-genelement
                • Vl-shadowcheck-reference-name
                • Vl-shadowcheck-declare-name
                • Deltemps
                • Vl-shadowcheck-modelement
                • Vl-lexscope
                • Vl-shadowcheck-reference-scopeexpr
                • Vl-shadowcheck-reference-names
                • Vl-shadowcheck-declare-names
                • Vl-shadowcheck-paramtype
                • Vl-shadowcheck-fun/task-loaditems
                • Vl-shadowcheck-fun/task-loaditem
                • Vl-shadowcheck-fundecl
                • Vl-shadowcheck-declare-typedefs
                • Vl-shadowcheck-blockitemlist
                • Vl-shadowcheck-portdecllist
                • Vl-shadowcheck-paramdecls
                • Vl-shadowcheck-dpiimports
                • Vl-shadowcheck-taskdecls
                • Vl-shadowcheck-taskdecl
                • Vl-shadowcheck-push-scope
                • Vl-shadowcheck-blockitem
                • Vl-shadowcheck-vardecls
                • Vl-shadowcheck-vardecl
                • Vl-shadowcheck-typedef
                • Vl-shadowcheck-portdecl
                • Vl-shadowcheck-paramdecl
                • Vl-shadowcheck-modport
                • Vl-shadowcheck-modinst
                • Vl-shadowcheck-imports
                • Vl-shadowcheck-import
                • Vl-shadowcheck-gateinst
                • Vl-shadowcheck-fundecls
                • Vl-shadowcheck-dpiimport
                • Vl-shadowcheck-ports
                • Vl-shadowcheck-port
                • Vl-shadowcheck-initial
                • Vl-shadowcheck-assign
                • Vl-shadowcheck-always
                • Vl-shadowcheck-final
                • Vl-shadowcheck-alias
                • Vl-shadowcheck-state
                • Vl-shadowcheck-module
                • Vl-shadowcheck-interface
                • Vl-shadowcheck-interfaces
                • Vl-shadowcheck-modules
                • Vl-packagemap-find-packages-for-name
                • Vl-shadowcheck-design
                • Vl-lexscopes
                  • Vl-lexscopes-fix
                  • Vl-lexscopes-direct-import-name
                  • Vl-lexscopes-declare-name
                  • Vl-lexscopes-do-import
                  • Vl-lexscopes-find
                    • Vl-lexscopes-equiv
                    • Vl-lexscopes-p
                    • Vl-lexscopes-exit-scope
                    • Vl-lexscopes-enter-new-scope
                  • Vl-expr->maybe-subtype
                  • Vl-shadowcheck-pop-scope
                  • Nameclash
                  • Vl-portdecl-or-blockitem
                  • Vl-lexscope-decls
                  • Vl-packagemap
                  • Vl-portdecl-or-blockitem-list
                • Implicit-wires-minutia
                • Implicit-wires-generate-scoping
                • Vl-genbase-make-implicit-wires
                • Vl-expr-names-for-implicit
                • Vl-make-implicit-wires-main
                • Vl-implicitst
                • Vl-make-port-implicit-wires
                • Vl-import-update-implicit
                • Vl-blockitemlist-update-implicit
                • Vl-blockitem-update-implicit
                • Vl-make-ordinary-implicit-wires
                • Vl-remove-declared-wires
                • Vl-implicitsts-restore-fast-alists
                • Vl-genblock-under-cond-make-implicit-wires
                • Vl-collect-exprs-for-implicit-wires-from-namedargs
                • Vl-genblock-make-implicit-wires
                • Vl-collect-exprs-for-implicit-wires-from-portargs
                • Vl-collect-exprs-for-implicit-wires-from-namedarg
                • Vl-gateinst-exprs-for-implicit-wires
                • Vl-modinst-exprs-for-implicit-wires
                • Vl-genelementlist-make-implicit-wires
                • Vl-packagemap-find-name
              • Basic-bind-elim
              • Argresolve
              • Basicsanity
              • Portdecl-sign
              • Enum-names
              • Port-resolve
              • Udp-elim
              • Vl-annotate-design
              • Vl-annotate-module
            • Clean-warnings
            • Eliminitial
            • Custom-transform-hooks
            • Problem-modules
        • X86isa
        • Svl
        • Rtl
      • Software-verification
      • Math
      • Testing-utilities
    • Vl-lexscopes

    Vl-lexscopes-find

    Recursively look up a name, going from inner to outer lexical scopes.

    Signature
    (vl-lexscopes-find name scopes) → (mv entry tail)
    Arguments
    name — Guard (stringp name).
    scopes — Guard (vl-lexscopes-p scopes).
    Returns
    entry — Entry for this name, if it is declared.
        Type (iff (vl-lexscope-entry-p entry) entry).
    tail — The tail of scopes starting with the scope for this name.
        Type (vl-lexscopes-p tail).

    Definitions and Theorems

    Function: vl-lexscopes-find

    (defun vl-lexscopes-find (name scopes)
      (declare (xargs :guard (and (stringp name)
                                  (vl-lexscopes-p scopes))))
      (let ((__function__ 'vl-lexscopes-find))
        (declare (ignorable __function__))
        (b* ((name (string-fix name))
             (scopes (vl-lexscopes-fix scopes))
             ((when (atom scopes)) (mv nil nil))
             (entry (vl-lexscope-find name (car scopes)))
             ((when entry) (mv entry scopes)))
          (vl-lexscopes-find name (cdr scopes)))))

    Theorem: return-type-of-vl-lexscopes-find.entry

    (defthm return-type-of-vl-lexscopes-find.entry
      (b* (((mv ?entry set::?tail)
            (vl-lexscopes-find name scopes)))
        (iff (vl-lexscope-entry-p entry) entry))
      :rule-classes :rewrite)

    Theorem: vl-lexscopes-p-of-vl-lexscopes-find.tail

    (defthm vl-lexscopes-p-of-vl-lexscopes-find.tail
      (b* (((mv ?entry set::?tail)
            (vl-lexscopes-find name scopes)))
        (vl-lexscopes-p tail))
      :rule-classes :rewrite)

    Theorem: vl-lexscopes-find-of-str-fix-name

    (defthm vl-lexscopes-find-of-str-fix-name
      (equal (vl-lexscopes-find (str-fix name)
                                scopes)
             (vl-lexscopes-find name scopes)))

    Theorem: vl-lexscopes-find-streqv-congruence-on-name

    (defthm vl-lexscopes-find-streqv-congruence-on-name
      (implies (streqv name name-equiv)
               (equal (vl-lexscopes-find name scopes)
                      (vl-lexscopes-find name-equiv scopes)))
      :rule-classes :congruence)

    Theorem: vl-lexscopes-find-of-vl-lexscopes-fix-scopes

    (defthm vl-lexscopes-find-of-vl-lexscopes-fix-scopes
      (equal (vl-lexscopes-find name (vl-lexscopes-fix scopes))
             (vl-lexscopes-find name scopes)))

    Theorem: vl-lexscopes-find-vl-lexscopes-equiv-congruence-on-scopes

    (defthm vl-lexscopes-find-vl-lexscopes-equiv-congruence-on-scopes
      (implies (vl-lexscopes-equiv scopes scopes-equiv)
               (equal (vl-lexscopes-find name scopes)
                      (vl-lexscopes-find name scopes-equiv)))
      :rule-classes :congruence)