• Top
  • Documentation
  • Books
  • Boolean-reasoning
  • Projects
  • Debugging
  • Std
  • Proof-automation
  • Macro-libraries
  • ACL2
  • Interfacing-tools
  • Hardware-verification
    • Gl
    • Esim
    • Vl2014
    • Sv
    • Vwsim
    • Fgl
    • Vl
      • Syntax
      • Loader
      • Warnings
      • Getting-started
      • Utilities
      • Printer
      • Kit
      • Mlib
        • Scopestack
          • Vl-interfaceportlist->ifnames
          • Vl-blockscope
          • Vl-scope-find-item
          • Vl-scopestack-find-item/ss/package
          • Vl-importlist-find-explicit-item
          • Vl-scopestack-find-item/context
          • Vl-importlist-find-implicit-item
          • Vl-import-stars-find-item
          • Vl-scopeinfo
          • Vl-importlist->explicit-item-alist
          • Vl-scopestack-find-definition/ss
          • Vl-scopeitem
          • Vl-scopestack-find-package/ss
          • Vl-scopestack
          • Vl-scopeinfo-find-item
          • Vl-scopestack-find-item/ss
          • Vl-scopestack-find-class/ss
          • Scopestack-constants
          • Vl-scope-namespace
          • Vl-maybe-scope
          • Vl-importresult
          • Vl-scopestack-push
          • Vl-import-stars-itemnames
          • Vl-scope->scopeinfo
          • Vl-scope-find-item-fast
          • Vl-interface-scope-find-item
          • Vl-genblob-scope-find-item
          • Vl-module-scope-find-item
          • Vl-design-scope-find-definition
          • Vl-scopestack-find-item
          • Vl-scopestack-find-definition
          • Vl-scopeinfo->itemnames
          • Vl-scope-find-portdecl
          • Vl-scope-find-definition
          • Vl-package-scope-find-item
          • Vl-interface-scope-find-portdecl
          • Vl-genblob-scope-find-portdecl
          • Vl-design-scope-find-item
          • Vl-blockscope-scope-find-item
          • Vl-scopestack-find-package
          • Vl-scope-find-package
          • Vl-module-scope-find-portdecl
          • Vl-design-scope-find-package
          • Vl-design-scope-find-class
          • Vl-class-scope-find-item
          • Vl-scopestack-find-class
          • Vl-scope-find-class
          • Vl-scopestack->hashkey
          • Vl-scope-find-portdecl-fast
          • Vl-package-scope-item-alist-top
          • Vl-scopestack->path-aux
          • Vl-scopedef
          • Vl-scope-portdecl-alist
          • Vl-scope-package-alist
          • Vl-scope-find-definition-fast
          • Vl-scope-definition-alist
          • Vl-scope-find-package-fast
          • Vl-scope-find-class-fast
          • Vl-scope-class-alist
          • Vl-scopestack->path
          • Vl-scopestack->design
          • Vl-scopeitem->name
          • Vl-scope
          • Vl-scopestack-init
          • Vl-importlist->star-packages
          • Vl-scopestack-pop
          • Vl-scopestack-nesting-level
          • Vl-scopestack->toplevel
          • Vl-scope->scopetype
          • Vl-scope->id
          • Vl-design-scope-package-alist-top
          • Vl-bindlist->modinsts
          • Vl-scopestack-toplevel-p
          • Vl-scopestacks-free
          • Vl-importresult-alist
        • Hid-tools
        • Filtering-by-name
        • Vl-interface-mocktype
        • Stripping-functions
        • Genblob
        • Expr-tools
        • Extract-vl-types
        • Hierarchy
        • Range-tools
        • Finding-by-name
        • Stmt-tools
        • Modnamespace
        • Flat-warnings
        • Reordering-by-name
        • Datatype-tools
        • Syscalls
        • Allexprs
        • Lvalues
        • Port-tools
      • Transforms
    • X86isa
    • Svl
    • Rtl
  • Software-verification
  • Math
  • Testing-utilities

• Scopestack

Vl-scopestack-find-item/ss/package

Look up a plain identifier in the current scope stack.

Signature

(vl-scopestack-find-item/ss/package name ss) 
  → 
(mv item item-ss context-ss pkg-name)

Arguments

name — Guard (stringp name).

ss — Guard (vl-scopestack-p ss).

Returns

item — The item declaration, if found.
    Type (iff (vl-scopeitem-p item) item).

