cKit/Foundation/c_LinkQueue.t.c

#include "c_LinkQueue.h"
#include "c_Test.h"

// 专门用于测试测试的值复制结构体
typedef struct {
    int log_level;
    uint32_t timestamp;
} LogMessage_t;

TEST_CASE(test_link_queue_closure_and_memory_layout) {
    c_LinkQueue_t queue;

    // 初始化一个专门存放 LogMessage_t 结构的泛型单向链式队列
    ASSERT_INT_EQ(C_ERR_OK, c_LinkQueue_Init(&queue, sizeof(LogMessage_t), NULL));
    ASSERT_TRUE(c_LinkQueue_IsEmpty(&queue));
    ASSERT_TRUE(queue.head == NULL);
    ASSERT_TRUE(queue.tail == NULL);

    LogMessage_t msg1 = { .log_level = 1, .timestamp = 11111 };
    LogMessage_t msg2 = { .log_level = 2, .timestamp = 22222 };
    LogMessage_t msg3 = { .log_level = 3, .timestamp = 33333 };

    // 1. 验证入队操作与二级指针空安全合并能力
    ASSERT_INT_EQ(C_ERR_OK, c_LinkQueue_Enqueue(&queue, &msg1)); // 第一次插入：head == tail == msg1
    ASSERT_PTR_NOT_NULL(queue.head);
    ASSERT_TRUE(queue.head == queue.tail);

    ASSERT_INT_EQ(C_ERR_OK, c_LinkQueue_Enqueue(&queue, &msg2)); // 正常挂接：head->msg1, tail->msg2
    ASSERT_INT_EQ(C_ERR_OK, c_LinkQueue_Enqueue(&queue, &msg3)); // 正常挂接：head->msg1, tail->msg3

    ASSERT_INT_EQ(3, c_LinkQueue_Size(&queue));

    // 强隔离隔离性检查：修改临时外部变量，内部数据不应被污染
    msg1.log_level = 999;

    // 2. 验证 Peek 窥探能力
    LogMessage_t* peeked = (LogMessage_t*)c_LinkQueue_Peek(&queue);
    ASSERT_PTR_NOT_NULL(peeked);
    ASSERT_INT_EQ(1, peeked->log_level); // 依旧是 1，证明值复制强屏障有效

    // 3. 【严苛验证变长内存布局的拓扑对齐情况】
    // 根据变长公式寻址：QUEUE_NODE_DATA(node) 必须与抛出的数据指针完全吻合
    ASSERT_TRUE(c_LinkQueueNode_Get(queue.head) == peeked);

    // 队尾节点的寻址验证
    LogMessage_t* tail_data = c_LinkQueueNode_Get(queue.tail);
    ASSERT_INT_EQ(3, tail_data->log_level);

    // 4. 出队顺序与先进先出（FIFO）及边界收缩断言 (Dequeue)
    LogMessage_t out_res;

    ASSERT_INT_EQ(C_ERR_OK, c_LinkQueue_Dequeue(&queue, &out_res));
    ASSERT_INT_EQ(1, out_res.log_level);
    ASSERT_INT_EQ(11111, out_res.timestamp);

    ASSERT_INT_EQ(C_ERR_OK, c_LinkQueue_Dequeue(&queue, &out_res));
    ASSERT_INT_EQ(2, out_res.log_level);

    // 此时队列只剩最后一个元素 msg3，head 应当等同于 tail
    ASSERT_TRUE(queue.head == queue.tail);
    ASSERT_INT_EQ(1, c_LinkQueue_Size(&queue));

    // 最后一个元素出队，迫使尾指针恢复到你指定的 0 纯净空空空状态
    ASSERT_INT_EQ(C_ERR_OK, c_LinkQueue_Dequeue(&queue, &out_res));
    ASSERT_INT_EQ(3, out_res.log_level);

    // 终极下溢复位检查
    ASSERT_TRUE(c_LinkQueue_IsEmpty(&queue));
    ASSERT_TRUE(queue.head == NULL);
    ASSERT_TRUE(queue.tail == NULL);

    // 防御重复下溢出队，应当报错拒绝
    ASSERT_INT_EQ(C_ERR_OUTOFBOUND, c_LinkQueue_Dequeue(&queue, &out_res));

    c_LinkQueue_Destroy(&queue);
}

int main(void) {
    TEST_START(C_LinkQueue_Generic_Layout_Tests);
    RUN_TEST(test_link_queue_closure_and_memory_layout);
    TEST_REPORT();
    RETURN_TEST_STATUS;
}