Merge branch 'ghrfunc-doc' into 'main'

ghash: Fix the documentation of GHRFunc

See merge request GNOME/glib!4192
This commit is contained in:
Philip Withnall 2024-08-15 10:22:07 +00:00
commit 67b4a27569

View File

@ -124,16 +124,21 @@
* GHRFunc: * GHRFunc:
* @key: a key * @key: a key
* @value: the value associated with the key * @value: the value associated with the key
* @user_data: user data passed to g_hash_table_remove() * @user_data: user data passed to the calling function
* *
* Specifies the type of the function passed to * Specifies the type of the function passed to
* g_hash_table_foreach_remove(). It is called with each key/value * [func@GLib.HashTable.find], [func@GLib.HashTable.foreach_remove], and
* pair, together with the @user_data parameter passed to * [func@GLib.HashTable.foreach_steal].
* g_hash_table_foreach_remove(). It should return %TRUE if the *
* key/value pair should be removed from the #GHashTable. * The function is called with each key/value pair, together with
* the @user_data parameter passed to the calling function.
*
* The function should return true if the key/value pair should be
* selected, meaning it has been found or it should be removed from the
* [struct@GLib.HashTable], depending on the calling function.
* *
* Returns: %TRUE if the key/value pair should be removed from the * Returns: true if the key/value pair should be selected, and
* #GHashTable * false otherwise
*/ */
/** /**