Initializing and Terminating the Library#
oneAPI Threading Building Blocks (oneTBB) automatically initializes the task scheduler. The initialization process is involved when a thread uses task scheduling services the first time, for example any parallel algorithm, flow graph or task group. The termination happens when the last such thread exits.
Explicit Library Finalization#
oneTBB supports an explicit library termination as a preview feature.
oneapi::tbb::finalize function called with an instance of class
oneapi::tbb::task_scheduler_handle blocks the calling thread
until all worker threads implicitly created by the library have completed.
If waiting for thread completion is not safe, e.g. may result in a deadlock
or called inside a task, a parallel algorithm, or a flow graph node, the method fails.
If you know how many active
oneapi::tbb::task_scheduler_handle instances exist in the program,
it is recommended to call
oneapi::tbb::release function on all but the last one, then call
oneapi::tbb::finalize for the last instance.