item-ss — The scopestack for the context in which the item was declared.
    Type (vl-scopestack-p item-ss).

context-ss — The scopestack for the context in which the item was found (possibly imported).
    Type (vl-scopestack-p context-ss).

pkg-name — If the item was imported, the name of the package it was imported from.
    Type (iff (stringp pkg-name) pkg-name).

Definitions and Theorems

Function: vl-scopestack-find-item/ss/package

(defun vl-scopestack-find-item/ss/package (name ss)
 (declare (xargs :guard (and (stringp name)
                             (vl-scopestack-p ss))))
 (let ((__function__ 'vl-scopestack-find-item/ss/package))
  (declare (ignorable __function__))
  (b*
   (((mv item context-ss pkg-name)
     (vl-scopestack-find-item/context name ss))
    ((unless pkg-name)
     (mv item context-ss context-ss nil))
    (design (vl-scopestack->design context-ss))
    (pkg
     (and
       design
       (cdr (hons-get pkg-name
                      (vl-design-scope-package-alist-top design)))))
    ((unless pkg)
     (mv item nil context-ss pkg-name))
    (pkg-ss (vl-scopestack-push pkg (vl-scopestack-init design))))
   (mv item pkg-ss context-ss pkg-name))))

Theorem: return-type-of-vl-scopestack-find-item/ss/package.item

(defthm return-type-of-vl-scopestack-find-item/ss/package.item
  (b* (((mv ?item ?item-ss ?context-ss ?pkg-name)
        (vl-scopestack-find-item/ss/package name ss)))
    (iff (vl-scopeitem-p item) item))
  :rule-classes :rewrite)

Theorem: vl-scopestack-p-of-vl-scopestack-find-item/ss/package.item-ss

(defthm
      vl-scopestack-p-of-vl-scopestack-find-item/ss/package.item-ss
  (b* (((mv ?item ?item-ss ?context-ss ?pkg-name)
        (vl-scopestack-find-item/ss/package name ss)))
    (vl-scopestack-p item-ss))
  :rule-classes :rewrite)

Theorem: vl-scopestack-p-of-vl-scopestack-find-item/ss/package.context-ss

(defthm
   vl-scopestack-p-of-vl-scopestack-find-item/ss/package.context-ss
  (b* (((mv ?item ?item-ss ?context-ss ?pkg-name)
        (vl-scopestack-find-item/ss/package name ss)))
    (vl-scopestack-p context-ss))
  :rule-classes :rewrite)

Theorem: return-type-of-vl-scopestack-find-item/ss/package.pkg-name

(defthm return-type-of-vl-scopestack-find-item/ss/package.pkg-name
  (b* (((mv ?item ?item-ss ?context-ss ?pkg-name)
        (vl-scopestack-find-item/ss/package name ss)))
    (iff (stringp pkg-name) pkg-name))
  :rule-classes :rewrite)

Theorem: vl-scopestack-find-item/ss/package-of-str-fix-name

(defthm vl-scopestack-find-item/ss/package-of-str-fix-name
  (equal (vl-scopestack-find-item/ss/package (str-fix name)
                                             ss)
         (vl-scopestack-find-item/ss/package name ss)))

Theorem: vl-scopestack-find-item/ss/package-streqv-congruence-on-name

(defthm vl-scopestack-find-item/ss/package-streqv-congruence-on-name
  (implies
       (streqv name name-equiv)
       (equal (vl-scopestack-find-item/ss/package name ss)
              (vl-scopestack-find-item/ss/package name-equiv ss)))
  :rule-classes :congruence)

Theorem: vl-scopestack-find-item/ss/package-of-vl-scopestack-fix-ss

(defthm vl-scopestack-find-item/ss/package-of-vl-scopestack-fix-ss
 (equal
    (vl-scopestack-find-item/ss/package name (vl-scopestack-fix ss))
    (vl-scopestack-find-item/ss/package name ss)))

Theorem: vl-scopestack-find-item/ss/package-vl-scopestack-equiv-congruence-on-ss

(defthm
 vl-scopestack-find-item/ss/package-vl-scopestack-equiv-congruence-on-ss
 (implies
      (vl-scopestack-equiv ss ss-equiv)
      (equal (vl-scopestack-find-item/ss/package name ss)
             (vl-scopestack-find-item/ss/package name ss-equiv)))
 :rule-classes :congruence)