A Macro Defined Ring Buffer(C Language)

最新推荐文章于 2025-05-18 00:01:37 发布

原创最新推荐文章于 2025-05-18 00:01:37 发布 · 652 阅读

0 ·

CC 4.0 BY-SA版权

文章标签：

#buffer #c #struct

本文深入探讨了RingBuffer（或FIFO）数据结构的关键特性，包括如何使用宏定义来初始化、读取和写入数据，以及如何计算其内部计数和检查是否为空或满。着重介绍了该数据结构在不同场景中的高效应用。

/*******************************************************************************************\
* Ring Buffer(or FIFO)                                                                      *
* Caution: RING_BUF_SIZE must be 2^n                                                        *
\*******************************************************************************************/
#define RING_BUF_SIZE               (512)
#define RING_BUF_MASK               (RING_BUF_SIZE-1ul)
#define RING_BUF_RESET(rBuf)        (rBuf.rdIdx = rBuf.wrIdx = 0)
#define RING_BUF_WR(rBuf, dataIn)   (rBuf.data[RING_BUF_MASK & rBuf.wrIdx++] = (dataIn))
#define RING_BUF_RD(rBuf)           (rBuf.data[RING_BUF_MASK & rBuf.rdIdx++])
#define RING_BUF_COUNT(rBuf)        (RING_BUF_MASK & (rBuf.wrIdx - rBuf.rdIdx))
#define RING_BUF_EMPTY(rBuf)        (RING_BUF_COUNT(rBuf) == 0)
#define RING_BUF_FULL(rBuf)         (RING_BUF_COUNT(rBuf) == RING_BUF_MASK)

typedef struct __RING_BUF_T
{
  unsigned char data[RING_BUF_SIZE];
  unsigned int wrIdx;
  unsigned int rdIdx;
} RING_BUF_T;