Function
GLibHashTablelookup_extended
Declaration [src]
gboolean
g_hash_table_lookup_extended (
GHashTable* hash_table,
gconstpointer lookup_key,
gpointer* orig_key,
gpointer* value
)
Description [src]
Looks up a key in the GHashTable
, returning the original key and the
associated value and a #gboolean which is TRUE
if the key was found. This
is useful if you need to free the memory allocated for the original key,
for example before calling g_hash_table_remove().
You can actually pass NULL
for lookup_key
to test
whether the NULL
key exists, provided the hash and equal functions
of hash_table
are NULL
-safe.
Parameters
hash_table
-
Type:
GHashTable
A
GHashTable
.The data is owned by the caller of the function. lookup_key
-
Type:
gconstpointer
The key to look up.
The argument can be NULL
.The data is owned by the caller of the function. orig_key
-
Type:
gpointer*
Return location for the original key.
The argument will be set by the function. The argument can be NULL
. value
-
Type:
gpointer*
Return location for the value associated with the key.
The argument will be set by the function. The argument can be NULL
.