Intel(R) Threading Building Blocks Doxygen Documentation  version 4.2.3
tbb::interface9::internal::do_task_iter< Iterator, Body, Item > Class Template Reference

For internal use only. More...

#include <parallel_do.h>

Inheritance diagram for tbb::interface9::internal::do_task_iter< Iterator, Body, Item >:
Collaboration diagram for tbb::interface9::internal::do_task_iter< Iterator, Body, Item >:

Public Member Functions

 do_task_iter (Iterator first, Iterator last, feeder_type &feeder)
 
- Public Member Functions inherited from tbb::task
virtual ~task ()
 Destructor. More...
 
internal::allocate_continuation_proxy & allocate_continuation ()
 Returns proxy for overloaded new that allocates a continuation task of *this. More...
 
internal::allocate_child_proxy & allocate_child ()
 Returns proxy for overloaded new that allocates a child task of *this. More...
 
void recycle_as_continuation ()
 Change this to be a continuation of its former self. More...
 
void recycle_as_safe_continuation ()
 Recommended to use, safe variant of recycle_as_continuation. More...
 
void recycle_as_child_of (task &new_parent)
 Change this to be a child of new_parent. More...
 
void recycle_to_reexecute ()
 Schedule this for reexecution after current execute() returns. More...
 
void set_ref_count (int count)
 Set reference count. More...
 
void increment_ref_count ()
 Atomically increment reference count. More...
 
int add_ref_count (int count)
 Atomically adds to reference count and returns its new value. More...
 
int decrement_ref_count ()
 Atomically decrement reference count and returns its new value. More...
 
void spawn_and_wait_for_all (task &child)
 Similar to spawn followed by wait_for_all, but more efficient. More...
 
void __TBB_EXPORTED_METHOD spawn_and_wait_for_all (task_list &list)
 Similar to spawn followed by wait_for_all, but more efficient. More...
 
void wait_for_all ()
 Wait for reference count to become one, and set reference count to zero. More...
 
taskparent () const
 task on whose behalf this task is working, or NULL if this is a root. More...
 
void set_parent (task *p)
 sets parent task pointer to specified value More...
 
task_group_contextcontext ()
 This method is deprecated and will be removed in the future. More...
 
task_group_contextgroup ()
 Pointer to the task group descriptor. More...
 
bool is_stolen_task () const
 True if task was stolen from the task pool of another thread. More...
 
state_type state () const
 Current execution state. More...
 
int ref_count () const
 The internal reference count. More...
 
bool __TBB_EXPORTED_METHOD is_owned_by_current_thread () const
 Obsolete, and only retained for the sake of backward compatibility. Always returns true. More...
 
void set_affinity (affinity_id id)
 Set affinity for this task. More...
 
affinity_id affinity () const
 Current affinity of this task. More...
 
virtual void __TBB_EXPORTED_METHOD note_affinity (affinity_id id)
 Invoked by scheduler to notify task that it ran on unexpected thread. More...
 
void __TBB_EXPORTED_METHOD change_group (task_group_context &ctx)
 Moves this task from its current group into another one. More...
 
bool cancel_group_execution ()
 Initiates cancellation of all tasks in this cancellation group and its subordinate groups. More...
 
bool is_cancelled () const
 Returns true if the context has received cancellation request. More...
 
void set_group_priority (priority_t p)
 Changes priority of the task group this task belongs to. More...
 
priority_t group_priority () const
 Retrieves current priority of the task group this task belongs to. More...
 

Private Types

typedef parallel_do_feeder_impl< Body, Item > feeder_type
 

Private Member Functions

taskexecute () __TBB_override
 Should be overridden by derived classes. More...
 
taskrun (void *)
 
taskrun_for_input_iterator ()
 
taskrun (std::forward_iterator_tag *)
 
taskrun_for_forward_iterator ()
 
taskrun (std::random_access_iterator_tag *)
 
taskrun_for_random_access_iterator ()
 

Private Attributes

Iterator my_first
 
Iterator my_last
 
feeder_typemy_feeder
 

Additional Inherited Members

- Public Types inherited from tbb::task
enum  state_type {
  executing, reexecute, ready, allocated,
  freed, recycle
}
 Enumeration of task states that the scheduler considers. More...
 
typedef internal::affinity_id affinity_id
 An id as used for specifying affinity. More...
 
