HashTable.this

Creates a new #GHashTable like g_hash_table_new() with a reference count of 1 and allows to specify functions to free the memory allocated for the key and value that get called when removing the entry from the #GHashTable.

Since version 2.42 it is permissible for destroy notify functions to recursively remove further items from the hash table. This is only permissible if the application still holds a reference to the hash table. This means that you may need to ensure that the hash table is empty by calling g_hash_table_remove_all() before releasing the last reference using g_hash_table_unref().

  1. this(GHashTable* gHashTable, bool ownedRef)
  2. this(GHashFunc hashFunc, GEqualFunc keyEqualFunc)
  3. this(GHashFunc hashFunc, GEqualFunc keyEqualFunc, GDestroyNotify keyDestroyFunc, GDestroyNotify valueDestroyFunc)

Parameters

hashFunc GHashFunc

a function to create a hash value from a key

keyEqualFunc GEqualFunc

a function to check two keys for equality

keyDestroyFunc GDestroyNotify

a function to free the memory allocated for the key used when removing the entry from the #GHashTable, or %NULL if you don't want to supply such a function.

valueDestroyFunc GDestroyNotify

a function to free the memory allocated for the value used when removing the entry from the #GHashTable, or %NULL if you don't want to supply such a function.

Return Value

a new #GHashTable

Throws

ConstructionException GTK+ fails to create the object.

Meta