xref: /illumos-gate/usr/src/lib/libpool/common/dict.h (revision f012ee0c3db17469b492c2cf757226f3d7b1ebbc)
1 /*
2  * CDDL HEADER START
3  *
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
7  * with the License.
8  *
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.
13  *
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]
19  *
20  * CDDL HEADER END
21  */
22 /*
23  * Copyright 2003 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 #ifndef	_DICT_H
28 #define	_DICT_H
29 
30 #pragma ident	"%Z%%M%	%I%	%E% SMI"
31 
32 #ifdef	__cplusplus
33 extern "C" {
34 #endif
35 
36 typedef struct dict_hdl dict_hdl_t;
37 
38 /*
39  * Hash functions
40  */
41 
42 extern uint64_t		hash_buf(const void *, size_t);
43 extern uint64_t		hash_str(const char *);
44 
45 /*
46  * Dictionary functions
47  */
48 extern void		dict_free(dict_hdl_t **);
49 extern uint64_t		dict_length(dict_hdl_t *);
50 extern dict_hdl_t	*dict_new(int (*)(const void *, const void *),
51     uint64_t (*)(const void *));
52 
53 /*
54  * Dictionary entry functions
55  */
56 
57 extern void		*dict_get(dict_hdl_t *, const void *);
58 extern void		*dict_put(dict_hdl_t *, const void *, void *);
59 extern void		*dict_remove(dict_hdl_t *, const void *);
60 
61 extern void		dict_map(dict_hdl_t *,
62     void (*)(const void *, void **, void *), void *);
63 
64 /*
65  * Dictionary conversion
66  */
67 
68 #ifdef	__cplusplus
69 }
70 #endif
71 
72 #endif	/* _DICT_H */
73