除了基本的讀寫操作之外，為了更好的利用環形這一特點，我加入了分隔關鍵詞、查詢關鍵詞、刪除數據等功能
基于這些功能您可以在串口收發中實現多段數據的緩存與準確讀取；降低了實時性響應的要求、提升了串口收發的性能

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內的注釋；