• Top
    • Documentation
    • Books
    • Boolean-reasoning
    • Projects
    • Debugging
    • 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
        • Soft
        • C
        • Bv
        • Imp-language
        • Event-macros
          • Evmac-input-hints-p
          • Evmac-input-print-p
          • Function-definedness
          • Event-macro-input-processing
          • Event-macro-screen-printing
          • Make-event-terse
          • Event-macro-applicability-conditions
          • Event-macro-results
          • Template-generators
          • Event-macro-event-generators
          • Event-macro-proof-preparation
          • Try-event
          • Restore-output?
          • Restore-output
          • Fail-event
            • Cw-event
            • Event-macro-xdoc-constructors
            • Event-macro-intro-macros
          • Java
          • Bitcoin
          • Ethereum
          • Yul
          • Zcash
          • ACL2-programming-language
          • Prime-fields
          • Json
          • Syntheto
          • File-io-light
          • Cryptography
          • Number-theory
          • Lists-light
          • Axe
          • Builtins
          • Solidity
          • Helpers
          • Htclient
          • Typed-lists-light
          • Arithmetic-light
        • X86isa
        • Axe
        • Execloader
      • Math
      • Testing-utilities
    • Event-macros

    Fail-event

    An event that always fails with a specified error context, flag, value, and message.

    This is realized by always generating a soft error (via er-soft+) during the expansion phase of make-event. The error context, flag, value, and message passed to this macro are not evaluated.

    The use of make-event-terse instead of make-event avoids any screen output other than the specified error message.

    This macro is used by try-event.

    Macro: fail-event

    (defmacro fail-event (ctx erp val msg)
     (declare (xargs :guard (msgp msg)))
     (cons
      'make-event-terse
      (cons
       (cons 'er-soft+
             (cons (cons 'quote (cons ctx 'nil))
                   (cons (cons 'quote (cons erp 'nil))
                         (cons (cons 'quote (cons val 'nil))
                               (cons '"~@0"
                                     (cons (cons 'quote (cons msg 'nil))
                                           'nil))))))
       'nil)))