1 /* GLIB - Library of useful routines for C programming
2 * Copyright (C) 1995-1997 Peter Mattis, Spencer Kimball and Josh MacDonald
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the
16 * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 * Boston, MA 02111-1307, USA.
21 * Modified by the GLib Team and others 1997-2000. See the AUTHORS
22 * file for a list of people on the GLib Team. See the ChangeLog
23 * files for a list of changes. These files are distributed with
24 * GLib at ftp://ftp.gtk.org/pub/gtk/.
27 #if defined(G_DISABLE_SINGLE_INCLUDES) && !defined (__GLIB_H_INSIDE__) && !defined (GLIB_COMPILATION)
28 #error "Only <glib.h> can be included directly."
34 #include <glib/gtypes.h>
35 #include <glib/glist.h>
39 typedef struct _GHashTable GHashTable
;
41 typedef gboolean (*GHRFunc
) (gpointer key
,
45 typedef struct _GHashTableIter GHashTableIter
;
47 struct _GHashTableIter
60 GHashTable
* g_hash_table_new (GHashFunc hash_func
,
61 GEqualFunc key_equal_func
);
62 GHashTable
* g_hash_table_new_full (GHashFunc hash_func
,
63 GEqualFunc key_equal_func
,
64 GDestroyNotify key_destroy_func
,
65 GDestroyNotify value_destroy_func
);
66 void g_hash_table_destroy (GHashTable
*hash_table
);
67 void g_hash_table_insert (GHashTable
*hash_table
,
70 void g_hash_table_replace (GHashTable
*hash_table
,
73 gboolean
g_hash_table_remove (GHashTable
*hash_table
,
75 void g_hash_table_remove_all (GHashTable
*hash_table
);
76 gboolean
g_hash_table_steal (GHashTable
*hash_table
,
78 void g_hash_table_steal_all (GHashTable
*hash_table
);
79 gpointer
g_hash_table_lookup (GHashTable
*hash_table
,
81 gboolean
g_hash_table_lookup_extended (GHashTable
*hash_table
,
82 gconstpointer lookup_key
,
85 void g_hash_table_foreach (GHashTable
*hash_table
,
88 gpointer
g_hash_table_find (GHashTable
*hash_table
,
91 guint
g_hash_table_foreach_remove (GHashTable
*hash_table
,
94 guint
g_hash_table_foreach_steal (GHashTable
*hash_table
,
97 guint
g_hash_table_size (GHashTable
*hash_table
);
98 GList
* g_hash_table_get_keys (GHashTable
*hash_table
);
99 GList
* g_hash_table_get_values (GHashTable
*hash_table
);
101 void g_hash_table_iter_init (GHashTableIter
*iter
,
102 GHashTable
*hash_table
);
103 gboolean
g_hash_table_iter_next (GHashTableIter
*iter
,
106 GHashTable
* g_hash_table_iter_get_hash_table (GHashTableIter
*iter
);
107 void g_hash_table_iter_remove (GHashTableIter
*iter
);
108 void g_hash_table_iter_steal (GHashTableIter
*iter
);
110 /* keeping hash tables alive */
111 GHashTable
* g_hash_table_ref (GHashTable
*hash_table
);
112 void g_hash_table_unref (GHashTable
*hash_table
);
114 #ifndef G_DISABLE_DEPRECATED
117 * g_hash_table_freeze:
118 * @hash_table: a #GHashTable
120 * This function is deprecated and will be removed in the next major
121 * release of GLib. It does nothing.
123 #define g_hash_table_freeze(hash_table) ((void)0)
127 * @hash_table: a #GHashTable
129 * This function is deprecated and will be removed in the next major
130 * release of GLib. It does nothing.
132 #define g_hash_table_thaw(hash_table) ((void)0)
134 #endif /* G_DISABLE_DEPRECATED */
138 gboolean
g_str_equal (gconstpointer v1
,
140 guint
g_str_hash (gconstpointer v
);
142 gboolean
g_int_equal (gconstpointer v1
,
144 guint
g_int_hash (gconstpointer v
);
146 gboolean
g_int64_equal (gconstpointer v1
,
148 guint
g_int64_hash (gconstpointer v
);
150 gboolean
g_double_equal (gconstpointer v1
,
152 guint
g_double_hash (gconstpointer v
);
154 /* This "hash" function will just return the key's address as an
155 * unsigned integer. Useful for hashing on plain addresses or
156 * simple integer values.
157 * Passing NULL into g_hash_table_new() as GHashFunc has the
158 * same effect as passing g_direct_hash().
160 guint
g_direct_hash (gconstpointer v
) G_GNUC_CONST
;
161 gboolean
g_direct_equal (gconstpointer v1
,
162 gconstpointer v2
) G_GNUC_CONST
;
166 #endif /* __G_HASH_H__ */