diff options
Diffstat (limited to 'gir/glib-2.0.c')
-rw-r--r-- | gir/glib-2.0.c | 20 |
1 files changed, 14 insertions, 6 deletions
diff --git a/gir/glib-2.0.c b/gir/glib-2.0.c index cb671c7a..76876983 100644 --- a/gir/glib-2.0.c +++ b/gir/glib-2.0.c @@ -633,6 +633,9 @@ * to iterate over the elements of a #GHashTable. GHashTableIter * structures are typically allocated on the stack and then initialized * with g_hash_table_iter_init(). + * + * The iteration order of a #GHashTableIter over the keys/values in a hash + * table is not defined. */ @@ -5746,11 +5749,7 @@ * |[<!-- language="C" --> * #define G_SPAWN_ERROR g_spawn_error_quark () * - * GQuark - * g_spawn_error_quark (void) - * { - * return g_quark_from_static_string ("g-spawn-error-quark"); - * } + * G_DEFINE_QUARK (g-spawn-error-quark, g_spawn_error) * ]| * * - The quark function for the error domain is called @@ -6466,7 +6465,9 @@ * * To call a function for each key and value pair use * g_hash_table_foreach() or use an iterator to iterate over the - * key/value pairs in the hash table, see #GHashTableIter. + * key/value pairs in the hash table, see #GHashTableIter. The iteration order + * of a hash table is not defined, and you must not rely on iterating over + * keys/values in the same order as they were inserted. * * To destroy a #GHashTable use g_hash_table_destroy(). * @@ -17352,6 +17353,9 @@ * items). To remove all items matching a predicate, use * g_hash_table_foreach_remove(). * + * The order in which g_hash_table_foreach() iterates over the keys/values in + * the hash table is not defined. + * * See g_hash_table_find() for performance caveats for linear * order searches in contrast to g_hash_table_lookup(). */ @@ -17512,6 +17516,10 @@ * Initializes a key/value pair iterator and associates it with * @hash_table. Modifying the hash table after calling this function * invalidates the returned iterator. + * + * The iteration order of a #GHashTableIter over the keys/values in a hash + * table is not defined. + * * |[<!-- language="C" --> * GHashTableIter iter; * gpointer key, value; |