chore: automated publish

Author: github-actions[bot]

public/blog/2025-07-13/index.pdf

@@ -0,0 +1,75 @@
+\title{"深入理解并实现基本的循环缓冲区（Circular Buffer）数据结构"}
+\author{"黄京"}
+\date{"Jul 13, 2025"}
+\maketitle
+在数据流处理场景中，如实时音视频传输或网络数据包处理，传统线性缓冲区常面临空间浪费和频繁内存拷贝的问题。循环缓冲区（Circular Buffer）作为一种高效的数据结构，通过逻辑环形设计实现了空间复用和避免数据搬迁的核心优势。其时间复杂度为常数级 $O(1)$，适用于生产者-消费者模型、嵌入式系统内存受限环境以及网络数据队列如 Linux 内核的 \texttt{kfifo}。例如，在音频流缓冲中，循环缓冲区能确保数据连续处理而不中断，显著提升系统性能。\par
+\chapter{循环缓冲区核心原理}
+循环缓冲区的核心在于使用数组模拟逻辑环形结构，通过两个关键指针管理数据：\texttt{head}（写指针）指向下一个可写入位置，\texttt{tail}（读指针）指向下一个可读取位置。判空与判满是设计难点，常见策略包括预留一个空位方案，其判满条件为 $(head + 1) \mod size == tail$，表示缓冲区满；判空则为 $head == tail$。另一种方案是独立计数器记录元素数量，或 Linux 内核采用的镜像位标记法，通过高位镜像避免取模运算。指针移动遵循公式 $head = (head + 1) \mod size$，确保在数组边界处无缝回绕至起始位置，实现环形效果。不同状态如空、半满或满可通过指针相对位置描述：当 \texttt{head} 和 \texttt{tail} 重合时为空，当 $(head + 1) \mod size == tail$ 时为满。\par
+\chapter{循环缓冲区实现（C 语言示例）}
+循环缓冲区的 C 语言实现基于结构体定义核心组件，包括数据存储数组、缓冲区容量及读写指针。以下代码定义数据结构：\par
+\begin{lstlisting}[language=c]
+typedef struct {
+    uint8_t *buffer;  // 存储数据的数组指针
+    size_t size;      // 缓冲区总容量（元素数量）
+    size_t head;      // 写指针（指向下一个写入位置）
+    size_t tail;      // 读指针（指向下一个读取位置）
+} circular_buffer_t;
+\end{lstlisting}
+此结构体中，\texttt{buffer} 指向动态分配的数组内存，\texttt{size} 指定固定容量，\texttt{head} 和 \texttt{tail} 初始化为 0 表示空缓冲区。初始化函数 \texttt{cb\_{}init} 分配内存并重置指针：\par
+\begin{lstlisting}[language=c]
+void cb_init(circular_buffer_t *cb, size_t size) {
+    cb->buffer = malloc(size);  // 分配大小为 size 的字节数组
+    cb->size = size;            // 设置容量
+    cb->head = cb->tail = 0;    // 初始读写指针归零，表示空状态
+}
+\end{lstlisting}
+该函数通过 \texttt{malloc} 动态分配数组，确保 \texttt{head} 和 \texttt{tail} 起始一致以标识空缓冲区。判空和判满函数基于预留空位方案实现：\par
+\begin{lstlisting}[language=c]
+bool cb_is_empty(circular_buffer_t *cb) {
+    return cb->head == cb->tail;  // 指针重合即为空
+}
+
+bool cb_is_full(circular_buffer_t *cb) {
+    return (cb->head + 1) % cb->size == cb->tail;  // 写指针加一模 size 等于读指针即为满
+}
+\end{lstlisting}
+判空检查指针是否相等，判满使用取模运算确保环形回绕。写入函数 \texttt{cb\_{}push} 处理数据插入：\par
+\begin{lstlisting}[language=c]
+void cb_push(circular_buffer_t *cb, uint8_t data) {
+    cb->buffer[cb->head] = data;                 // 在 head 位置写入数据
+    cb->head = (cb->head + 1) % cb->size;        // 更新 head 指针
+    if (cb_is_full(cb)) {                        // 缓冲区满时丢弃旧数据
+        cb->tail = (cb->tail + 1) % cb->size;    // 移动 tail 覆盖最早数据
+    }
+}
+\end{lstlisting}
+此函数先将数据存入 \texttt{head} 位置，然后递增 \texttt{head} 指针并取模回绕。如果缓冲区满，则移动 \texttt{tail} 指针丢弃最旧数据，实现覆盖写入策略。读取函数 \texttt{cb\_{}pop} 处理数据提取：\par
+\begin{lstlisting}[language=c]
+bool cb_pop(circular_buffer_t *cb, uint8_t *data) {
+    if (cb_is_empty(cb)) return false;           // 空缓冲区返回失败
+    *data = cb->buffer[cb->tail];                // 从 tail 位置读取数据
+    cb->tail = (cb->tail + 1) % cb->size;        // 更新 tail 指针
+    return true;                                 // 成功读取
+}
+\end{lstlisting}
+该函数先检查空状态，失败则返回 \texttt{false}；否则从 \texttt{tail} 位置读取数据，递增 \texttt{tail} 指针并取模。线程安全扩展可通过互斥锁保护 \texttt{push/pop} 操作，或在高性能场景使用 CAS（Compare-and-Swap）原子操作实现无锁设计。\par
+\chapter{高级优化技巧}
+优化循环缓冲区的关键之一是避免昂贵的取模运算。通过约束缓冲区容量为 2 的幂（如 $size = 8$），可用位运算替代：公式 $head = (head + 1) \& (size - 1)$ 实现等价回绕，性能显著优于取模运算。例如，当 $size = 8$ 时，$size - 1 = 7$（二进制 \texttt{0111}），位与操作自动处理边界回绕。批量读写操作优化涉及分段拷贝策略，当数据跨越缓冲区末尾时，分两段使用 \texttt{memcpy}：\par
+\begin{lstlisting}[language=c]
+size_t cb_write(circular_buffer_t *cb, const uint8_t *data, size_t len) {
+    size_t to_end = cb->size - cb->head;          // 计算到数组末尾的连续空间
+    size_t first_part = (len > to_end) ? to_end : len;  // 第一段长度
+    memcpy(cb->buffer + cb->head, data, first_part);    // 拷贝第一段
+    if (len > first_part) {                       // 如果数据未完成
+        memcpy(cb->buffer, data + first_part, len - first_part);  // 拷贝剩余段至起始位置
+    }
+    cb->head = (cb->head + len) % cb->size;       // 更新 head 指针
+    return len;                                   // 返回写入长度
+}
+\end{lstlisting}
+此函数计算从 \texttt{head} 到数组末尾的连续空间，优先拷贝第一段；如果数据长度超限，剩余部分拷贝至数组起始处。这减少内存访问次数，提升吞吐量。Linux 内核 \texttt{kfifo} 采用镜像指示位法，使用指针高位作为镜像标记解决假溢出问题，并通过内存屏障确保多核一致性。\par
+\chapter{测试与边界处理}
+循环缓冲区的健壮性依赖于严格测试和边界防护。单元测试用例设计需覆盖关键场景：空缓冲区读取应返回失败标志；满缓冲区写入需验证覆盖策略是否丢弃旧数据；跨边界读写如容量 $size = 8$ 时写入 10 字节，检查数据是否正确分段存储。内存越界防护通过断言实现，例如在指针更新后添加 \texttt{assert(cb->head < cb->size)} 确保指针有效性；安全计数器可防止无限循环，如在遍历时限制迭代次数。\par
+\chapter{与其他数据结构的对比}
+循环缓冲区在数据流处理中优于动态数组和链表。其插入/删除复杂度为 $O(1)$，空间利用率高，适用于固定大小数据流；动态数组虽支持随机访问，但插入/删除需 $O(n)$ 时间，内存拷贝开销大；链表虽 $O(1)$ 插入/删除，但指针开销降低空间效率，适用于频繁增删场景。循环缓冲区在实时系统中平衡性能与复杂性，是高效数据处理的优选。\par
+循环缓冲区的本质是通过数组与指针数学模拟环形空间，以 $O(1)$ 操作实现高效数据流处理。扩展话题包括双缓冲区（Double Buffer）用于显示渲染以避免撕裂；实时系统如 FreeRTOS 消息队列的实现；以及 C++ STL 的 \texttt{std::circular\_{}buffer} 优化。最终建议强调：循环缓冲区是数据流处理的瑞士军刀——简单却强大，深入理解边界条件可在高性能编程中游刃有余。\par

public/blog/2025-07-13/index.tex

@@ -0,0 +1 @@
+4a4882cc35f848b75c60b6f2410e8cd28877759bb1c34b51572cc41e37498205