Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
ROOT::Experimental::TTaskGroup Class Reference

A class to manage the asynchronous execution of work items.

A TTaskGroup represents concurrent execution of a group of tasks. Tasks may be dynamically added to the group as it is executing.

A TTaskGroup represents concurrent execution of a group of tasks. Tasks may be dynamically added to the group as it is executing. Nesting TTaskGroup instances may result in a runtime overhead.

Definition at line 26 of file TTaskGroup.hxx.

Public Member Functions

 TTaskGroup ()
 
 TTaskGroup (const TTaskGroup &)=delete
 
 TTaskGroup (TTaskGroup &&other)
 
 ~TTaskGroup ()
 
void Cancel ()
 Cancel all submitted tasks immediately.
 
TTaskGroupoperator= (TTaskGroup &&other)
 
void Run (const std::function< void(void)> &closure)
 Add to the group an item of work which will be ran asynchronously.
 
void Wait ()
 Wait until all submitted items of work are completed.
 

Private Member Functions

void ExecuteInIsolation (const std::function< void(void)> &operation)
 Run operation in the internal task arena to implement work isolation, i.e.
 

Private Attributes

std::shared_ptr< ROOT::Internal::RTaskArenaWrapperfTaskArenaW
 
void * fTaskContainer {nullptr}
 

#include <ROOT/TTaskGroup.hxx>

Constructor & Destructor Documentation

◆ TTaskGroup() [1/3]

ROOT::Experimental::TTaskGroup::TTaskGroup ( )

Definition at line 59 of file TTaskGroup.cxx.

◆ TTaskGroup() [2/3]

ROOT::Experimental::TTaskGroup::TTaskGroup ( TTaskGroup &&  other)

Definition at line 70 of file TTaskGroup.cxx.

◆ TTaskGroup() [3/3]

ROOT::Experimental::TTaskGroup::TTaskGroup ( const TTaskGroup )
delete

◆ ~TTaskGroup()

ROOT::Experimental::TTaskGroup::~TTaskGroup ( )

Definition at line 83 of file TTaskGroup.cxx.

Member Function Documentation

◆ Cancel()

void ROOT::Experimental::TTaskGroup::Cancel ( )

Cancel all submitted tasks immediately.

Definition at line 107 of file TTaskGroup.cxx.

◆ ExecuteInIsolation()

void ROOT::Experimental::TTaskGroup::ExecuteInIsolation ( const std::function< void(void)> &  operation)
private

Run operation in the internal task arena to implement work isolation, i.e.

prevent stealing of work items spawned by ancestors.

Definition at line 96 of file TTaskGroup.cxx.

◆ operator=()

TTaskGroup & ROOT::Experimental::TTaskGroup::operator= ( TTaskGroup &&  other)

Definition at line 75 of file TTaskGroup.cxx.

◆ Run()

void ROOT::Experimental::TTaskGroup::Run ( const std::function< void(void)> &  closure)

Add to the group an item of work which will be ran asynchronously.

Adding many small items of work to the TTaskGroup is not efficient, unless they run for long enough. If the work to be done is little, look try to express nested parallelism or resort to other constructs such as the TThreadExecutor. Trying to add a work item to the group while it is in waiting state makes the method block.

Definition at line 122 of file TTaskGroup.cxx.

◆ Wait()

void ROOT::Experimental::TTaskGroup::Wait ( )

Wait until all submitted items of work are completed.

This method is blocking.

Definition at line 134 of file TTaskGroup.cxx.

Member Data Documentation

◆ fTaskArenaW

std::shared_ptr<ROOT::Internal::RTaskArenaWrapper> ROOT::Experimental::TTaskGroup::fTaskArenaW
private

Definition at line 36 of file TTaskGroup.hxx.

◆ fTaskContainer

void* ROOT::Experimental::TTaskGroup::fTaskContainer {nullptr}
private

Definition at line 37 of file TTaskGroup.hxx.

Libraries for ROOT::Experimental::TTaskGroup:

The documentation for this class was generated from the following files: