Function

GLibHashTableforeach_remove

Declaration

guint
g_hash_table_foreach_remove (
  GHashTable* hash_table,
  GHRFunc func,
  gpointer user_data
)

Description

Calls the given function for each key/value pair in the GHashTable. If the function returns TRUE, then the key/value pair is removed from the GHashTable. If you supplied key or value destroy functions when creating the GHashTable, they are used to free the memory allocated for the removed keys and values.

See GHashTableIter for an alternative way to loop over the key/value pairs in the hash table.

Parameters

hash_table

Type: GHashTable

A GHashTable.

The data is owned by the caller of the function.
func

Type: GHRFunc

The function to call for each key/value pair.

user_data

Type: gpointer

User data to pass to the function.

The argument can be NULL.
The data is owned by the caller of the function.

Return value

Type: guint

The number of key/value pairs removed.