Intel(R) Threading Building Blocks Doxygen Documentation  version 4.2.3
internal::function_input< Input, Output, Policy, A > Class Template Referenceabstract

Implements methods for a function node that takes a type Input as input and sends. More...

#include <_flow_graph_node_impl.h>

Inheritance diagram for internal::function_input< Input, Output, Policy, A >:
Collaboration diagram for internal::function_input< Input, Output, Policy, A >:

Public Types

typedef Input input_type
 
typedef Output output_type
 
typedef function_body< input_type, output_typefunction_body_type
 
typedef function_input< Input, Output, Policy, A > my_class
 
typedef function_input_base< Input, Policy, A, my_classbase_type
 
typedef function_input_queue< input_type, A > input_queue_type
 
- Public Types inherited from internal::function_input_base< Input, Policy, A, ImplType >
typedef Input input_type
 The input type of this receiver. More...
 
typedef receiver< input_type >::predecessor_type predecessor_type
 
typedef predecessor_cache< input_type, null_mutex > predecessor_cache_type
 
typedef function_input_queue< input_type, A > input_queue_type
 
typedef A::template rebind< input_queue_type >::other queue_allocator_type
 
- Public Types inherited from tbb::flow::interface10::receiver< Input >
typedef Input input_type
 The input type of this receiver. More...
 
typedef internal::async_helpers< Input >::filtered_type filtered_type
 
- Public Types inherited from tbb::flow::interface10::internal::untyped_receiver
typedef untyped_sender predecessor_type
 The predecessor type for this node. More...
 

Public Member Functions

template<typename Body >
 function_input (graph &g, size_t max_concurrency, Body &body)
 
 function_input (const function_input &src)
 Copy constructor. More...
 
 ~function_input ()
 
template<typename Body >
Body copy_function_object ()
 
output_type apply_body_impl (const input_type &i)
 
taskapply_body_impl_bypass (const input_type &i)
 
- Public Member Functions inherited from internal::function_input_base< Input, Policy, A, ImplType >
 __TBB_STATIC_ASSERT (!((internal::has_policy< queueing, Policy >::value) &&(internal::has_policy< rejecting, Policy >::value)), "queueing and rejecting policies can't be specified simultaneously")
 
 function_input_base (graph &g, size_t max_concurrency)
 Constructor for function_input_base. More...
 
 function_input_base (const function_input_base &src)
 Copy constructor. More...
 
virtual ~function_input_base ()
 Destructor. More...
 
tasktry_put_task (const input_type &t) __TBB_override
 Put item to successor; return task to run the successor if possible. More...
 
bool register_predecessor (predecessor_type &src) __TBB_override
 Adds src to the list of cached predecessors. More...
 
bool remove_predecessor (predecessor_type &src) __TBB_override
 Removes src from the list of cached predecessors. More...
 
- Public Member Functions inherited from tbb::flow::interface10::receiver< Input >
bool try_put (const typename internal::async_helpers< Input >::filtered_type &t)
 Put an item to the receiver. More...
 
bool try_put (const typename internal::async_helpers< Input >::async_type &t)
 
- Public Member Functions inherited from tbb::flow::interface10::internal::untyped_receiver
virtual ~untyped_receiver ()
 Destructor. More...
 
template<typename X >
bool try_put (const X &t)
 Put an item to the receiver. More...
 

Protected Member Functions

void reset_function_input (reset_flags f)
 
virtual broadcast_cache< output_type > & successors ()=0
 
- Protected Member Functions inherited from internal::function_input_base< Input, Policy, A, ImplType >
void reset_function_input_base (reset_flags f)
 
void reset_receiver (reset_flags f) __TBB_override
 
graph & graph_reference () __TBB_override
 
tasktry_get_postponed_task (const input_type &i)
 
- Protected Member Functions inherited from tbb::flow::interface10::receiver< Input >
virtual tasktry_put_task_wrapper (const void *p, bool is_async) __TBB_override
 
- Protected Member Functions inherited from tbb::flow::interface10::internal::untyped_receiver
template<typename X >
tasktry_put_task (const X &t)
 
virtual void reset_receiver (reset_flags f=rf_reset_protocol)=0
 put receiver back in initial state More...
 
virtual bool is_continue_receiver ()
 

Protected Attributes

function_body_typemy_body
 
function_body_typemy_init_body
 
