summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-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 );