Boost.Coroutine provides templates for generalized subroutines which allow multiple entry points for suspending and resuming execution at certain locations. It preserves local state/data and allows reentering subroutines more than once (useful if state must be kept across function calls).

Coroutines can be viewed as a language-level construct providing a special kind of control flow.

This interface was designed by Giovanni Piero Deretta; the implementation utilizes Boost.Context.

In order to use the classes and functions described here, you can either include the specific headers specified by the descriptions of each class or function, or include the master library header:

#include <boost/coroutine/all.hpp>

which includes all the other headers in turn.

All functions and classes are contained in the namespace boost::coro.

Boost.Coroutine depends on Boost.Context as well as Boost.Move and requires Boost-1.50.0.