Add vt_list test suite.

Vipon · Vipon · commit 9613e116ccc7 · 2026-02-23T21:51:15.000+01:00
diff --git a/cTools/libs/containers/tests/CMakeLists.txt b/cTools/libs/containers/tests/CMakeLists.txt
@@ -20,6 +20,12 @@
 # OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 # SOFTWARE.
 
+add_vipon_test(
+  NAME vt_list_test
+  SOURCES vt_list_test.c
+  LINK_LIBS vt_containers mem comdef
+)
+
 add_vipon_test(
   NAME vt_vector_test
   SOURCES vt_vector_test.c
@@ -37,4 +43,3 @@ add_vipon_test(
   SOURCES vt_stack_test.c
   LINK_LIBS vt_containers mem comdef
 )
-
diff --git a/cTools/libs/containers/vt_list.c b/cTools/libs/containers/vt_list.c
@@ -25,16 +25,11 @@
 #include "mem.h"
 #include "vt_list.h"
 
-vt_list_t *
-vt_list_create(size_t data_size)
+void
+vt_list_init(vt_list_t *l, size_t elem_size)
 {
-    vt_list_t *l = Malloc(sizeof(vt_list_t));
-    if (l == NULL)
-        return NULL;
-
-    l->size = data_size;
+    l->elem_size = elem_size;
     l->first = NULL;
-    return l;
 }
 
 static void
@@ -52,16 +47,15 @@ vt_list_elems_free(vt_list_elem_t *cur)
 }
 
 void
-vt_list_free(vt_list_t *l)
+vt_list_fini(vt_list_t *l)
 {
     if (l == NULL)
         return;
 
-    l->size = (size_t)-1;
+    l->elem_size = (size_t)-1;
     vt_list_elems_free(l->first);
 
     l->first = NULL;
-    free(l);
 }
 
 static vt_list_elem_t *
@@ -71,8 +65,8 @@ create_list_elem(const vt_list_t *l, const void *data)
     if (new_elem == NULL)
         return NULL;
 
-    new_elem->data = Malloc(l->size);
-    directCopyBytes(data, new_elem->data, l->size);
+    new_elem->data = Malloc(l->elem_size);
+    directCopyBytes(data, new_elem->data, l->elem_size);
     new_elem->next = NULL;
 
     return new_elem;
diff --git a/cTools/libs/containers/vt_list.h b/cTools/libs/containers/vt_list.h
@@ -1,7 +1,7 @@
 /***
  * MIT License
  *
- * Copyright (c) 2024 Konychev Valera
+ * Copyright (c) 2024-2026 Konychev Valera
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -35,22 +35,62 @@ typedef struct vt_list_elem_t {
 } vt_list_elem_t;
 
 typedef struct vt_list_t {
-    size_t         size;
+    size_t         elem_size;
     vt_list_elem_t *first;
 } vt_list_t ;
 
-EXPORT_FUNC vt_list_t *
-vt_list_create(size_t data_size);
+/***
+ * @brief
+ * @param[in] l Pointer to the vector.
+ * @param[in] i Iterator pointer.
+ */
+#define VT_LIST_FOR_EACH(lp, i) \
+    for (i = (lp)->first; i != NULL; i = i->next)
+
+/**
+ * \brief Initiates list.
+ *
+ * \param[in] l Point to list needed to be initialized.
+ * \param[in] elem_size Size of type should be stored in the list.
+ */
+EXPORT_FUNC void
+vt_list_init(vt_list_t *l, size_t elem_size);
 
+/**
+ * \brief Finalizes list at the pointer \param l.
+ *
+ * \param[in] l Point to list needed to be finalized.
+ */
 EXPORT_FUNC void
-vt_list_free(vt_list_t *l);
+vt_list_fini(vt_list_t *l);
 
+/**
+ * \brief Add \param data at the begin of the list \param l.
+ *
+ * \param[in] l Point to list.
+ * \param[in] data Point to data need to be added at the begin
+ *
+ * \return 0 if success. -1 if fail.
+ */
 EXPORT_FUNC int
 vt_list_insert_at_begin(vt_list_t *l, const void *data);
 
+/**
+ * \brief Append \param data to the list \param l.
+ *
+ * \param[in] l Point to list.
+ * \param[in] data Point to data need to be appended
+ *
+ * \return 0 if success. -1 if fail.
+ */
 EXPORT_FUNC int
 vt_list_append(vt_list_t *l, const void *data);
 
