Mbed OS 文档翻译之参考（API（平台（CircularBuffer）））

最新推荐文章于 2024-04-29 22:14:34 发布

XinLiBK

最新推荐文章于 2024-04-29 22:14:34 发布

阅读量250

点赞数 1

分类专栏： Mbed OS 文章标签： Mbed Mbed OS Mbed OS 5

Mbed OS 专栏收录该内容

146 篇文章

订阅专栏

本文介绍了一个通用的CircularBuffer类，该类支持不同类型的数据，并提供了一系列关键的方法，如push、pop、empty、full等，用于高效地管理和操作环形缓冲区。通过一个C++示例程序演示了如何使用此类进行数据的读写。

摘要由CSDN通过智能技术生成

CircularBuffer

CircularBuffer 类提供了用于从缓冲区推送和弹出数据的 API。在推送数据之前，应检查缓冲区是否已满，因为完整缓冲区会覆盖数据。在执行弹出操作之前，空 API 可用于检查缓冲区中的内容。

CircularBuffer 类是中断安全的；所有数据操作都在关键部分内执行。

CircularBuffer 是一个支持不同数据类型的模板化类。CircularBuffer 类的声明必须指定数据类型和缓冲区大小。

声明示例

这是 BUF_SIZE长整数 CircularBuffer 的一个例子：

CircularBuffer<int, BUF_SIZE> buf;

CircularBuffer 类参考

mbed::CircularBuffer< T, BufferSize, CounterType > 类模板参考

公共成员函数
void	push (const T &data)
bool	pop (T &data)
bool	empty () const
bool	full () const
void	reset ()
CounterType	size () const
bool	peek (T &data) const

CircularBuffer 示例

main.cpp 导入到 Mbed IDE

/*
 * Copyright (c) 2016-2016, ARM Limited, All Rights Reserved
 * SPDX-License-Identifier: Apache-2.0
 *
 * Licensed under the Apache License, Version 2.0 (the "License"); you may
 * not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
#include "mbed.h"
#include "platform/CircularBuffer.h"

#define BUF_SIZE    10

CircularBuffer<char, BUF_SIZE> buf;
char data_stream[] = "DataToBeAddedToBuffer";

int main()
{
    uint32_t bytes_written = 0;
    
    while (!buf.full()) {
        buf.push(data_stream[bytes_written++]);
    }
    
    printf("Circular buffer is full: \"%s\" or empty: \"%s\" \n", 
           (buf.full()? "true":"false"), 
           (buf.empty()? "true":"false") );
    printf ("Bytes written %d \n", bytes_written);
    
    // If buffer is full, contents will be over-written
    buf.push(data_stream[bytes_written++]);
    
    char data;
    printf ("Buffer contents: ");
    while (!buf.empty()) {
        buf.pop(data);
        printf("%c", data);
    }
    printf("\n");

    printf("Circular buffer is full: \"%s\" or empty: \"%s\" \n", 
           (buf.full()? "true":"false"), 
           (buf.empty()? "true":"false") );

    return 0;
    
}