除了基本的读写操作之外，为了更好的利用环形这一特点，我加入了分隔关键词、查询关键词、删除数据等功能
基于这些功能您可以在串口收发中实现多段数据的缓存与准确读取；降低了实时性响应的要求、提升了串口收发的性能

1. #include <stdio.h>
   
2. #include <ring_buffer.h>
   
3. 
   
4. #define Read_BUFFER_SIZE        256
   
5. 
   
6. //设定一个分隔关键词和关键词的长度（字节）
   
7. #define SEPARATE_SIGN       0xCCFB22AA
   
8. #define SEPARATE_SIGN_SIZE  4
   
9. 
   
10. int main()
    
11. {
    
12.     //新建缓冲区数组与Ring Buff操作句柄
    
13.     uint8_t buffer[Read_BUFFER_SIZE] ;
    
14.     ring_buffer RB ;
    
15. 
    
16.     //初始化Ring Buff操作句柄，绑定缓冲区数组；
    
17.     Ring_Buffer_Init(&RB, buffer, Read_BUFFER_SIZE);
    
18. 
    
19.     //记录段落数量
    
20.     uint8_t String_Count = 0 ;
    
21. 
    
22.     //向环形缓冲区写入三段数据，每段之间插入一个分隔关键词
    
23.     Ring_Buffer_Write_String(&RB, "ABCDEFGHIJK\r\n", 13);//写入一段数据
    
24.     Ring_Buffer_Insert_Keyword(&RB, SEPARATE_SIGN, SEPARATE_SIGN_SIZE);//插入一个分隔关键词
    
25.     String_Count ++ ;//记录段落数量 +1
    
26. 
    
27.     Ring_Buffer_Write_String(&RB, "abcdefg\r\n", 9);
    
28.     Ring_Buffer_Insert_Keyword(&RB, SEPARATE_SIGN, SEPARATE_SIGN_SIZE);
    
29.     String_Count ++ ;
    
30. 
    
31.     Ring_Buffer_Write_String(&RB, "1234\r\n", 6);
    
32.     Ring_Buffer_Insert_Keyword(&RB, SEPARATE_SIGN, SEPARATE_SIGN_SIZE);
    
33.     String_Count ++ ;
    
34. 
    
35.     while(String_Count != 0)
    
36.     {
    
37.         uint8_t get[16] ;
    
38.         //获得头指针到关键词高位的距离，距离-1得到第一段数据的长度
    
39.         uint8_t lenght = Ring_Buffer_Find_Keyword(&RB, SEPARATE_SIGN, SEPARATE_SIGN_SIZE) - 1 ;
    
40.         Ring_Buffer_Read_String(&RB, get, lenght);//读取一段数据，保存到get数组
    
41.         printf("%s", get);//打印数据
    
42.         Ring_Buffer_Delete(&RB, SEPARATE_SIGN_SIZE);//删除分隔关键词的长度的数据，即删除关键词
    
43.         String_Count -- ;//记录段落数量 -1
    
44.     }
    
45. 
    
46.     return 0 ;
    
47. }

复制代码

在这里我展示了如何新建并初始化Ring Buffer、读写环形缓冲、查询数据长度等基础操作
您可以了解到Ring Buffer的函数命名与参数的风格和基本的使用方法

1. #include <stdio.h>
   
2. #include <ring_buffer.h>
   
3. 
   
4. #define Read_BUFFER_SIZE        256
   
5. 
   
6. int main()
   
7. {
   
8.     //新建缓冲区数组与Ring Buff操作句柄
   
9.     uint8_t buffer[Read_BUFFER_SIZE] ;
   
10.     ring_buffer RB ;
    
11. 
    
12.     //初始化Ring Buff操作句柄，绑定缓冲区数组；
    
13.     Ring_Buffer_Init(&RB, buffer, Read_BUFFER_SIZE);
    
14. 
    
15.     //向环形缓冲区写入一段字节和一个字节
    
16.     Ring_Buffer_Write_String(&RB, "hello world", 11);
    
17.     Ring_Buffer_Write_Byte(&RB, '!');
    
18. 
    
19.     //获取已储存的数据长度，读出环形缓冲区中的数据并打印
    
20.     uint32_t num = Ring_Buffer_Get_Lenght(&RB);
    
21.     uint8_t get[16] ;
    
22.     Ring_Buffer_Read_String(&RB, get, num);
    
23.     printf("%s", get);
    
24.    
    
25.     return 0 ;
    
26. }

复制代码

复制库文件至工程中，在源代码中引用 Ring Buffer 头文件；
新建一个 uint8_t 数组，数组的大小即是环形缓冲区的大小；
新建 Ring Buffer 操作句柄；
初始化 Ring Buffer 操作句柄，将其与刚才新建的数组绑定，转换成环形缓冲区；
这时候我们就可以使用库提供的各种函数对新建的缓冲区进行读写等操作；
函数详细内容请在编程的过程中参考ring_buffer.c内的注释；