编写 ring buffer 模块功能,包括 init,read,write,destory等函数;ring buffer 称作环形缓冲区，也称作环形队列(circular queue)，是一种用于表示一个固定尺寸、头尾相连的缓冲区的数据结构，适合缓存数据流。

环形缓冲区（Ring Buffer）或环形队列是一种在内存中连续存储数据的数据结构，它的特点是元素按照FIFO（先进先出）原则进出，并且在满或空时可以无缝地循环读写。编写环形缓冲区模块主要包括以下几个核心函数：

1. **init** 函数（初始化函数）：用于创建一个新的环形缓冲区，指定其大小（最大元素数）以及初始状态，比如指针位置设置为起始位置。

void init(RingBuffer* buffer, size_t capacity) {
   buffer->head = 0;
   buffer->tail = 0;
   buffer->data = malloc(capacity * sizeof(void*));
}

这里，`buffer->head`和`buffer->tail`分别记录当前已读取和写入的位置，`buffer->data`是存放元素的实际数组。

2. **read** 函数：从缓冲区读取数据。如果缓冲区非空，即`head != tail`，则将`head`向后移动一位，返回对应位置的数据；若缓冲区为空，则返回NULL或特殊标记。

void* read(RingBuffer* buffer) {
   if (buffer->tail == buffer->head) {
       return NULL; // 或者返回一个特殊标志
   }
   void* data = buffer->data[buffer->head];
   buffer->head = (buffer->head + 1) % buffer->capacity;
   return data;
}

3. **write** 函数：往缓冲区写入数据。首先检查缓冲区是否已满，即`head == (tail + 1) % capacity`。如果不满，将新数据放入`buffer->data[tail]`，然后更新`tail`，如果满了则拒绝插入并可能触发溢出处理。

bool write(RingBuffer* buffer, const void* data) {
   if ((buffer->tail + 1) % buffer->capacity == buffer->head) {
       // Buffer overflow, handle it here
       return false;
   }
   buffer->data[buffer->tail] = data;
   buffer->tail = (buffer->tail + 1) % buffer->capacity;
   return true;
}

4. **destroy** 函数（析构函数或释放函数）：当不再需要环形缓冲区时，释放先前分配的内存空间。

void destroy(RingBuffer* buffer) {
   free(buffer->data);
   buffer->head = buffer->tail = 0;
   buffer->data = NULL;
}