{"id":5882,"date":"2020-04-16T14:38:24","date_gmt":"2020-04-16T14:38:24","guid":{"rendered":"https:\/\/www.modernescpp.com\/index.php\/c-20-coroutines-with-cppcoro\/"},"modified":"2023-09-28T07:43:19","modified_gmt":"2023-09-28T07:43:19","slug":"c-20-coroutines-with-cppcoro","status":"publish","type":"post","link":"https:\/\/www.modernescpp.com\/index.php\/c-20-coroutines-with-cppcoro\/","title":{"rendered":"C++20: Coroutines with cppcoro"},"content":{"rendered":"

The cppcoro library from Lewis Baker gives you what C++20 doesn’t: a library of C++ coroutine abstractions based on the coroutines TS.<\/p>\n

<\/p>\n

\"\"<\/p>\n

Arguably, the two last posts, “C++20: An Infinite Data Stream with Coroutines<\/a>” and “C++20: Thread Synchronization with Coroutines<\/a>” were challenging to comprehend. The following posts to coroutines are easier to digest. I present examples of existing coroutines in cppcoro<\/a>.<\/p>\n

I speak from the coroutines and the coroutines framework to make my argument easier.<\/p>\n

cppcoro<\/h2>\n

The coroutine TS is the base of the cppcoro library from Lewis Baker. TS stands for technical specifications and is the preliminary version of the coroutines framework we get with C++20. Lewis will port the cppcoro library from the coroutines TS framework to the coroutines framework we get with C++20.<\/p>\n

Porting the library is very important because we get not coroutines with C++20; we get a coroutines framework.<\/strong> This difference means you are on your own if you want to use coroutines in C++20. You have to create your coroutines based on the C++20 coroutines framework. Presumably, we get concrete coroutines with C++23. Honestly, I see this as extremely critical because implementing coroutines is quite challenging and error-prone. This gap is precisely the gap that cppcoro fills. It provides abstractions for coroutine types, awaitable types, functions, cancellation, schedulers, networking, and metafunctions, and defines a few concepts.<\/p>\n

Using cppcoro<\/h3>\n

Currently, cppcoro is based on the coroutines TS frameworks and can be used on Windows (Visual Studio 2017) or Linux (Clang 5.0\/6.0 and libc++). For your experiments, I used the following command line for all of the examples:<\/p>\n

\"cppcoroBuild\"<\/p>\n