Home ⌂Doc Index ◂Up ▴
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, function_input< Input, Output, Policy, A > >
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 tbb::internal::allocator_rebind< A, input_queue_type >::type queue_allocator_type
 
- Public Types inherited from tbb::flow::interface11::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,)
 
 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, function_input< Input, Output, Policy, A > >
 __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, __TBB_FLOW_GRAPH_PRIORITY_ARG1(size_t max_concurrency, node_priority_t priority))
 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::interface11::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::interface11::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, function_input< Input, Output, Policy, A > >
void reset_function_input_base (reset_flags f)
 
void reset_receiver (reset_flags f) __TBB_override
 
graph & graph_reference () const __TBB_override
 
tasktry_get_postponed_task (const input_type &i)
 
- Protected Member Functions inherited from tbb::flow::interface11::receiver< Input >
virtual tasktry_put_task_wrapper (const void *p, bool is_async) __TBB_override
 
- Protected Member Functions inherited from tbb::flow::interface11::internal::untyped_receiver
template<typename X >
tasktry_put_task (const X &t)
 
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, function_input< Input, Output, Policy, A > >
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
 

Additional Inherited Members

- Public Attributes inherited from tbb::flow::interface11::receiver< Input >
__TBB_DEPRECATED typedef Input input_type
 The input type of this receiver. More...
 
__TBB_DEPRECATED typedef internal::async_helpers< Input >::filtered_type filtered_type
 

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 
)
inline

Definition at line 432 of file _flow_graph_node_impl.h.

438  }
function_body_type * my_init_body
the leaf for function_body
function_input_base< Input, Policy, A, my_class > base_type
#define __TBB_FLOW_GRAPH_PRIORITY_ARG1(arg1, priority)
int max_concurrency()
Returns the maximal number of threads that can work inside the arena.
Definition: task_arena.h:490
function_body_type * my_body

◆ 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 441 of file _flow_graph_node_impl.h.

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

◆ ~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 458 of file _flow_graph_node_impl.h.

458  {
459  // There is an extra copied needed to capture the
460  // body execution without the try_put
462  output_type v = (*my_body)(i);
464  return v;
465  }
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 468 of file _flow_graph_node_impl.h.

468  {
470 #if TBB_DEPRECATED_MESSAGE_FLOW_ORDER
471  task* successor_task = successors().try_put_task(v);
472 #endif
473  task* postponed_task = NULL;
474  if( base_type::my_max_concurrency != 0 ) {
475  postponed_task = base_type::try_get_postponed_task(i);
476  __TBB_ASSERT( !postponed_task || postponed_task != SUCCESSFULLY_ENQUEUED, NULL );
477  }
478 #if TBB_DEPRECATED_MESSAGE_FLOW_ORDER
479  graph& g = base_type::my_graph_ref;
480  return combine_tasks(g, successor_task, postponed_task);
481 #else
482  if( postponed_task ) {
483  // make the task available for other workers since we do not know successors'
484  // execution policy
486  }
487  task* successor_task = successors().try_put_task(v);
488 #if _MSC_VER && !__INTEL_COMPILER
489 #pragma warning (push)
490 #pragma warning (disable: 4127) /* suppress conditional expression is constant */
491 #endif
493 #if _MSC_VER && !__INTEL_COMPILER
494 #pragma warning (pop)
495 #endif
496  if(!successor_task) {
497  // Return confirmative status since current
498  // node's body has been executed anyway
499  successor_task = SUCCESSFULLY_ENQUEUED;
500  }
501  }
502  return successor_task;
503 #endif /* TBB_DEPRECATED_MESSAGE_FLOW_ORDER */
504  }
virtual broadcast_cache< output_type > & successors()=0
void spawn_in_graph_arena(tbb::flow::interface10::graph &g, tbb::task &arena_task)
Spawns a task inside graph arena.
graph & graph_reference() const __TBB_override
task * try_get_postponed_task(const input_type &i)
task * try_put_task(const T &t) __TBB_override
static tbb::task *const SUCCESSFULLY_ENQUEUED
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
#define __TBB_ASSERT(predicate, comment)
No-op version of __TBB_ASSERT.
Definition: tbb_stddef.h:165
static tbb::task * combine_tasks(graph &g, tbb::task *left, tbb::task *right)
Definition: flow_graph.h:199
output_type apply_body_impl(const input_type &i)

References __TBB_ASSERT, internal::function_input< Input, Output, Policy, A >::apply_body_impl(), tbb::flow::interface11::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::interface11::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 453 of file _flow_graph_node_impl.h.

453  {
454  function_body_type &body_ref = *this->my_body;
455  return dynamic_cast< internal::function_body_leaf<input_type, output_type, Body> & >(body_ref).get_body();
456  }
the leaf for function_body
function_body< input_type, output_type > function_body_type
function_body_type * my_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

Definition at line 508 of file _flow_graph_node_impl.h.

508  {
510  if(f & rf_reset_bodies) {
512  delete my_body;
513  my_body = tmp;
514  }
515  }
function_body_type * my_init_body
void reset_function_input_base(reset_flags f)
function_body< input_type, output_type > function_body_type
virtual function_body * clone()=0
function_body_type * my_body

References internal::function_body< Input, Output >::clone(), internal::function_input< Input, Output, Policy, A >::my_body, internal::function_input< Input, Output, Policy, A >::my_init_body, internal::function_input_base< Input, Policy, A, ImplType >::reset_function_input_base(), and tbb::flow::interface11::rf_reset_bodies.

Here is the call graph for this function:

◆ 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-2020 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.