sosflyyi / cpp-channel

Thread-safe container for sharing data between threads

Channel

Thread-safe container for sharing data between threads. Header-only.

• Thread-safe push and fetch.
• Use stream operators to push (>>) and fetch (<<) items.
• Blocking (forever waiting to fetch).
• Range-based for loop supported.
• Close to prevent pushing and stop waiting to fetch.
• Integrates well with STL algorithms. Eg: std::move(ch.begin(), ch.end(), ...).
• Tested with GCC and Clang.

Requirements

• C++11 or newer

Installation

Copy the include directory to your project and add it to your include path. Or see CMakeLists.txt from the CMake project example .

Usage

#include <cassert>

#include <msd/channel.hpp>

int main() {
    msd::channel<int> chan; // unbuffered

    int in = 1;
    int out = 0;

    // Send to channel
    in >> chan;

    // Read from channel
    out << chan;

    assert(out == 1);
}

#include <msd/channel.hpp>

int main() {
    msd::channel<int> chan{2}; // buffered

    int in = 1;

    // Send to channel
    in >> chan;
    in >> chan;
    in >> chan; // blocking because capacity is 2 (and no one reads from channel)
}

#include <msd/channel.hpp>

int main() {
    msd::channel<int> chan{2}; // buffered

    int in = 1;
    int out = 0;

    // Send to channel
    in >> chan;
    in >> chan;

    // Read from channel
    out << chan;
    out << chan;
    out << chan; // blocking because channel is empty (and no one writes on it)
}

#include <iostream>

#include <msd/channel.hpp>

int main() {
    msd::channel<int> chan;

    int in1 = 1;
    in1 >> chan;

    int in2 = 2;
    in2 >> chan;

    for (const auto out : chan) {  // blocking: forever waiting for channel items
        std::cout << out << '\n';
    }
}

See examples.

Developed with CLion