- Static Public Member Functions inherited from tbb::task
static internal::allocate_root_proxy allocate_root ()
 Returns proxy for overloaded new that allocates a root task. More...
 
static internal::allocate_root_with_context_proxy allocate_root (task_group_context &ctx)
 Returns proxy for overloaded new that allocates a root task associated with user supplied context. More...
 
static void spawn_root_and_wait (task &root)
 Spawn task allocated by allocate_root, wait for it to complete, and deallocate it. More...
 
static void spawn_root_and_wait (task_list &root_list)
 Spawn root tasks on list and wait for all of them to finish. More...
 
static void enqueue (task &t)
 Enqueue task for starvation-resistant execution. More...
 
static void enqueue (task &t, priority_t p)
 Enqueue task for starvation-resistant execution on the specified priority level. More...
 
static task &__TBB_EXPORTED_FUNC self ()
 The innermost task being executed or destroyed by the current thread at the moment. More...
 
- Protected Member Functions inherited from tbb::task
 task ()
 Default constructor. More...
 

Detailed Description

template<typename Iterator, typename Body, typename Item>
class tbb::interface9::internal::do_task_iter< Iterator, Body, Item >

For internal use only.

Gets block of iterations and packages them into a do_group_task.

Definition at line 299 of file parallel_do.h.

Member Typedef Documentation

◆ feeder_type

template<typename Iterator , typename Body , typename Item >
typedef parallel_do_feeder_impl<Body, Item> tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::feeder_type
private

Definition at line 301 of file parallel_do.h.

Constructor & Destructor Documentation

◆ do_task_iter()

template<typename Iterator , typename Body , typename Item >
tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::do_task_iter ( Iterator  first,
Iterator  last,
feeder_type feeder 
)
inline

Definition at line 304 of file parallel_do.h.

304  :
305  my_first(first), my_last(last), my_feeder(feeder)
306  {}
auto first(Container &c) -> decltype(begin(c))
auto last(Container &c) -> decltype(begin(c))

Referenced by tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run_for_random_access_iterator().

Here is the caller graph for this function:

Member Function Documentation

◆ execute()

template<typename Iterator , typename Body , typename Item >
task* tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::execute ( )
inlineprivatevirtual

Should be overridden by derived classes.

Implements tbb::task.

Definition at line 323 of file parallel_do.h.

324  {
325  typedef typename std::iterator_traits<Iterator>::iterator_category iterator_tag;
326  return run( (iterator_tag*)NULL );
327  }

References tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run().

Here is the call graph for this function:

◆ run() [1/3]

template<typename Iterator , typename Body , typename Item >
task* tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run ( void )
inlineprivate

This is the most restricted variant that operates on input iterators or iterators with unknown tags (tags not derived from the standard ones).

Definition at line 331 of file parallel_do.h.

References tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run_for_input_iterator().

Referenced by tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::execute().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ run() [2/3]

template<typename Iterator , typename Body , typename Item >
task* tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run ( std::forward_iterator_tag *  )
inlineprivate

Definition at line 357 of file parallel_do.h.

References tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run_for_forward_iterator().

Here is the call graph for this function:

◆ run() [3/3]

template<typename Iterator , typename Body , typename Item >
task* tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run ( std::random_access_iterator_tag *  )
inlineprivate

Definition at line 375 of file parallel_do.h.

References tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run_for_random_access_iterator().

Here is the call graph for this function:

◆ run_for_forward_iterator()

template<typename Iterator , typename Body , typename Item >
task* tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run_for_forward_iterator ( )
inlineprivate

Definition at line 359 of file parallel_do.h.

359  {
360  typedef do_group_task_forward<Iterator, Body, Item> block_type;
361 
362  Iterator first = my_first;
363  size_t k=0;
364  while( !(my_first==my_last) ) {
365  ++my_first;
366  if( ++k==block_type::max_arg_size ) {
367  if ( !(my_first==my_last) )
369  break;
370  }
371  }
372  return k==0 ? NULL : new( allocate_additional_child_of(*my_feeder.my_barrier) ) block_type(first, k, my_feeder);
373  }
auto first(Container &c) -> decltype(begin(c))
void recycle_to_reexecute()
Schedule this for reexecution after current execute() returns.
Definition: task.h:714

