Change Guile license to LGPLv3+
[bpt/guile.git] / libguile / hashtab.h
CommitLineData
0f2d19dd
JB
1/* classes: h_files */
2
0527e687
DH
3#ifndef SCM_HASHTAB_H
4#define SCM_HASHTAB_H
5
102dbb6f 6/* Copyright (C) 1995,1996,1999,2000,2001, 2003, 2004, 2006, 2008 Free Software Foundation, Inc.
0527e687 7 *
73be1d9e 8 * This library is free software; you can redistribute it and/or
53befeb7
NJ
9 * modify it under the terms of the GNU Lesser General Public License
10 * as published by the Free Software Foundation; either version 3 of
11 * the License, or (at your option) any later version.
0527e687 12 *
53befeb7
NJ
13 * This library is distributed in the hope that it will be useful, but
14 * WITHOUT ANY WARRANTY; without even the implied warranty of
73be1d9e
MV
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Lesser General Public License for more details.
0527e687 17 *
73be1d9e
MV
18 * You should have received a copy of the GNU Lesser General Public
19 * License along with this library; if not, write to the Free Software
53befeb7
NJ
20 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
21 * 02110-1301 USA
73be1d9e 22 */
0527e687 23
0f2d19dd 24\f
0527e687 25
5e044c02 26#include "libguile/__scm.h"
0f2d19dd 27
c35738c1
MD
28#include "weaks.h"
29
30\f
31
32#define SCM_HASHTABLEF_WEAK_CAR SCM_WVECTF_WEAK_KEY
33#define SCM_HASHTABLEF_WEAK_CDR SCM_WVECTF_WEAK_VALUE
34
ecc9f40f 35SCM_API scm_t_bits scm_tc16_hashtable;
cdc5f676 36
f5710d53 37#define SCM_HASHTABLE_P(x) SCM_SMOB_PREDICATE (scm_tc16_hashtable, x)
c35738c1
MD
38#define SCM_VALIDATE_HASHTABLE(pos, arg) \
39 SCM_MAKE_VALIDATE_MSG (pos, arg, HASHTABLE_P, "hash-table")
f5710d53
MV
40#define SCM_HASHTABLE_VECTOR(h) SCM_SMOB_OBJECT (h)
41#define SCM_SET_HASHTABLE_VECTOR(x, v) SCM_SET_SMOB_OBJECT ((x), (v))
42#define SCM_HASHTABLE(x) ((scm_t_hashtable *) SCM_SMOB_DATA_2 (x))
43#define SCM_HASHTABLE_NEXT(x) SCM_SMOB_OBJECT_3 (x)
44#define SCM_HASHTABLE_NEXTLOC(x) SCM_SMOB_OBJECT_3_LOC (x)
45#define SCM_SET_HASHTABLE_NEXT(x, n) SCM_SET_SMOB_OBJECT_3 ((x), (n))
c35738c1
MD
46#define SCM_HASHTABLE_FLAGS(x) (SCM_HASHTABLE (x)->flags)
47#define SCM_HASHTABLE_WEAK_KEY_P(x) \
48 (SCM_HASHTABLE_FLAGS (x) & SCM_HASHTABLEF_WEAK_CAR)
49#define SCM_HASHTABLE_WEAK_VALUE_P(x) \
50 (SCM_HASHTABLE_FLAGS (x) & SCM_HASHTABLEF_WEAK_CDR)
51#define SCM_HASHTABLE_DOUBLY_WEAK_P(x) \
52 ((SCM_HASHTABLE_FLAGS (x) \
53 & (SCM_HASHTABLEF_WEAK_CAR | SCM_HASHTABLEF_WEAK_CDR)) \
54 == (SCM_HASHTABLEF_WEAK_CAR | SCM_HASHTABLEF_WEAK_CDR))
55#define SCM_HASHTABLE_WEAK_P(x) SCM_HASHTABLE_FLAGS (x)
56#define SCM_HASHTABLE_N_ITEMS(x) (SCM_HASHTABLE (x)->n_items)
57#define SCM_SET_HASHTABLE_N_ITEMS(x, n) (SCM_HASHTABLE (x)->n_items = n)
58#define SCM_HASHTABLE_INCREMENT(x) (SCM_HASHTABLE_N_ITEMS(x)++)
59#define SCM_HASHTABLE_DECREMENT(x) (SCM_HASHTABLE_N_ITEMS(x)--)
60#define SCM_HASHTABLE_UPPER(x) (SCM_HASHTABLE (x)->upper)
61#define SCM_HASHTABLE_LOWER(x) (SCM_HASHTABLE (x)->lower)
62
63#define SCM_HASHTABLE_N_BUCKETS(h) \
3ebc1832
MV
64 SCM_SIMPLE_VECTOR_LENGTH (SCM_HASHTABLE_VECTOR (h))
65#define SCM_HASHTABLE_BUCKET(h, i) \
66 SCM_SIMPLE_VECTOR_REF (SCM_HASHTABLE_VECTOR (h), i)
c35738c1 67#define SCM_SET_HASHTABLE_BUCKET(h, i, x) \
3ebc1832 68 SCM_SIMPLE_VECTOR_SET (SCM_HASHTABLE_VECTOR (h), i, x)
c35738c1
MD
69
70typedef struct scm_t_hashtable {
71 int flags; /* properties of table */
72 unsigned long n_items; /* number of items in table */
73 unsigned long lower; /* when to shrink */
74 unsigned long upper; /* when to grow */
75 int size_index; /* index into hashtable_size */
76 int min_size_index; /* minimum size_index */
d3a80924 77 unsigned long (*hash_fn) (); /* for rehashing after a GC. */
c35738c1
MD
78} scm_t_hashtable;
79
0f2d19dd 80\f
0f2d19dd 81
1cc91f1b 82#if 0
92c2555f
MV
83typedef unsigned int scm_t_hash_fn (SCM obj, unsigned int d, void *closure);
84typedef SCM scm_t_assoc_fn (SCM key, SCM alist, void *closure);
85typedef SCM scm_t_delete_fn (SCM elt, SCM list);
1cc91f1b 86#endif
0f2d19dd 87
f59a096e 88SCM_API SCM scm_vector_to_hash_table (SCM vector);
33b001fd 89SCM_API SCM scm_c_make_hash_table (unsigned long k);
f59a096e 90SCM_API SCM scm_make_hash_table (SCM n);
c35738c1
MD
91SCM_API SCM scm_make_weak_key_hash_table (SCM k);
92SCM_API SCM scm_make_weak_value_hash_table (SCM k);
93SCM_API SCM scm_make_doubly_weak_hash_table (SCM k);
94
95SCM_API SCM scm_hash_table_p (SCM h);
96SCM_API SCM scm_weak_key_hash_table_p (SCM h);
97SCM_API SCM scm_weak_value_hash_table_p (SCM h);
98SCM_API SCM scm_doubly_weak_hash_table_p (SCM h);
99
102dbb6f
LC
100SCM_INTERNAL void scm_i_rehash (SCM table, unsigned long (*hash_fn)(),
101 void *closure, const char *func_name);
102SCM_INTERNAL void scm_i_scan_weak_hashtables (void);
00ffa0e7 103
33b001fd
MV
104SCM_API SCM scm_hash_fn_get_handle (SCM table, SCM obj, unsigned long (*hash_fn) (), SCM (*assoc_fn) (), void * closure);
105SCM_API SCM scm_hash_fn_create_handle_x (SCM table, SCM obj, SCM init, unsigned long (*hash_fn) (), SCM (*assoc_fn) (), void * closure);
106SCM_API SCM scm_hash_fn_ref (SCM table, SCM obj, SCM dflt, unsigned long (*hash_fn) (), SCM (*assoc_fn) (), void * closure);
107SCM_API SCM scm_hash_fn_set_x (SCM table, SCM obj, SCM val, unsigned long (*hash_fn) (), SCM (*assoc_fn) (), void * closure);
a9cf5c71 108SCM_API SCM scm_hash_fn_remove_x (SCM table, SCM obj, unsigned long (*hash_fn) (), SCM (*assoc_fn) (), void * closure);
33b001fd 109SCM_API SCM scm_internal_hash_fold (SCM (*fn) (), void *closure, SCM init, SCM table);
711a9fd7 110SCM_API void scm_internal_hash_for_each_handle (SCM (*fn) (), void *closure, SCM table);
c35738c1 111SCM_API SCM scm_hash_clear_x (SCM table);
0f2d19dd 112
33b001fd
MV
113SCM_API SCM scm_hashq_get_handle (SCM table, SCM obj);
114SCM_API SCM scm_hashq_create_handle_x (SCM table, SCM obj, SCM init);
115SCM_API SCM scm_hashq_ref (SCM table, SCM obj, SCM dflt);
116SCM_API SCM scm_hashq_set_x (SCM table, SCM obj, SCM val);
117SCM_API SCM scm_hashq_remove_x (SCM table, SCM obj);
118SCM_API SCM scm_hashv_get_handle (SCM table, SCM obj);
119SCM_API SCM scm_hashv_create_handle_x (SCM table, SCM obj, SCM init);
120SCM_API SCM scm_hashv_ref (SCM table, SCM obj, SCM dflt);
121SCM_API SCM scm_hashv_set_x (SCM table, SCM obj, SCM val);
122SCM_API SCM scm_hashv_remove_x (SCM table, SCM obj);
123SCM_API SCM scm_hash_get_handle (SCM table, SCM obj);
124SCM_API SCM scm_hash_create_handle_x (SCM table, SCM obj, SCM init);
125SCM_API SCM scm_hash_ref (SCM table, SCM obj, SCM dflt);
126SCM_API SCM scm_hash_set_x (SCM table, SCM obj, SCM val);
127SCM_API SCM scm_hash_remove_x (SCM table, SCM obj);
128SCM_API SCM scm_hashx_get_handle (SCM hash, SCM assoc, SCM table, SCM obj);
129SCM_API SCM scm_hashx_create_handle_x (SCM hash, SCM assoc, SCM table, SCM obj, SCM init);
130SCM_API SCM scm_hashx_ref (SCM hash, SCM assoc, SCM table, SCM obj, SCM dflt);
131SCM_API SCM scm_hashx_set_x (SCM hash, SCM assoc, SCM table, SCM obj, SCM val);
a9cf5c71 132SCM_API SCM scm_hashx_remove_x (SCM hash, SCM assoc, SCM table, SCM obj);
33b001fd 133SCM_API SCM scm_hash_fold (SCM proc, SCM init, SCM hash);
c35738c1 134SCM_API SCM scm_hash_for_each (SCM proc, SCM hash);
711a9fd7
MD
135SCM_API SCM scm_hash_for_each_handle (SCM proc, SCM hash);
136SCM_API SCM scm_hash_map_to_list (SCM proc, SCM hash);
102dbb6f
LC
137SCM_INTERNAL void scm_hashtab_prehistory (void);
138SCM_INTERNAL void scm_init_hashtab (void);
0f2d19dd 139
0527e687 140#endif /* SCM_HASHTAB_H */
89e00824
ML
141
142/*
143 Local Variables:
144 c-file-style: "gnu"
145 End:
146*/