Function: map-delete

map-delete is a byte-compiled function defined in map.el.gz.

Signature

(map-delete MAP KEY)

Documentation

Delete KEY in-place from MAP and return MAP.

Keys not present in MAP are ignored.

Note that if MAP is a list (either alist or plist), and you're deleting the final element in the list, the list isn't actually destructively modified (but the return value will reflect the deletion). So if you're using this method on a list, you have to say

  (setq map (map-delete map key))

for this to work reliably.

Probably introduced at or before Emacs version 28.1.

Implementations

(map-delete (MAP array) KEY) in `map.el'.

Store nil at index KEY.

(map-delete (MAP hash-table) KEY) in `map.el'.

Undocumented

(map-delete (MAP list) KEY) in `map.el'.

Undocumented

Source Code

;; Defined in /usr/src/emacs/lisp/emacs-lisp/map.el.gz
(cl-defgeneric map-delete (map key)
  "Delete KEY in-place from MAP and return MAP.
Keys not present in MAP are ignored.

Note that if MAP is a list (either alist or plist), and you're
deleting the final element in the list, the list isn't actually
destructively modified (but the return value will reflect the
deletion).  So if you're using this method on a list, you have to
say

  (setq map (map-delete map key))

for this to work reliably.")