- Protected Attributes inherited from internal::function_input_base< Input, Policy, A, ImplType >
graph & my_graph_ref
 
const size_t my_max_concurrency
 
size_t my_concurrency
 
input_queue_typemy_queue
 
predecessor_cache< input_type, null_mutex > my_predecessors
 

Detailed Description

template<typename Input, typename Output, typename Policy, typename A>
class internal::function_input< Input, Output, Policy, A >

Implements methods for a function node that takes a type Input as input and sends.

Definition at line 421 of file _flow_graph_node_impl.h.

Member Typedef Documentation

◆ base_type

template<typename Input , typename Output , typename Policy , typename A >
typedef function_input_base<Input, Policy, A, my_class> internal::function_input< Input, Output, Policy, A >::base_type

Definition at line 427 of file _flow_graph_node_impl.h.

◆ function_body_type

template<typename Input , typename Output , typename Policy , typename A >
typedef function_body<input_type, output_type> internal::function_input< Input, Output, Policy, A >::function_body_type

Definition at line 425 of file _flow_graph_node_impl.h.

◆ input_queue_type

template<typename Input , typename Output , typename Policy , typename A >
typedef function_input_queue<input_type, A> internal::function_input< Input, Output, Policy, A >::input_queue_type

Definition at line 428 of file _flow_graph_node_impl.h.

◆ input_type

template<typename Input , typename Output , typename Policy , typename A >
typedef Input internal::function_input< Input, Output, Policy, A >::input_type

Definition at line 423 of file _flow_graph_node_impl.h.

◆ my_class

template<typename Input , typename Output , typename Policy , typename A >
typedef function_input<Input, Output, Policy,A> internal::function_input< Input, Output, Policy, A >::my_class

Definition at line 426 of file _flow_graph_node_impl.h.

◆ output_type

template<typename Input , typename Output , typename Policy , typename A >
typedef Output internal::function_input< Input, Output, Policy, A >::output_type

Definition at line 424 of file _flow_graph_node_impl.h.

Constructor & Destructor Documentation

◆ function_input() [1/2]

template<typename Input , typename Output , typename Policy , typename A >
template<typename Body >
internal::function_input< Input, Output, Policy, A >::function_input ( graph &  g,
size_t  max_concurrency,
Body &  body 
)
inline

Definition at line 432 of file _flow_graph_node_impl.h.

432  :
436  }
function_body_type * my_init_body
function_body_type * my_body
int max_concurrency()
Returns the maximal number of threads that can work inside the arena.
Definition: task_arena.h:402
the leaf for function_body
function_input_base< Input, Policy, A, my_class > base_type

◆ function_input() [2/2]

template<typename Input , typename Output , typename Policy , typename A >
internal::function_input< Input, Output, Policy, A >::function_input ( const function_input< Input, Output, Policy, A > &  src)
inline

Copy constructor.

Definition at line 439 of file _flow_graph_node_impl.h.

439  :
440  base_type(src),
441  my_body( src.my_init_body->clone() ),
442  my_init_body(src.my_init_body->clone() ) {
443  }
function_body_type * my_init_body
function_body_type * my_body
function_input_base< Input, Policy, A, my_class > base_type

◆ ~function_input()

template<typename Input , typename Output , typename Policy , typename A >
internal::function_input< Input, Output, Policy, A >::~function_input ( )
inline

Member Function Documentation

◆ apply_body_impl()

template<typename Input , typename Output , typename Policy , typename A >
output_type internal::function_input< Input, Output, Policy, A >::apply_body_impl ( const input_type i)
inline

Definition at line 456 of file _flow_graph_node_impl.h.

456  {
457  // There is an extra copied needed to capture the
458  // body execution without the try_put
460  output_type v = (*my_body)(i);
462  return v;
463  }
static void fgt_end_body(void *)
function_body_type * my_body
static void fgt_begin_body(void *)

References tbb::internal::fgt_begin_body(), tbb::internal::fgt_end_body(), and internal::function_input< Input, Output, Policy, A >::my_body.

Referenced by internal::function_input< Input, Output, Policy, A >::apply_body_impl_bypass().

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

◆ apply_body_impl_bypass()

template<typename Input , typename Output , typename Policy , typename A >
task* internal::function_input< Input, Output, Policy, A >::apply_body_impl_bypass ( const input_type i)
inline

Definition at line 466 of file _flow_graph_node_impl.h.

