tor

commit cf22841e3bf45a8b73900dd480022f1722d3b557
parent da15448eb873e0787760bd7c7e47a138a1493d1f
Author: Nick Mathewson <nickm@torproject.org>
Date:   Thu, 21 Nov 2019 11:56:42 -0500

ht.h: improve documentation for HT_NEXT_RMV.

Diffstat:
M
src/ext/ht.h
 | 
6
++++--

1 file changed, 4 insertions(+), 2 deletions(-)
diff --git a/src/ext/ht.h b/src/ext/ht.h
@@ -370,7 +370,8 @@ ht_string_hash(const char *s)
   /* Return the next element in 'head' after 'elm', under the arbitrary \
    * order used by HT_START.  If there are no more elements, return     \
    * NULL.  If 'elm' is to be removed from the table, you must call     \
-   * this function for the next value before you remove it.             \
+   * this function for the next value before you remove it, or use      \
+   * HT_NEXT_RMV instead.                                               \
    */                                                                   \
   ATTR_UNUSED static inline struct type **                              \
   name##_HT_NEXT(struct name *head, struct type **elm)                  \
@@ -392,6 +393,8 @@ ht_string_hash(const char *s)
       return NULL;                                                      \
     }                                                                   \
   }                                                                     \
+  /* As HT_NEXT, but also remove the current element 'elm' from the     \
+   * table. */                                                          \
   ATTR_UNUSED static inline struct type **                              \
   name##_HT_NEXT_RMV(struct name *head, struct type **elm)              \
   {                                                                     \
@@ -617,4 +620,3 @@ ht_string_hash(const char *s)
 */
 
 #endif
-