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.