|new 0.1.1||Nov 20, 2020|
#130 in Concurrency
25 downloads per month
A wait-free single-producer single-consumer ring buffer for Rust.
Add this to your
[dependencies] rtrb = "0.1"
Running the tests:
Testing the benchmarks (without actually benchmarking):
cargo test --benches
Running the benchmarks (using the criterion crate;
results will be available in
Creating the HTML docs (using
nightly Rust to enable intra-doc links;
docs will be available in
cargo +nightly doc
This crate's minimum supported
rustc version (MSRV) is
The MSRV is not expected to be updated frequently, but if it is,
there will be (at least) a minor version bump.
The initial code has been ripped off of https://github.com/crossbeam-rs/crossbeam/pull/338, with permission of the PR author @stjepang.
It has been isolated from the rest of
crossbeam with git-filter-repo:
git-filter-repo --subdirectory-filter crossbeam-queue --path src/spsc.rs --path tests/spsc.rs --refs refs/heads/spsc
If you don't like this crate, no problem, there are several alternatives for you to choose from. There are many varieties of ring buffers available, here we limit the selection to wait-free SPSC implementations:
- fdringbuf (see
- jack (FFI bindings for JACK, see
- npnc (see
There are also implementations in other languages:
- boost::lockfree::spsc_queue (C++)
- JACK ring buffer (C)
- PortAudio ring buffer (C)
- readerwriterqueue (C++)
- SPSCQueue (C++)
If you know more alternatives for this list, please open an issue.
Licensed under either of
- Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.