References tbb::internal::first(), tbb::interface9::internal::parallel_do_feeder_impl< Body, Item >::my_barrier, tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_feeder, tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_first, tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_last, and tbb::task::recycle_to_reexecute().

Referenced by tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ run_for_input_iterator()

template<typename Iterator , typename Body , typename Item >
task* tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run_for_input_iterator ( )
inlineprivate

Definition at line 333 of file parallel_do.h.

333  {
334  typedef do_group_task_input<Body, Item> block_type;
335 
336  block_type& t = *new( allocate_additional_child_of(*my_feeder.my_barrier) ) block_type(my_feeder);
337  size_t k=0;
338  while( !(my_first == my_last) ) {
339  // Move semantics are automatically used when supported by the iterator
340  new (t.my_arg.begin() + k) Item(*my_first);
341  ++my_first;
342  if( ++k==block_type::max_arg_size ) {
343  if ( !(my_first == my_last) )
345  break;
346  }
347  }
348  if( k==0 ) {
349  destroy(t);
350  return NULL;
351  } else {
352  t.my_size = k;
353  return &t;
354  }
355  }
void recycle_to_reexecute()
Schedule this for reexecution after current execute() returns.
Definition: task.h:714

References tbb::interface9::internal::parallel_do_feeder_impl< Body, Item >::my_barrier, tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_feeder, tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_first, tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_last, and tbb::task::recycle_to_reexecute().

Referenced by tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ run_for_random_access_iterator()

template<typename Iterator , typename Body , typename Item >
task* tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run_for_random_access_iterator ( )
inlineprivate

Definition at line 377 of file parallel_do.h.

377  {
378  typedef do_group_task_forward<Iterator, Body, Item> block_type;
379  typedef do_iteration_task_iter<Iterator, Body, Item> iteration_type;
380 
381  size_t k = static_cast<size_t>(my_last-my_first);
382  if( k > block_type::max_arg_size ) {
383  Iterator middle = my_first + k/2;
384 
385  empty_task& c = *new( allocate_continuation() ) empty_task;
386  do_task_iter& b = *new( c.allocate_child() ) do_task_iter(middle, my_last, my_feeder);
388 
389  my_last = middle;
390  c.set_ref_count(2);
391  c.spawn(b);
392  return this;
393  }else if( k != 0 ) {
394  task_list list;
395  task* t;
396  size_t k1=0;
397  for(;;) {
398  t = new( allocate_child() ) iteration_type(my_first, my_feeder);
399  ++my_first;
400  if( ++k1==k ) break;
401  list.push_back(*t);
402  }
403  set_ref_count(int(k+1));
404  spawn(list);
406  }
407  return NULL;
408  }
internal::allocate_child_proxy & allocate_child()
Returns proxy for overloaded new that allocates a child task of *this.
Definition: task.h:654
void recycle_as_child_of(task &new_parent)
Change this to be a child of new_parent.
Definition: task.h:698
void spawn_and_wait_for_all(task &child)
Similar to spawn followed by wait_for_all, but more efficient.
Definition: task.h:773
task()
Default constructor.
Definition: task.h:602
internal::allocate_continuation_proxy & allocate_continuation()
Returns proxy for overloaded new that allocates a continuation task of *this.
Definition: task.h:649
void set_ref_count(int count)
Set reference count.
Definition: task.h:734
friend class task_list
Definition: task.h:929
do_task_iter(Iterator first, Iterator last, feeder_type &feeder)
Definition: parallel_do.h:304

References tbb::task::allocate_child(), tbb::task::allocate_continuation(), tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::do_task_iter(), tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_feeder, tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_first, tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::my_last, tbb::task_list::push_back(), tbb::task::recycle_as_child_of(), tbb::task::set_ref_count(), and tbb::task::spawn_and_wait_for_all().

Referenced by tbb::interface9::internal::do_task_iter< Iterator, Body, Item >::run().

Here is the call graph for this function:
Here is the caller graph for this function:

Member Data Documentation

◆ my_feeder

◆ my_first

◆ my_last


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

Copyright © 2005-2019 Intel Corporation. All Rights Reserved.

Intel, Pentium, Intel Xeon, Itanium, Intel XScale and VTune are registered trademarks or trademarks of Intel Corporation or its subsidiaries in the United States and other countries.

* Other names and brands may be claimed as the property of others.