• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • Community
    • Std
    • Proof-automation
    • Macro-libraries
    • ACL2
    • Interfacing-tools
    • Hardware-verification
    • Software-verification
      • Kestrel-books
        • Crypto-hdwallet
        • Apt
        • Error-checking
        • Fty-extensions
        • Isar
        • Kestrel-utilities
        • Set
        • C
          • Syntax-for-tools
          • Atc
          • Transformation-tools
            • Simpadd0
            • Proof-generation
            • Split-gso
            • Wrap-fn
              • Wrap-fn-implementation
                • Initdeclor-list-wrap-fn-add-wrapper-def
                • Declor-wrap-fn-add-wrapper-def
                • Fundef-wrap-fn-add-wrapper-def
                • Extdecl-wrap-fn-add-wrapper-def
                • Decl-wrap-fn-add-wrapper-def
                • Extdecl-list-wrap-fn
                • Wrap-fn-process-param-declon-list-loop
                • Filepath-transunit-map-wrap-fn
                • Wrap-fn-process-param-declon-list
                • Transunit-wrap-fn
                • Transunit-ensemble-wrap-fn
                • Code-ensemble-wrap-fn
                  • Code-ensemble-wrap-fn-multiple
                  • Declor-wrap-fn-make-wrapper
                  • Dirdeclor-wrap-fn-make-wrapper
                  • Wrap-fn-input-processing
                  • Wrap-fn-event-generation
              • Constant-propagation
              • Specialize
              • Split-fn
              • Split-fn-when
              • Split-all-gso
              • Copy-fn
              • Variables-in-computation-states
              • Rename
              • Utilities
              • Proof-generation-theorems
              • Input-processing
            • Language
            • Representation
            • Insertion-sort
            • Pack
          • Soft
          • Bv
          • Imp-language
          • Ethereum
          • Event-macros
          • Java
          • Riscv
          • Bitcoin
          • Zcash
          • Yul
          • ACL2-programming-language
          • Prime-fields
          • Json
          • Syntheto
          • File-io-light
          • Cryptography
          • Number-theory
          • Axe
          • Lists-light
          • Builtins
          • Solidity
          • Helpers
          • Htclient
          • Typed-lists-light
          • Arithmetic-light
        • X86isa
        • Axe
        • Execloader
      • Math
      • Testing-utilities
    • Wrap-fn-implementation

    Code-ensemble-wrap-fn

    Transform a code ensemble.

    Signature
    (code-ensemble-wrap-fn code target-name wrapper-name?) 
      → 
    (mv er? code$)
    Arguments
    code — Guard (code-ensemblep code).
    target-name — Guard (identp target-name).
    wrapper-name? — Guard (ident-optionp wrapper-name?).
    Returns
    er? — Type (maybe-msgp er?).
    code$ — Type (code-ensemblep code$).

    The target-name is the function to be wrapped. wrapper-name?, if it is non-nil, is the suggested name of the wrapper function. If no suggestion is provided, a name will be generated.

    Definitions and Theorems

    Function: code-ensemble-wrap-fn

    (defun code-ensemble-wrap-fn (code target-name wrapper-name?)
      (declare (xargs :guard (and (code-ensemblep code)
                                  (identp target-name)
                                  (ident-optionp wrapper-name?))))
      (declare (xargs :guard (code-ensemble-annop code)))
      (b* (((reterr) (c$::code-ensemble-fix code))
           ((code-ensemble code) code)
           ((erp transunits)
            (transunit-ensemble-wrap-fn code.transunits
                                        target-name wrapper-name?)))
        (retok (change-code-ensemble code
                                     :transunits transunits))))

    Theorem: maybe-msgp-of-code-ensemble-wrap-fn.er?

    (defthm maybe-msgp-of-code-ensemble-wrap-fn.er?
      (b* (((mv ?er? ?code$)
            (code-ensemble-wrap-fn code target-name wrapper-name?)))
        (maybe-msgp er?))
      :rule-classes :rewrite)

    Theorem: code-ensemblep-of-code-ensemble-wrap-fn.code$

    (defthm code-ensemblep-of-code-ensemble-wrap-fn.code$
      (b* (((mv ?er? ?code$)
            (code-ensemble-wrap-fn code target-name wrapper-name?)))
        (code-ensemblep code$))
      :rule-classes :rewrite)

    Theorem: code-ensemble-wrap-fn-of-code-ensemble-fix-code

    (defthm code-ensemble-wrap-fn-of-code-ensemble-fix-code
      (equal (code-ensemble-wrap-fn (c$::code-ensemble-fix code)
                                    target-name wrapper-name?)
             (code-ensemble-wrap-fn code target-name wrapper-name?)))

    Theorem: code-ensemble-wrap-fn-code-ensemble-equiv-congruence-on-code

    (defthm code-ensemble-wrap-fn-code-ensemble-equiv-congruence-on-code
     (implies
      (c$::code-ensemble-equiv code code-equiv)
      (equal
          (code-ensemble-wrap-fn code target-name wrapper-name?)
          (code-ensemble-wrap-fn code-equiv target-name wrapper-name?)))
     :rule-classes :congruence)

    Theorem: code-ensemble-wrap-fn-of-ident-fix-target-name

    (defthm code-ensemble-wrap-fn-of-ident-fix-target-name
      (equal (code-ensemble-wrap-fn code (ident-fix target-name)
                                    wrapper-name?)
             (code-ensemble-wrap-fn code target-name wrapper-name?)))

    Theorem: code-ensemble-wrap-fn-ident-equiv-congruence-on-target-name

    (defthm code-ensemble-wrap-fn-ident-equiv-congruence-on-target-name
     (implies
      (c$::ident-equiv target-name target-name-equiv)
      (equal
          (code-ensemble-wrap-fn code target-name wrapper-name?)
          (code-ensemble-wrap-fn code target-name-equiv wrapper-name?)))
     :rule-classes :congruence)

    Theorem: code-ensemble-wrap-fn-of-ident-option-fix-wrapper-name?

    (defthm code-ensemble-wrap-fn-of-ident-option-fix-wrapper-name?
      (equal (code-ensemble-wrap-fn code target-name
                                    (ident-option-fix wrapper-name?))
             (code-ensemble-wrap-fn code target-name wrapper-name?)))

    Theorem: code-ensemble-wrap-fn-ident-option-equiv-congruence-on-wrapper-name?

    (defthm
     code-ensemble-wrap-fn-ident-option-equiv-congruence-on-wrapper-name?
     (implies
      (c$::ident-option-equiv wrapper-name? wrapper-name?-equiv)
      (equal
          (code-ensemble-wrap-fn code target-name wrapper-name?)
          (code-ensemble-wrap-fn code target-name wrapper-name?-equiv)))
     :rule-classes :congruence)