README.md

Async primitives

Convenient, thread-safe, flexible and simple used async primitives
Requires C++17 and higher.

Features:

• Channel - channel for asynchronous interaction or communication between threads, inspired by channel from GoLang.
• Promise - promise to return a result from asynchronous operations or other threads, inspired by channel from JS.
• Notify - for notification of something
• Async - call function on next event loop

These primitives are intended to:

• To separate dependencies between sender and subscriber (like Qt signals/slots approach, just more convenient and safer)
• Building responsive asynchronous UI applications (like JS approach)
• Communication between threads (like GoLang approach)

Example

Used in at least two private commercial projects and one open source.

Integration

Add source

To use Async within your software project include the Async source into your project See and include async/async.cmake in the cmake project (see example/CMakeLists.txt)

Add aliases

Recommended add own aliases to use async, see example/async

Add call processEvents

To use channels in one main thread, nothing is required, just direct calls will occur, like callbacks.

For communication between threads or for using Async - calling a function on the next event loop, integration with the main event loop and the event loop of other threads is required.

There are two options for integration with the main eventloop:

1. If it is not possible to directly modify the body of the event loop, add your own call there, for example, if you are using some kind of UI framework, like Qt, then you need to install a callback with your implementation of the function call on the main thread, for example like this

std::thread::id mainThreadId = std::this_thread::get_id();
app::async::onMainThreadInvoke([mainThreadId](const std::function<void()>& func, bool isAlwaysQueued) {
    if (!isAlwaysQueued && std::this_thread::get_id() == mainThreadId) {
        func();
    } else {
        //! NOTE It is required to implement a function call on the next event loop
        //! For example, for Qt we can use QMetaObject::invokeMethod with Qt::QueuedConnection
    }
});

2. If you can directly add your call to the body of the event loop, then it’s easier to just add the call processEvents, like:

// event loop 
while (running) {
    app::async::processEvents();
    ...
}

ChangeLog

v1.3

• Fixes related to communication between threads

v1.2

• Added the possibility to have more than one parameter (thanks Casper Jeukendrup)

v1.1

• Ported to std

v1.0

• Implemented with Qt