avltree: Add sdb_avltree_iter_peek_next().

[sysdb.git] / src / include / utils / avltree.h

diff --git a/src/include/utils/avltree.h b/src/include/utils/avltree.h
index de51c7e07dfa007f020a6f6c53017ad55171588c..ba495c665ff6e884c2e6d6efdf308b5fc3c1ec79 100644 (file)
--- a/src/include/utils/avltree.h
+++ b/src/include/utils/avltree.h
@@ -113,6 +113,18 @@ sdb_avltree_iter_has_next(sdb_avltree_iter_t *iter);
 sdb_object_t *
 sdb_avltree_iter_get_next(sdb_avltree_iter_t *iter);
 
+/*
+ * sdb_avltree_iter_peek_next:
+ * Peek at the next node, if there is one. This is similar to has_next() but
+ * it returns the actual next element without advancing the iterator.
+ *
+ * Returns:
+ *  - the next node, if there is one
+ *  - NULL else
+ */
+sdb_object_t *
+sdb_avltree_iter_peek_next(sdb_avltree_iter_t *iter);
+
 /*
  * sdb_avltree_size:
  * Returns the number of nodes in the tree.