• 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
          • Scopestack
          • Hid-tools
          • Filtering-by-name
          • Vl-interface-mocktype
          • Stripping-functions
          • Genblob
          • Expr-tools
          • Extract-vl-types
          • Hierarchy
          • Range-tools
          • Finding-by-name
            • Fast-finding-by-name
            • Vl-find-interfaceport
            • Vl-find-portdecl
            • Vl-find-taskdecl
            • Vl-find-paramdecl
            • Vl-find-interface
            • Vl-find-gateinst
            • Vl-find-dpiimport
            • Vl-find-vardecl
            • Vl-find-typedef
            • Vl-find-program
            • Vl-find-package
            • Vl-find-module
            • Vl-find-modport
            • Vl-find-modinst
            • Vl-find-genelement
              • Vl-find-fundecl
              • Vl-find-genvar
              • Vl-find-config
              • Vl-find-class
              • Vl-find-udp
              • Vl-modalist
              • Vl-make-portdecl-alist
              • Vl-fast-find-module
              • Vl-fast-find-portdecl
            • Stmt-tools
            • Modnamespace
            • Flat-warnings
            • Reordering-by-name
            • Datatype-tools
            • Syscalls
            • Allexprs
            • Lvalues
            • Port-tools
          • Transforms
        • X86isa
        • Svl
        • Rtl
      • Software-verification
      • Math
      • Testing-utilities
    • Finding-by-name
    • Vl-genelementlist-p

    Vl-find-genelement

    Naive, O(n) lookup of a vl-genelement in a list by its name.

    Signature
    (vl-find-genelement name x) → genelement?
    Arguments
    name — Guard (stringp name).
    x — Guard (vl-genelementlist-p x).
    Returns
    genelement? — Type (iff (vl-genelement-p genelement?) genelement?).

    Definitions and Theorems

    Function: vl-find-genelement

    (defun vl-find-genelement (name x)
      (declare (xargs :guard (and (stringp name)
                                  (vl-genelementlist-p x))))
      (let ((__function__ 'vl-find-genelement))
        (declare (ignorable __function__))
        (cond ((atom x) nil)
              ((equal (string-fix name)
                      (vl-genelement->blockname (car x)))
               (vl-genelement-fix (car x)))
              (t (vl-find-genelement name (cdr x))))))

    Theorem: return-type-of-vl-find-genelement

    (defthm return-type-of-vl-find-genelement
      (b* ((genelement? (vl-find-genelement name x)))
        (iff (vl-genelement-p genelement?)
             genelement?))
      :rule-classes :rewrite)

    Theorem: vl-find-genelement-under-iff

    (defthm vl-find-genelement-under-iff
      (iff (vl-find-genelement name x)
           (member-equal (string-fix name)
                         (vl-genelementlist->blocknames x))))

    Theorem: vl-genelement->blockname-of-vl-find-genelement

    (defthm vl-genelement->blockname-of-vl-find-genelement
      (implies
           (vl-find-genelement name x)
           (equal (vl-genelement->blockname (vl-find-genelement name x))
                  (string-fix name))))

    Theorem: member-equal-of-vl-find-genelement

    (defthm member-equal-of-vl-find-genelement
      (implies (force (vl-genelementlist-p x))
               (iff (member-equal (vl-find-genelement name x)
                                  x)
                    (vl-find-genelement name x))))

    Theorem: consp-of-vl-find-genelement-when-member-equal

    (defthm consp-of-vl-find-genelement-when-member-equal
     (implies (and (member-equal name (vl-genelementlist->blocknames x))
                   (force (stringp name)))
              (consp (vl-find-genelement name x))))

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

    (defthm vl-find-genelement-of-str-fix-name
      (equal (vl-find-genelement (str-fix name) x)
             (vl-find-genelement name x)))

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

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

    Theorem: vl-find-genelement-of-vl-genelementlist-fix-x

    (defthm vl-find-genelement-of-vl-genelementlist-fix-x
      (equal (vl-find-genelement name (vl-genelementlist-fix x))
             (vl-find-genelement name x)))

    Theorem: vl-find-genelement-vl-genelementlist-equiv-congruence-on-x

    (defthm vl-find-genelement-vl-genelementlist-equiv-congruence-on-x
      (implies (vl-genelementlist-equiv x x-equiv)
               (equal (vl-find-genelement name x)
                      (vl-find-genelement name x-equiv)))
      :rule-classes :congruence)