source: branches/1.1.x/src/org/armedbear/lisp/make-hash-table.lisp

Last change on this file was 13309, checked in by Mark Evenson, 13 years ago

Implementation of hashtables with weak keys and/or values.

MAKE-HASH-TABLE now has an optional :WEAKNESS argument that can take
the values :KEY, :VALUE, :KEY-AND-VALUE, or :KEY-OR-VALUE. :KEY means
that the key of an entry must be live to guarantee that the entry is
preserved. VALUE means that the value of an entry must be live to
guarantee that the entry is preserved. :KEY-AND-VALUE means that both
the key and the value must be live to guarantee that the entry is
preserved. :KEY-OR-VALUE means that either the key or the value must
be live to guarantee that the entry is preserved.

The tests simply excercise the various types of weak hash tables
enough that a GC phase should show that the table indeed does decrease
in size.

Changed the defition of functions in HashTableFunctions? to match
current docstring/pf_XXX() naming conventions.

This implementation is only lightly tested in single-threaded use, and
untested in multiple threading scenarios.

Addresses ticket:140.

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
File size: 2.4 KB
Line 
1;;; make-hash-table.lisp
2;;;
3;;; Copyright (C) 2003-2005 Peter Graves
4;;; $Id: make-hash-table.lisp 13309 2011-06-07 15:38:11Z mevenson $
5;;;
6;;; This program is free software; you can redistribute it and/or
7;;; modify it under the terms of the GNU General Public License
8;;; as published by the Free Software Foundation; either version 2
9;;; of the License, or (at your option) any later version.
10;;;
11;;; This program is distributed in the hope that it will be useful,
12;;; but WITHOUT ANY WARRANTY; without even the implied warranty of
13;;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14;;; GNU General Public License for more details.
15;;;
16;;; You should have received a copy of the GNU General Public License
17;;; along with this program; if not, write to the Free Software
18;;; Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
19;;;
20;;; As a special exception, the copyright holders of this library give you
21;;; permission to link this library with independent modules to produce an
22;;; executable, regardless of the license terms of these independent
23;;; modules, and to copy and distribute the resulting executable under
24;;; terms of your choice, provided that you also meet, for each linked
25;;; independent module, the terms and conditions of the license of that
26;;; module.  An independent module is a module which is not derived from
27;;; or based on this library.  If you modify this library, you may extend
28;;; this exception to your version of the library, but you are not
29;;; obligated to do so.  If you do not wish to do so, delete this
30;;; exception statement from your version.
31
32(in-package #:system)
33
34(defun make-hash-table (&key (test 'eql) (size 11) (rehash-size 1.5)
35                             (rehash-threshold 0.75)
36                             (weakness nil))
37  (setf test (coerce-to-function test))
38  (unless (and (integerp size) (>= size 0))
39    (error 'type-error :datum size :expected-type '(integer 0)))
40  (let ((size (max 11 (min size array-dimension-limit)))
41        (weakness-types '(or (eql :key) (eql :value)
42                             (eql :key-and-value)
43                             (eql :key-or-value))))
44    (if weakness
45        (if (not (typep weakness weakness-types))
46            (error 'type-error :datum weakness 
47                   :expected-type weakness-types)
48            (%make-weak-hash-table test size rehash-size 
49                                   rehash-threshold weakness))
50  (%make-hash-table test size 
51                          rehash-size rehash-threshold))))
52
53   
54 
Note: See TracBrowser for help on using the repository browser.