4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License, Version 1.0 only
6 * (the "License"). You may not use this file except in compliance
9 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10 * or http://www.opensolaris.org/os/licensing.
11 * See the License for the specific language governing permissions
12 * and limitations under the License.
14 * When distributing Covered Code, include this CDDL HEADER in each
15 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16 * If applicable, add the following below this CDDL HEADER, with the
17 * fields enclosed by brackets "[]" replaced with your own identifying
18 * information: Portions Copyright [yyyy] [name of copyright owner]
23 * Copyright 2001-2003 Sun Microsystems, Inc. All rights reserved.
24 * Use is subject to license terms.
27 #pragma ident "%Z%%M% %I% %E% SMI"
30 * Create, manage, and destroy association lists. alists are arrays with
31 * arbitrary index types, and are also commonly known as associative arrays.
41 #define ALIST_HASH_SIZE 997
45 void (*al_namefree
)(void *);
46 void (*al_valfree
)(void *);
49 typedef struct alist_el
{
55 alist_hash(int nbuckets
, alist_el_t
*el
)
57 uintptr_t num
= (uintptr_t)el
->ale_name
;
59 return (num
% nbuckets
);
63 alist_cmp(alist_el_t
*el1
, alist_el_t
*el2
)
65 return ((uintptr_t)el1
->ale_name
!= (uintptr_t)el2
->ale_name
);
69 alist_xnew(int nbuckets
, void (*namefree
)(void *),
70 void (*valfree
)(void *), int (*hashfn
)(int, void *),
71 int (*cmpfn
)(void *, void *))
75 alist
= xcalloc(sizeof (alist_t
));
76 alist
->al_elements
= hash_new(nbuckets
, hashfn
, cmpfn
);
77 alist
->al_namefree
= namefree
;
78 alist
->al_valfree
= valfree
;
84 alist_new(void (*namefree
)(void *), void (*valfree
)(void *))
86 return (alist_xnew(ALIST_HASH_SIZE
, namefree
, valfree
,
87 (int (*)())alist_hash
, (int (*)())alist_cmp
));
91 alist_free_cb(alist_el_t
*el
, alist_t
*alist
)
93 if (alist
->al_namefree
)
94 alist
->al_namefree(el
->ale_name
);
95 if (alist
->al_valfree
)
96 alist
->al_valfree(el
->ale_name
);
101 alist_free(alist_t
*alist
)
103 hash_free(alist
->al_elements
, (void (*)())alist_free_cb
, alist
);
108 alist_add(alist_t
*alist
, void *name
, void *value
)
112 el
= xmalloc(sizeof (alist_el_t
));
114 el
->ale_value
= value
;
115 hash_add(alist
->al_elements
, el
);
119 alist_find(alist_t
*alist
, void *name
, void **value
)
121 alist_el_t
template, *ret
;
123 template.ale_name
= name
;
124 if (!hash_find(alist
->al_elements
, &template, (void **)&ret
))
128 *value
= ret
->ale_value
;
133 typedef struct alist_iter_data
{
134 int (*aid_func
)(void *, void *, void *);
139 alist_iter_cb(alist_el_t
*el
, alist_iter_data_t
*aid
)
141 return (aid
->aid_func(el
->ale_name
, el
->ale_value
, aid
->aid_priv
));
145 alist_iter(alist_t
*alist
, int (*func
)(void *, void *, void *), void *private)
147 alist_iter_data_t aid
;
150 aid
.aid_priv
= private;
152 return (hash_iter(alist
->al_elements
, (int (*)())alist_iter_cb
, &aid
));
156 * Debugging support. Used to print the contents of an alist.
160 alist_stats(alist_t
*alist
, int verbose
)
162 printf("Alist statistics\n");
163 hash_stats(alist
->al_elements
, verbose
);
166 static int alist_def_print_cb_key_int
= 1;
167 static int alist_def_print_cb_value_int
= 1;
170 alist_def_print_cb(void *key
, void *value
)
173 if (alist_def_print_cb_key_int
== 1)
174 printf("%5d ", (int)key
);
176 printf("%s\n", (char *)key
);
179 if (alist_def_print_cb_value_int
== 1)
180 printf("%5d\n", (int)value
);
182 printf("%s\n", (char *)key
);
188 alist_dump_cb(void *node
, void *private)
190 int (*printer
)(void *, void *) = (int (*)())private;
191 alist_el_t
*el
= node
;
193 printer(el
->ale_name
, el
->ale_value
);
199 alist_dump(alist_t
*alist
, int (*printer
)(void *, void *))
202 printer
= alist_def_print_cb
;
204 return (hash_iter(alist
->al_elements
, alist_dump_cb
, (void *)printer
));