summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorMichael Brown2024-02-14 17:01:43 +0100
committerMichael Brown2024-02-14 17:25:21 +0100
commit88b291d647686ac686a5614fdd7be92b48747360 (patch)
treea480bfc224f2b43b02bd588becaa1ce424987eef
parent[build] Fix build failures with older versions of gcc (diff)
downloadipxe-88b291d647686ac686a5614fdd7be92b48747360.tar.gz
ipxe-88b291d647686ac686a5614fdd7be92b48747360.tar.xz
ipxe-88b291d647686ac686a5614fdd7be92b48747360.zip
[list] Add list_is_head_entry()
Signed-off-by: Michael Brown <mcb30@ipxe.org>
-rw-r--r--src/include/ipxe/list.h11
-rw-r--r--src/tests/list_test.c16
2 files changed, 27 insertions, 0 deletions
diff --git a/src/include/ipxe/list.h b/src/include/ipxe/list.h
index 8de25498..53edfc9f 100644
--- a/src/include/ipxe/list.h
+++ b/src/include/ipxe/list.h
@@ -399,6 +399,17 @@ extern void extern_list_splice_tail_init ( struct list_head *list,
( (head)->prev == &(entry)->member )
/**
+ * Test if entry is the list head
+ *
+ * @v entry List entry
+ * @v head List head
+ * @v member Name of list field within iterator's type
+ * @ret is_head Entry is the list head
+ */
+#define list_is_head_entry( entry, head, member ) \
+ ( (head) == &(entry)->member )
+
+/**
* Iterate over a list
*
* @v pos Iterator
diff --git a/src/tests/list_test.c b/src/tests/list_test.c
index d5b5c65d..f18c63f2 100644
--- a/src/tests/list_test.c
+++ b/src/tests/list_test.c
@@ -440,6 +440,22 @@ static void list_test_exec ( void ) {
ok ( list_is_first_entry ( &list_tests[3], list, list ) );
ok ( list_is_last_entry ( &list_tests[3], list, list ) );
+ /* Test list_is_head_entry() */
+ INIT_LIST_HEAD ( list );
+ list_add_tail ( &list_tests[1].list, list );
+ list_add_tail ( &list_tests[6].list, list );
+ list_add_tail ( &list_tests[8].list, list );
+ ok ( list_is_head_entry ( list_entry ( list, typeof ( *pos ), list ),
+ list, list ) );
+ ok ( ! list_is_head_entry ( &list_tests[1], list, list ) );
+ ok ( ! list_is_head_entry ( &list_tests[6], list, list ) );
+ ok ( ! list_is_head_entry ( &list_tests[8], list, list ) );
+ list_for_each_entry ( pos, list, list ) {
+ ok ( list_contains_entry ( pos, list, list ) );
+ ok ( ! list_is_head_entry ( pos, list, list ) );
+ }
+ ok ( list_is_head_entry ( pos, list, list ) );
+
/* Test list_for_each() */
INIT_LIST_HEAD ( list );
list_add_tail ( &list_tests[6].list, list );