From f778564ba2c389856904de3cc80126d7cfb988c2 Mon Sep 17 00:00:00 2001 From: Simon McVittie Date: Tue, 4 Oct 2011 09:48:35 +0100 Subject: [PATCH] Be clear that g_str_hash etc. don't accept NULL This covers the str, double, int, int64 hash and equal functions, but not anything that takes an "object", since the convention is that "object methods" never accept NULL anyway. Bug: https://bugzilla.gnome.org/show_bug.cgi?id=592715 Signed-off-by: Simon McVittie Reviewed-by: Colin Walters --- glib/ghash.c | 23 +++++++++++++++-------- 1 file changed, 15 insertions(+), 8 deletions(-) diff --git a/glib/ghash.c b/glib/ghash.c index 68e75c0..e0d2d42 100644 --- a/glib/ghash.c +++ b/glib/ghash.c @@ -1609,7 +1609,8 @@ g_hash_table_get_values (GHashTable *hash_table) * * Compares two strings for byte-by-byte equality and returns %TRUE * if they are equal. It can be passed to g_hash_table_new() as the - * @key_equal_func parameter, when using strings as keys in a #GHashTable. + * @key_equal_func parameter, when using non-%NULL strings as keys in a + * #GHashTable. * * Note that this function is primarily meant as a hash table comparison * function. For a general-purpose, %NULL-safe string comparison function, @@ -1640,7 +1641,7 @@ g_str_equal (gconstpointer v1, * function uses the signed value of each byte. * * It can be passed to g_hash_table_new() as the @hash_func parameter, - * when using strings as keys in a #GHashTable. + * when using non-%NULL strings as keys in a #GHashTable. * * Returns: a hash value corresponding to the key */ @@ -1706,7 +1707,8 @@ g_direct_equal (gconstpointer v1, * Compares the two #gint values being pointed to and returns * %TRUE if they are equal. * It can be passed to g_hash_table_new() as the @key_equal_func - * parameter, when using pointers to integers as keys in a #HashTable. + * parameter, when using non-%NULL pointers to integers as keys in a + * #GHashTable. * * Note that this function acts on pointers to #gint, not on #gint directly: * if your hash table's keys are of the form @@ -1727,7 +1729,7 @@ g_int_equal (gconstpointer v1, * * Converts a pointer to a #gint to a hash value. * It can be passed to g_hash_table_new() as the @hash_func parameter, - * when using pointers to integers values as keys in a #GHashTable. + * when using non-%NULL pointers to integer values as keys in a #GHashTable. * * Note that this function acts on pointers to #gint, not on #gint directly: * if your hash table's keys are of the form @@ -1749,7 +1751,8 @@ g_int_hash (gconstpointer v) * Compares the two #gint64 values being pointed to and returns * %TRUE if they are equal. * It can be passed to g_hash_table_new() as the @key_equal_func - * parameter, when using pointers to 64-bit integers as keys in a #GHashTable. + * parameter, when using non-%NULL pointers to 64-bit integers as keys in a + * #GHashTable. * * Returns: %TRUE if the two keys match. * @@ -1767,8 +1770,10 @@ g_int64_equal (gconstpointer v1, * @v: a pointer to a #gint64 key * * Converts a pointer to a #gint64 to a hash value. + * * It can be passed to g_hash_table_new() as the @hash_func parameter, - * when using pointers to 64-bit integers values as keys in a #GHashTable. + * when using non-%NULL pointers to 64-bit integer values as keys in a + * #GHashTable. * * Returns: a hash value corresponding to the key. * @@ -1788,7 +1793,8 @@ g_int64_hash (gconstpointer v) * Compares the two #gdouble values being pointed to and returns * %TRUE if they are equal. * It can be passed to g_hash_table_new() as the @key_equal_func - * parameter, when using pointers to doubles as keys in a #GHashTable. + * parameter, when using non-%NULL pointers to doubles as keys in a + * #GHashTable. * * Returns: %TRUE if the two keys match. * @@ -1807,7 +1813,8 @@ g_double_equal (gconstpointer v1, * * Converts a pointer to a #gdouble to a hash value. * It can be passed to g_hash_table_new() as the @hash_func parameter, - * when using pointers to doubles as keys in a #GHashTable. + * It can be passed to g_hash_table_new() as the @hash_func parameter, + * when using non-%NULL pointers to doubles as keys in a #GHashTable. * * Returns: a hash value corresponding to the key. * -- 2.7.4