Changeset 45226285 in mainline

Timestamp:

2025-04-09T14:19:50Z (12 days ago)

Author:

Jiří Zárevúcky <zarevucky.jiri@…>

Branches:

master

Children:

17964f6, 3e7948c

Parents:

0db0df2

Message:

Clarify the purpose and use of hash_table_foreach()

File:

• common/include/adt/hash_table.h (modified) (1 diff)

common/include/adt/hash_table.h ¶

@@ -85 +85 @@
         member_to_inst((item), type, member)
 
+/** Iterate over all entries associated with a given key.
+ * For iterating over all entries regardless of key, use hash_table_apply().
+ *
+ * Example:
+ * struct ht_entry {
+ *     ht_link_t my_link_member;
+ *     void *data;
+ *     int my_key;
+ * }
+ *
+ * hash_table_t *table = ...;
+ * int key = ...;
+ *
+ * hash_table_foreach(table, &key, my_link_member, struct ht_entry, item) {
+ *     _print_entry_data(item->data);
+ * }
+ */
 #define hash_table_foreach(ht, key, member, itype, iterator) \
         for (itype *iterator = NULL; \