		Search-engine friendly clone of the ACL2 documentation.

Error-checking

Ensure-function/lambda-no-stobjs

Cause an error if a function or lambda expression has input or output stobjs.

Signature
(ensure-function/lambda-no-stobjs stobjs-in stobjs-out description error-erp error-val ctx state) → (mv erp val state)
Arguments: stobjs-in — stobjs-in list of the function or lambda expression whose stobjs are to be checked.
Guard (symbol-listp stobjs-in).; stobjs-out — stobjs-out list of the function or lambda expression whose stobjs are to be checked.
Guard (symbol-listp stobjs-out).; description — Guard (msgp description).; error-erp — Flag to return in case of error.; error-val — Value to return in case of error.; ctx — Context for errors.
Returns: erp — Type (implies erp (equal erp error-erp)).; val — Type (and (implies erp (equal val error-val)) (implies (and (not erp) error-erp) (not val))) .

This error-checking function is useful after calling ensure-function/macro/lambda (which returns the stobjs-in and stobjs-out lists) to handle functions and lambda expressions uniformly. The description parameter should describe the function or lambda expression.

Definitions and Theorems

Function: ensure-function/lambda-no-stobjs

(defun ensure-function/lambda-no-stobjs
       (stobjs-in stobjs-out description
                  error-erp error-val ctx state)
  (declare (xargs :stobjs (state)))
  (declare (xargs :guard (and (symbol-listp stobjs-in)
                              (symbol-listp stobjs-out)
                              (msgp description))))
  (b* (((unless (and (all-nils stobjs-in)
                     (all-nils stobjs-out)))
        (er-soft+ ctx error-erp error-val
                  "~@0 must have no input or output stobjs."
                  description)))
    (value nil)))

Theorem: return-type-of-ensure-function/lambda-no-stobjs.erp

(defthm return-type-of-ensure-function/lambda-no-stobjs.erp
  (b* (((mv ?erp ?val ?state)
        (ensure-function/lambda-no-stobjs
             stobjs-in stobjs-out description
             error-erp error-val ctx state)))
    (implies erp (equal erp error-erp)))
  :rule-classes :rewrite)

Theorem: return-type-of-ensure-function/lambda-no-stobjs.val

(defthm return-type-of-ensure-function/lambda-no-stobjs.val
  (b* (((mv ?erp ?val ?state)
        (ensure-function/lambda-no-stobjs
             stobjs-in stobjs-out description
             error-erp error-val ctx state)))
    (and (implies erp (equal val error-val))
         (implies (and (not erp) error-erp)
                  (not val))))
  :rule-classes :rewrite)

Subtopics

Ensure-function/lambda-no-stobjs$: Calls ensure-function/lambda-no-stobjs with ctx and state as the last two arguments.