hashtable-delete! - remove an association from a hashtable

(import (rnrs))                     ;R6RS
(import (rnrs hashtables))          ;R6RS

(hashtable-delete! hashtable key)

Removes any association for key within hashtable.

Returns unspecified values.

(let ((ht (make-eq-hashtable)))
  (hashtable-set! ht 'foo 0)
  (hashtable-delete! ht 'foo)
  (hashtable-delete! ht 'bar)
  (hashtable-size ht))
    => 0

This procedure is unique to R6RS.

This procedure can raise exceptions with the following condition types:

&assertion (R6RS)

The wrong number of arguments was passed or an argument was outside its domain. In particular, hashtable should be a mutable hashtable and key should be in the domain of the hashtable's hash and equal functions.

hashtable-clear!(3scm), hashtable-set!(3scm)

R6RS

This procedure first appeared in R6RS. An equivalent procedure can be found in SRFI-69 under the name hash-table-delete!.

This page is part of the scheme-manpages project. It includes materials from the RnRS documents. More information can be found at https://weinholt.se/scheme/manpages/.