Crates.io | simple_ringbuf |
lib.rs | simple_ringbuf |
version | 0.1.2 |
source | src |
created_at | 2019-06-13 14:22:28.694815 |
updated_at | 2019-06-13 14:26:36.38609 |
description | Simple Ringbuf is a speedy lightweight fixed-size infinite-use collection optimized for straightforward single threaded use. |
homepage | |
repository | https://github.com/Zaerei/simple_ringbuf |
max_upload_size | |
id | 140840 |
size | 62,590 |
The simple_ringbuf
crate provides a lightweight (no dependency) ring buffer backed with
a hand-memory managed buffer (with unsafe
). Serialization support is optionally available
with the serde
feature flag.
The sole feature of this create is the RingBuffer
struct, which is a fixed-sized collection
with an API somewhat similar to standard Rust collections.
The primary intention of this crate is to provide a cheap fixed-sized collection for buffering a finite horizon of data. The use case this was developed for was an action history log for a bot, and could be used for similar concepts like undo logs. In fact, the iterator and Index implementations for this struct assume you want to iterate from the "top" of the deque (newest to oldest), and doesn't allow mutation of elements at this time (but does allow push/popping from both ends).
Most existing ring buffers for Rust such as the ringbuf
crate, or the standard library's
own VecDeque
are specialized for different uses and may fit your needs better.