		Search-engine friendly clone of the ACL2 documentation.

Omaps

Restrict

Restrict an omap to a set of keys.

Signature
(restrict keys map) → map1
Arguments: keys — Guard (setp keys).; map — Guard (mapp map).
Returns: map1 — Type (mapp map1).

This drops all the keys of the omap that are not in the given set of keys.

Definitions and Theorems

Function: restrict

(defun restrict (keys map)
  (declare (xargs :guard (and (setp keys) (mapp map))))
  (let ((__function__ 'restrict))
    (declare (ignorable __function__))
    (cond ((empty map) nil)
          (t (mv-let (key val)
                     (head map)
               (if (set::in key keys)
                   (update key val (restrict keys (tail map)))
                 (restrict keys (tail map))))))))

Theorem: mapp-of-restrict

(defthm mapp-of-restrict
  (b* ((map1 (restrict keys map)))
    (mapp map1))
  :rule-classes :rewrite)

Theorem: restrict-when-left-empty

(defthm restrict-when-left-empty
  (implies (set::empty keys)
           (equal (restrict keys map) nil))
  :rule-classes (:rewrite :type-prescription))

Theorem: restrict-when-right-empty

(defthm restrict-when-right-empty
  (implies (empty map)
           (equal (restrict keys map) nil))
  :rule-classes (:rewrite :type-prescription))