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.
The 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.