hashtable-delete! - remove an association from a hashtable

LIBRARY

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

SYNOPSIS

(hashtable-delete! hashtable key)

DESCRIPTION

Removes any association for key within hashtable.

RETURN VALUES

Returns unspecified values.

EXAMPLES

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

COMPATIBILITY

This procedure is unique to R6RS.

ERRORS

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.

SEE ALSO

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

STANDARDS

R6RS

HISTORY

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

AUTHORS

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

Markup created by unroff 1.0sc,    March 04, 2023.