#include<stdio.h>
#define MAX_SIZE 1024
struct circ_buf {
char *buf;
int head;
int tail;
};
/* Return count in buffer. */
/*返回该缓冲区head-tail之间的差值*/
#define CIRC_CNT(head,tail,size) (((head) - (tail)) & ((size)-1))
/* Return space available, 0..size-1. We always leave one free char
as a completely full buffer has head == tail, which is the same as
empty. */
/*刨去head-tail之间的大小,整个缓冲区还有多少空间*/
#define CIRC_SPACE(head,tail,size) CIRC_CNT((tail),((head)+1),(size))
/* Return count up to the end of the buffer. Carefully avoid
accessing head and tail more than once, so they can change
underneath us without returning inconsistent results. */
/*head到整个缓冲区的结束位置被tail分成了两部分,取这两部分的最小值*/
#define CIRC_CNT_TO_END(head,tail,size) \
({int end = (size) - (tail); \
int n = ((head) + end) & ((size)-1); \
n < end ? n : end;})
/* Return space available up to the end of the buffer. */
/*返回head到整个缓冲区结尾有多少空间可以用*/
#define CIRC_SPACE_TO_END(head,tail,size) \
({int end = (size) - 1 - (head); \
int n = (end + (tail)) & ((size)-1); \
n <= end ? n : end+1;})
int main()
{
int ret = 0;
struct circ_buf circ;
circ.head = circ.tail = 0;
printf("cnt = %d \n", CIRC_CNT(circ.head, circ.tail, MAX_SIZE));
printf("space = %d \n", CIRC_SPACE(circ.head, circ.tail, MAX_SIZE));
printf("cnt to end = %d \n", CIRC_CNT_TO_END(circ.head, circ.tail, MAX_SIZE));
printf("space to end = %d \n\r\n", CIRC_SPACE_TO_END(circ.head, circ.tail, MAX_SIZE));
circ.head = 5;
printf("cnt = %d \n", CIRC_CNT(circ.head, circ.tail, MAX_SIZE));
printf("space = %d \n", CIRC_SPACE(circ.head, circ.tail, MAX_SIZE));
printf("cnt to end = %d \n", CIRC_CNT_TO_END(circ.head, circ.tail, MAX_SIZE));
printf("space to end = %d \n\r\n", CIRC_SPACE_TO_END(circ.head, circ.tail, MAX_SIZE));
circ.tail = 5;
printf("cnt = %d \n", CIRC_CNT(circ.head, circ.tail, MAX_SIZE));
printf("space = %d \n", CIRC_SPACE(circ.head, circ.tail, MAX_SIZE));
printf("cnt to end = %d \n", CIRC_CNT_TO_END(circ.head, circ.tail, MAX_SIZE));
printf("space to end = %d \n\r\n", CIRC_SPACE_TO_END(circ.head, circ.tail, MAX_SIZE));
circ.head = 15;
printf("cnt = %d \n", CIRC_CNT(circ.head, circ.tail, MAX_SIZE));
printf("space = %d \n", CIRC_SPACE(circ.head, circ.tail, MAX_SIZE));
printf("cnt to end = %d \n", CIRC_CNT_TO_END(circ.head, circ.tail, MAX_SIZE));
printf("space to end = %d \n\r\n", CIRC_SPACE_TO_END(circ.head, circ.tail, MAX_SIZE));
circ.tail = 10;
printf("cnt = %d \n", CIRC_CNT(circ.head, circ.tail, MAX_SIZE));
printf("space = %d \n", CIRC_SPACE(circ.head, circ.tail, MAX_SIZE));
printf("cnt to end = %d \n", CIRC_CNT_TO_END(circ.head, circ.tail, MAX_SIZE));
printf("space to end = %d \n\r\n", CIRC_SPACE_TO_END(circ.head, circ.tail, MAX_SIZE));
circ.tail = 800;
printf("cnt = %d \n", CIRC_CNT(circ.head, circ.tail, MAX_SIZE));
printf("space = %d \n", CIRC_SPACE(circ.head, circ.tail, MAX_SIZE));
printf("cnt to end = %d \n", CIRC_CNT_TO_END(circ.head, circ.tail, MAX_SIZE));
printf("space to end = %d \n\r\n", CIRC_SPACE_TO_END(circ.head, circ.tail, MAX_SIZE));
return 0;
}
/*
* 在内核<linux/circ_buf.h>中定义了关于环形缓冲区的相关变量。
* 其中缓冲区的大小size必须定义成2的n次方,这样可以将取余运算转换成位与运算,
* 提高计算机的处理速度。例如:x % size = x & (size - 1)。实际可用的空间为size-1,
* 这样可以避免缓冲区为满时和为空时都满足head = tail。
*/
struct circ_buf {
char *buf; // 指向分配缓冲区起始地址的指针
int head; // 指向生产者向缓冲区放入数据的位置
int tail; // 指向消费者从缓冲区取走数据的位置
};
/* Return count in buffer. */
/* 计算缓冲区中有效数据的大小; */
#define CIRC_CNT(head,tail,size) (((head) - (tail)) & ((size)-1))
/* Return space available, 0..size-1. We always leave one free char
as a completely full buffer has head == tail, which is the same as
empty. */
/* 计算缓冲区剩余空闲空间的大小; */
#define CIRC_SPACE(head,tail,size) CIRC_CNT((tail),((head)+1),(size))
/* Return count up to the end of the buffer. Carefully avoid
accessing head and tail more than once, so they can change
underneath us without returning inconsistent results. */
/* 计算tail到缓冲区尾部的数据大小,即一次性可以读取的数据大小;*/
#define CIRC_CNT_TO_END(head,tail,size) \
({int end = (size) - (tail); \
int n = ((head) + end) & ((size)-1); \
n < end ? n : end;})
/* Return space available up to the end of the buffer. */
/* 计算head到缓冲区尾部的剩余空间,即一次性可以写入的数据大小; */
#define CIRC_SPACE_TO_END(head,tail,size) \
({int end = (size) - 1 - (head); \
int n = (end + (tail)) & ((size)-1); \
n <= end ? n : end+1;})