nbchan 0.1.3

Highly optimized non-blocking communication channels
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53

nbchan
======

[![Crates.io: nbchan](http://meritbadge.herokuapp.com/nbchan)](https://crates.io/crates/nbchan)
[![Documentation](https://docs.rs/nbchan/badge.svg)](https://docs.rs/nbchan)
[![Build Status](https://travis-ci.org/sile/nbchan.svg?branch=master)](https://travis-ci.org/sile/nbchan)
[![Code Coverage](https://codecov.io/gh/sile/nbchan/branch/master/graph/badge.svg)](https://codecov.io/gh/sile/nbchan/branch/master)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

Highly optimized non-blocking communication channels implemented in Rust.

[Documentation](https://docs.rs/nbchan)


Informal Benchmarks
--------------------

The version of `nbchan` is `v0.1.0`:

```sh
$ cat /etc/lsb-release | tail -1
DISTRIB_DESCRIPTION="Ubuntu 17.04"

$ cat /proc/cpuinfo | grep 'model name'
model name      : Intel(R) Core(TM) i7-6600U CPU @ 2.60GHz
model name      : Intel(R) Core(TM) i7-6600U CPU @ 2.60GHz
model name      : Intel(R) Core(TM) i7-6600U CPU @ 2.60GHz
model name      : Intel(R) Core(TM) i7-6600U CPU @ 2.60GHz

$ rustup run nightly rustc -V
rustc 1.18.0-nightly (036983201 2017-04-26)

$ rustup run nightly cargo bench
running 8 tests
test create_nbchan_oneshot                ... bench:          23 ns/iter (+/- 1)
test create_std_mpsc                      ... bench:          64 ns/iter (+/- 6)
test failure_send_nbchan_oneshot          ... bench:          40 ns/iter (+/- 1)
test failure_send_std_mpsc                ... bench:          85 ns/iter (+/- 6)
test multithread_send_recv_nbchan_oneshot ... bench:          71 ns/iter (+/- 19)
test multithread_send_recv_std_mpsc       ... bench:         108 ns/iter (+/- 53)
test send_recv_nbchan_oneshot             ... bench:          35 ns/iter (+/- 4)
test send_recv_std_mpsc                   ... bench:          82 ns/iter (+/- 3)

test result: ok. 0 passed; 0 failed; 0 ignored; 8 measured
```

```sh
$ cargo run --example channel_size
nbchan::oneshot::Sender<()>:   8 bytes
nbchan::oneshot::Receiver<()>: 8 bytes
std::sync::mpsc::Sender<()>:   16 bytes
std::sync::mpsc::Receiver<()>: 16 bytes
```