466  {
468  task* postponed_task = NULL;
469 #if TBB_DEPRECATED_MESSAGE_FLOW_ORDER
470  task* successor_task = successors().try_put_task(v);
471 #endif
473  postponed_task = base_type::try_get_postponed_task(i);
474  }
475 #if TBB_DEPRECATED_MESSAGE_FLOW_ORDER
476  graph& g = base_type::my_graph_ref;
477  return combine_tasks(g, successor_task, postponed_task);
478 #else
479  // postponed_task is either NULL or the pointer to TBB task
480  if(postponed_task) {
481  // spawn task to make it available for other workers
482  // since we do not know successors' execution policy
484  }
485  task* successor_task = successors().try_put_task(v);
486 #if _MSC_VER && !__INTEL_COMPILER
487 #pragma warning (push)
488 #pragma warning (disable: 4127) /* suppress conditional expression is constant */
489 #endif
491 #if _MSC_VER && !__INTEL_COMPILER
492 #pragma warning (pop)
493 #endif
494  if(!successor_task) {
495  // Return confirmative status since current
496  // node's body has been executed anyway
497  successor_task = SUCCESSFULLY_ENQUEUED;
498  }
499  }
500  return successor_task;
501 #endif /* TBB_DEPRECATED_MESSAGE_FLOW_ORDER */
502  }
graph & graph_reference() __TBB_override
task * try_put_task(const T &t) __TBB_override
static tbb::task * combine_tasks(graph &g, tbb::task *left, tbb::task *right)
Definition: flow_graph.h:171
void const char const char int ITT_FORMAT __itt_group_sync x void const char ITT_FORMAT __itt_group_sync s void ITT_FORMAT __itt_group_sync p void ITT_FORMAT p void ITT_FORMAT p no args __itt_suppress_mode_t unsigned int void size_t ITT_FORMAT d void ITT_FORMAT p void ITT_FORMAT p __itt_model_site __itt_model_site_instance ITT_FORMAT p __itt_model_task * task
void spawn_in_graph_arena(graph &g, tbb::task &arena_task)
Spawns a task inside graph arena.
task * try_get_postponed_task(const input_type &i)
virtual broadcast_cache< output_type > & successors()=0
output_type apply_body_impl(const input_type &i)
static tbb::task *const SUCCESSFULLY_ENQUEUED

References internal::function_input< Input, Output, Policy, A >::apply_body_impl(), tbb::flow::interface10::combine_tasks(), internal::function_input_base< Input, Policy, A, ImplType >::graph_reference(), internal::function_input_base< Input, Policy, A, ImplType >::my_graph_ref, internal::function_input_base< Input, Policy, A, ImplType >::my_max_concurrency, tbb::flow::interface10::internal::spawn_in_graph_arena(), tbb::flow::internal::SUCCESSFULLY_ENQUEUED, internal::function_input< Input, Output, Policy, A >::successors(), task, internal::function_input_base< Input, Policy, A, ImplType >::try_get_postponed_task(), and internal::broadcast_cache< T, M >::try_put_task().

Here is the call graph for this function:

◆ copy_function_object()

template<typename Input , typename Output , typename Policy , typename A >
template<typename Body >
Body internal::function_input< Input, Output, Policy, A >::copy_function_object ( )
inline

Definition at line 451 of file _flow_graph_node_impl.h.

451  {
452  function_body_type &body_ref = *this->my_body;
453  return dynamic_cast< internal::function_body_leaf<input_type, output_type, Body> & >(body_ref).get_body();
454  }
function_body< input_type, output_type > function_body_type
function_body_type * my_body
the leaf for function_body

References internal::function_input< Input, Output, Policy, A >::my_body.

◆ reset_function_input()

template<typename Input , typename Output , typename Policy , typename A >
void internal::function_input< Input, Output, Policy, A >::reset_function_input ( reset_flags  f)
inlineprotected

◆ successors()

template<typename Input , typename Output , typename Policy , typename A >
virtual broadcast_cache<output_type >& internal::function_input< Input, Output, Policy, A >::successors ( )
protectedpure virtual

Referenced by internal::function_input< Input, Output, Policy, A >::apply_body_impl_bypass().

Here is the caller graph for this function:

Member Data Documentation

◆ my_body

◆ my_init_body

template<typename Input , typename Output , typename Policy , typename A >
function_body_type* internal::function_input< Input, Output, Policy, A >::my_init_body
protected

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

Copyright © 2005-2018 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.