Bug 558672 – NULL key lookup using g_hash_table_lookup_extended()

2008-11-04  Christian Dywan  <christian@imendio.com>

	Bug 558672 – NULL key lookup using g_hash_table_lookup_extended()

	* glib/ghash.c:
	Clarify g_hash_table_lookup_extended

svn path=/trunk/; revision=7644

diff --git a/ChangeLog b/ChangeLog
index a9246b8b3f0d005493cbe5a2c9f290c14c700f67..e1c9b6372723ac5f6c7b58066229eb96788d8ae8 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2008-11-04  Christian Dywan  <christian@imendio.com>
+
+       Bug 558672 – NULL key lookup using g_hash_table_lookup_extended()
+
+       * glib/ghash.c:
+       Clarify g_hash_table_lookup_extended
+
 2008-11-02  Tor Lillqvist  <tml@novell.com>
 
        * configure.in: Expand also build/win32/vs9/Makefile.

diff --git a/glib/ghash.c b/glib/ghash.c
index efc2707d3308905760883604a675ce62ca37b85d..ba332669dc1b5c93b614f46ca243501fb40477b0 100644 (file)
--- a/glib/ghash.c
+++ b/glib/ghash.c
@@ -788,16 +788,19 @@ g_hash_table_lookup (GHashTable   *hash_table,
 
 /**
  * g_hash_table_lookup_extended:
- * @hash_table: a #GHashTable.
- * @lookup_key: the key to look up.
- * @orig_key: returns the original key.
- * @value: returns the value associated with the key.
+ * @hash_table: a #GHashTable
+ * @lookup_key: the key to look up
+ * @orig_key: return location for the original key, or %NULL
+ * @value: return location for the value associated with the key, or %NULL
  *
  * 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.
+ *
  * Return value: %TRUE if the key was found in the #GHashTable.
  **/
 gboolean