+/**
+ * \brief Reverse list \param l.
+ *
+ * \param[in] l Point to the list.
+ */
 EXPORT_FUNC void
 vt_list_reverse(vt_list_t *l);
 
diff --git a/cTools/libs/containers/vt_vector.h b/cTools/libs/containers/vt_vector.h
@@ -71,7 +71,7 @@ EXPORT_FUNC int
 vt_vector_init(vt_vector_t *v, size_t capacity, size_t elem_size);
 
 /**
- * \brief Finalizes vector sotred at the pointer \param src.
+ * \brief Finalizes vector sotred at the pointer \param v.
  *
  * \param[in] v Point to vector needed to be finalized.
  */
diff --git a/cTools/libs/test/test.h b/cTools/libs/test/test.h
@@ -1,7 +1,7 @@
 /***
  * MIT License
  *
- * Copyright (c) 2021 Konychev Valera
+ * Copyright (c) 2021-2026 Konychev Valera
  *
  * Permission is hereby granted, free of charge, to any person obtaining a copy
  * of this software and associated documentation files (the "Software"), to deal
@@ -31,29 +31,29 @@
 #ifndef __cplusplus
     #include <stdlib.h>
 
-    #define EXPECT_FUNC_EQ(func, res)          \
-        if ((func) != (res)) {                 \
+    #define EXPECT_FUNC_EQ(func, result)          \
+        if ((func) != (result)) {                 \
             VT_ERROR(STRINGIZE(func) " fail"); \
             exit(EXIT_FAILURE);                \
         }
 
-    #define EXPECT_VAL_EQ(val, res, format)                              \
-        if ((val) != (res)) {                                            \
-            VT_ERROR("expect: " format " result: " format, (val), (res));\
-            exit(EXIT_FAILURE);                                          \
+    #define EXPECT_VAL_EQ(expect, result, format)                              \
+        if ((expect) != (result)) {                                            \
+            VT_ERROR("expect: " format " result: " format, (expect), (result));\
+            exit(EXIT_FAILURE);                                                \
         }
 
-    #define EXPECT_VAL_NOT_EQ(val, res, format) \
-        if ((val) == (res)) {                   \
-            VT_ERROR(format);                   \
-            exit(EXIT_FAILURE);                 \
+    #define EXPECT_VAL_NOT_EQ(expect, result, format) \
+        if ((expect) == (result)) {                   \
+            VT_ERROR(format);                         \
+            exit(EXIT_FAILURE);                       \
         }
 
-    #define EXPECT_BYTE_EQ(val, res)    EXPECT_VAL_EQ(val, res, "%.2x")
-    #define EXPECT_INT_EQ(val, res)     EXPECT_VAL_EQ(val, res, "%d")
-    #define EXPECT_SIZET_EQ(val, res)   EXPECT_VAL_EQ(val, res, "%zu")
-    #define EXPECT_BOOL_EQ(val, res)    EXPECT_VAL_EQ(val, res, "%d")
-    #define EXPECT_POINTER_EQ(val, res) EXPECT_VAL_EQ(val, res, "%p")
+    #define EXPECT_BYTE_EQ(expect, result)    EXPECT_VAL_EQ(expect, result, "%.2x")
+    #define EXPECT_INT_EQ(expect, result)     EXPECT_VAL_EQ(expect, result, "%d")
+    #define EXPECT_SIZET_EQ(expect, result)   EXPECT_VAL_EQ(expect, result, "%zu")
+    #define EXPECT_BOOL_EQ(expect, result)    EXPECT_VAL_EQ(expect, result, "%d")
+    #define EXPECT_POINTER_EQ(expect, result) EXPECT_VAL_EQ(expect, result, "%p")
 
     #define EXPECT_STR_EQ(str0, str1)                        \
         if (strcmp(str0, str1)) {                            \

Original file line number	Diff line number	Diff line change
`@@ -71,7 +71,7 @@ EXPORT_FUNC int`
`71`	`71`	`vt_vector_init(vt_vector_t *v, size_t capacity, size_t elem_size);`
`72`	`72`
`73`	`73`	`/**`
`74`		`- * \brief Finalizes vector sotred at the pointer \param src.`
	`74`	`+ * \brief Finalizes vector sotred at the pointer \param v.`
`75`	`75`	`*`
`76`	`76`	`* \param[in] v Point to vector needed to be finalized.`
`77`	`77`	`*/`