Files
tbb/doc/html/a00160.html
T
Hans Johnson e32d75f876 ENH: Update to TBB 2017 (2016-09-08 release)
The new release TBB is now under a new more
open license.
                                 Apache License
                           Version 2.0, January 2004
                        http://www.apache.org/licenses/

The list of most significant changes made over time in
Intel(R) Threading Building Blocks (Intel(R) TBB).

Intel TBB 2017
TBB_INTERFACE_VERSION == 9100

Changes (w.r.t. Intel TBB 4.4 Update 5):

- static_partitioner class is now a fully supported feature.
- async_node class is now a fully supported feature.
- Improved dynamic memory allocation replacement on Windows* OS to skip
    DLLs for which replacement cannot be done, instead of aborting.
- Intel TBB no longer performs dynamic memory allocation replacement
    for Microsoft* Visual Studio* 2008.
- For 64-bit platforms, quadrupled the worst-case limit on the amount
    of memory the Intel TBB allocator can handle.
- Added TBB_USE_GLIBCXX_VERSION macro to specify the version of GNU
    libstdc++ when it cannot be properly recognized, e.g. when used
    with Clang on Linux* OS. Inspired by a contribution from David A.
- Added graph/stereo example to demostrate tbb::flow::async_msg.
- Removed a few cases of excessive user data copying in the flow graph.
- Reworked split_node to eliminate unnecessary overheads.
- Added support for C++11 move semantics to the argument of
    tbb::parallel_do_feeder::add() method.
- Added C++11 move constructor and assignment operator to
    tbb::combinable template class.
- Added tbb::this_task_arena::max_concurrency() function and
    max_concurrency() method of class task_arena returning the maximal
    number of threads that can work inside an arena.
- Deprecated tbb::task_arena::current_thread_index() static method;
    use tbb::this_task_arena::current_thread_index() function instead.
- All examples for commercial version of library moved online:
    https://software.intel.com/en-us/product-code-samples. Examples are
    available as a standalone package or as a part of Intel(R) Parallel
    Studio XE or Intel(R) System Studio Online Samples packages.

Changes affecting backward compatibility:

- Renamed following methods and types in async_node class:
    Old                   New
    async_gateway_type => gateway_type
    async_gateway()    => gateway()
    async_try_put()    => try_put()
    async_reserve()    => reserve_wait()
    async_commit()     => release_wait()
- Internal layout of some flow graph nodes has changed; recompilation
    is recommended for all binaries that use the flow graph.

Preview Features:

- Added template class streaming_node to the flow graph API. It allows
    a flow graph to offload computations to other devices through
    streaming or offloading APIs.
- Template class opencl_node reimplemented as a specialization of
    streaming_node that works with OpenCL*.
- Added tbb::this_task_arena::isolate() function to isolate execution
    of a group of tasks or an algorithm from other tasks submitted
    to the scheduler.

Bugs fixed:

- Added a workaround for GCC bug #62258 in std::rethrow_exception()
    to prevent possible problems in case of exception propagation.
- Fixed parallel_scan to provide correct result if the initial value
    of an accumulator is not the operation identity value.
- Fixed a memory corruption in the memory allocator when it meets
    internal limits.
- Fixed the memory allocator on 64-bit platforms to align memory
    to 16 bytes by default for all allocations bigger than 8 bytes.
- As a workaround for crashes in the Intel TBB library compiled with
    GCC 6, added -flifetime-dse=1 to compilation options on Linux* OS.
- Fixed a race in the flow graph implementation.

Open-source contributions integrated:

- Enabling use of C++11 'override' keyword by Raf Schietekat.

------------------------------------------------------------------------
2016-09-28 21:12:48 +02:00

154 lines
14 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=9"/>
<meta name="generator" content="Doxygen 1.8.4"/>
<title>tbb::flow::interface9::internal::untyped_sender Class Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<!-- end header part -->
<!-- Generated by Doxygen 1.8.4 -->
<div id="navrow1" class="tabs">
<ul class="tablist">
<li><a href="index.html"><span>Main&#160;Page</span></a></li>
<li><a href="pages.html"><span>Related&#160;Pages</span></a></li>
<li><a href="modules.html"><span>Modules</span></a></li>
<li><a href="namespaces.html"><span>Namespaces</span></a></li>
<li class="current"><a href="annotated.html"><span>Classes</span></a></li>
<li><a href="files.html"><span>Files</span></a></li>
</ul>
</div>
<div id="navrow2" class="tabs2">
<ul class="tablist">
<li><a href="annotated.html"><span>Class&#160;List</span></a></li>
<li><a href="hierarchy.html"><span>Class&#160;Hierarchy</span></a></li>
<li><a href="functions.html"><span>Class&#160;Members</span></a></li>
</ul>
</div>
<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="a00228.html">tbb</a></li><li class="navelem"><b>flow</b></li><li class="navelem"><b>interface9</b></li><li class="navelem"><b>internal</b></li><li class="navelem"><a class="el" href="a00160.html">untyped_sender</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#pub-types">Public Types</a> &#124;
<a href="#pub-methods">Public Member Functions</a> &#124;
<a href="#pro-methods">Protected Member Functions</a> &#124;
<a href="#friends">Friends</a> &#124;
<a href="a00343.html">List of all members</a> </div>
<div class="headertitle">
<div class="title">tbb::flow::interface9::internal::untyped_sender Class Reference<span class="mlabels"><span class="mlabel">abstract</span></span></div> </div>
</div><!--header-->
<div class="contents">
<div class="dynheader">
Inheritance diagram for tbb::flow::interface9::internal::untyped_sender:</div>
<div class="dyncontent">
<div class="center">
<img src="a00160.png" usemap="#tbb::flow::interface9::internal::untyped_sender_map" alt=""/>
<map id="tbb::flow::interface9::internal::untyped_sender_map" name="tbb::flow::interface9::internal::untyped_sender_map">
<area href="a00134.html" title="Pure virtual template class that defines a sender of messages of type T. " alt="tbb::flow::interface9::sender&lt; T &gt;" shape="rect" coords="0,56,266,80"/>
</map>
</div></div>
<table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-types"></a>
Public Types</h2></td></tr>
<tr class="memitem:a7b4e68e6917207283f5c621e7053c7ea"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a7b4e68e6917207283f5c621e7053c7ea"></a>
typedef <a class="el" href="a00159.html">untyped_receiver</a>&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00160.html#a7b4e68e6917207283f5c621e7053c7ea">successor_type</a></td></tr>
<tr class="memdesc:a7b4e68e6917207283f5c621e7053c7ea"><td class="mdescLeft">&#160;</td><td class="mdescRight">The successor type for this node. <br/></td></tr>
<tr class="separator:a7b4e68e6917207283f5c621e7053c7ea"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a0d674709d3783ec5b42eb243069fed73"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0d674709d3783ec5b42eb243069fed73"></a>
typedef <br class="typebreak"/>
<a class="el" href="a00054.html">internal::edge_container</a><br class="typebreak"/>
&lt; <a class="el" href="a00160.html#a7b4e68e6917207283f5c621e7053c7ea">successor_type</a> &gt;&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00160.html#a0d674709d3783ec5b42eb243069fed73">built_successors_type</a></td></tr>
<tr class="memdesc:a0d674709d3783ec5b42eb243069fed73"><td class="mdescLeft">&#160;</td><td class="mdescRight">interface to record edges for traversal &amp; deletion <br/></td></tr>
<tr class="separator:a0d674709d3783ec5b42eb243069fed73"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ab2b4041678d97545a6785d8d3fad01d0"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ab2b4041678d97545a6785d8d3fad01d0"></a>
typedef <br class="typebreak"/>
built_successors_type::edge_list_type&#160;</td><td class="memItemRight" valign="bottom"><b>successor_list_type</b></td></tr>
<tr class="separator:ab2b4041678d97545a6785d8d3fad01d0"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-methods"></a>
Public Member Functions</h2></td></tr>
<tr class="memitem:a2298076f4c5e52a6c9c8a8e6fbfbd9de"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a2298076f4c5e52a6c9c8a8e6fbfbd9de"></a>
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00160.html#a2298076f4c5e52a6c9c8a8e6fbfbd9de">register_successor</a> (<a class="el" href="a00160.html#a7b4e68e6917207283f5c621e7053c7ea">successor_type</a> &amp;r)=0</td></tr>
<tr class="memdesc:a2298076f4c5e52a6c9c8a8e6fbfbd9de"><td class="mdescLeft">&#160;</td><td class="mdescRight">Add a new successor to this node. <br/></td></tr>
<tr class="separator:a2298076f4c5e52a6c9c8a8e6fbfbd9de"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a32affec91647eba02f826f18f43e02e5"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a32affec91647eba02f826f18f43e02e5"></a>
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00160.html#a32affec91647eba02f826f18f43e02e5">remove_successor</a> (<a class="el" href="a00160.html#a7b4e68e6917207283f5c621e7053c7ea">successor_type</a> &amp;r)=0</td></tr>
<tr class="memdesc:a32affec91647eba02f826f18f43e02e5"><td class="mdescLeft">&#160;</td><td class="mdescRight">Removes a successor from this node. <br/></td></tr>
<tr class="separator:a32affec91647eba02f826f18f43e02e5"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac81ea252a8397324c865b035f67903ee"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ac81ea252a8397324c865b035f67903ee"></a>
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00160.html#ac81ea252a8397324c865b035f67903ee">try_release</a> ()</td></tr>
<tr class="memdesc:ac81ea252a8397324c865b035f67903ee"><td class="mdescLeft">&#160;</td><td class="mdescRight">Releases the reserved item. <br/></td></tr>
<tr class="separator:ac81ea252a8397324c865b035f67903ee"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:acfb8e3669932e5866fb6afa603ff8250"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="acfb8e3669932e5866fb6afa603ff8250"></a>
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="a00160.html#acfb8e3669932e5866fb6afa603ff8250">try_consume</a> ()</td></tr>
<tr class="memdesc:acfb8e3669932e5866fb6afa603ff8250"><td class="mdescLeft">&#160;</td><td class="mdescRight">Consumes the reserved item. <br/></td></tr>
<tr class="separator:acfb8e3669932e5866fb6afa603ff8250"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a9cc32ffab2489f9d70edab006ee2df83"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a9cc32ffab2489f9d70edab006ee2df83"></a>
virtual <a class="el" href="a00160.html#a0d674709d3783ec5b42eb243069fed73">built_successors_type</a> &amp;&#160;</td><td class="memItemRight" valign="bottom"><b>built_successors</b> ()=0</td></tr>
<tr class="separator:a9cc32ffab2489f9d70edab006ee2df83"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ac288603db6720be86ebf6cc1e9e4c5fd"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ac288603db6720be86ebf6cc1e9e4c5fd"></a>
virtual void&#160;</td><td class="memItemRight" valign="bottom"><b>internal_add_built_successor</b> (<a class="el" href="a00160.html#a7b4e68e6917207283f5c621e7053c7ea">successor_type</a> &amp;)=0</td></tr>
<tr class="separator:ac288603db6720be86ebf6cc1e9e4c5fd"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ace0532a9e923b5e733938db6adb7767c"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="ace0532a9e923b5e733938db6adb7767c"></a>
virtual void&#160;</td><td class="memItemRight" valign="bottom"><b>internal_delete_built_successor</b> (<a class="el" href="a00160.html#a7b4e68e6917207283f5c621e7053c7ea">successor_type</a> &amp;)=0</td></tr>
<tr class="separator:ace0532a9e923b5e733938db6adb7767c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a99384060eefdb259344dca4070146594"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a99384060eefdb259344dca4070146594"></a>
virtual void&#160;</td><td class="memItemRight" valign="bottom"><b>copy_successors</b> (successor_list_type &amp;)=0</td></tr>
<tr class="separator:a99384060eefdb259344dca4070146594"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a37871aa7dc631508ceb0e08ad052f596"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a37871aa7dc631508ceb0e08ad052f596"></a>
virtual size_t&#160;</td><td class="memItemRight" valign="bottom"><b>successor_count</b> ()=0</td></tr>
<tr class="separator:a37871aa7dc631508ceb0e08ad052f596"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pro-methods"></a>
Protected Member Functions</h2></td></tr>
<tr class="memitem:a3c422ea58b7f11b6cc536539000a556e"><td class="memTemplParams" colspan="2"><a class="anchor" id="a3c422ea58b7f11b6cc536539000a556e"></a>
template&lt;typename X &gt; </td></tr>
<tr class="memitem:a3c422ea58b7f11b6cc536539000a556e"><td class="memTemplItemLeft" align="right" valign="top">bool&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a00160.html#a3c422ea58b7f11b6cc536539000a556e">try_get</a> (X &amp;t)</td></tr>
<tr class="memdesc:a3c422ea58b7f11b6cc536539000a556e"><td class="mdescLeft">&#160;</td><td class="mdescRight">Request an item from the sender. <br/></td></tr>
<tr class="separator:a3c422ea58b7f11b6cc536539000a556e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:ad48b26c7dec4845e1cb374e9f1c59fea"><td class="memTemplParams" colspan="2"><a class="anchor" id="ad48b26c7dec4845e1cb374e9f1c59fea"></a>
template&lt;typename X &gt; </td></tr>
<tr class="memitem:ad48b26c7dec4845e1cb374e9f1c59fea"><td class="memTemplItemLeft" align="right" valign="top">bool&#160;</td><td class="memTemplItemRight" valign="bottom"><a class="el" href="a00160.html#ad48b26c7dec4845e1cb374e9f1c59fea">try_reserve</a> (X &amp;t)</td></tr>
<tr class="memdesc:ad48b26c7dec4845e1cb374e9f1c59fea"><td class="mdescLeft">&#160;</td><td class="mdescRight">Reserves an item in the sender. <br/></td></tr>
<tr class="separator:ad48b26c7dec4845e1cb374e9f1c59fea"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a17b4154442ad56d01de962120dd4329e"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a17b4154442ad56d01de962120dd4329e"></a>
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><b>try_get_wrapper</b> (void *p, bool is_async)=0</td></tr>
<tr class="separator:a17b4154442ad56d01de962120dd4329e"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a0d18a17d1738a6dd0aa8ffee8a5a22d4"><td class="memItemLeft" align="right" valign="top"><a class="anchor" id="a0d18a17d1738a6dd0aa8ffee8a5a22d4"></a>
virtual bool&#160;</td><td class="memItemRight" valign="bottom"><b>try_reserve_wrapper</b> (void *p, bool is_async)=0</td></tr>
<tr class="separator:a0d18a17d1738a6dd0aa8ffee8a5a22d4"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="friends"></a>
Friends</h2></td></tr>
<tr class="memitem:a3cdf409b9c27b036b9cb0fd9ae00a4a8"><td class="memTemplParams" colspan="2"><a class="anchor" id="a3cdf409b9c27b036b9cb0fd9ae00a4a8"></a>
template&lt;typename , typename &gt; </td></tr>
<tr class="memitem:a3cdf409b9c27b036b9cb0fd9ae00a4a8"><td class="memTemplItemLeft" align="right" valign="top">class&#160;</td><td class="memTemplItemRight" valign="bottom"><b>internal::predecessor_cache</b></td></tr>
<tr class="separator:a3cdf409b9c27b036b9cb0fd9ae00a4a8"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a3175bd06b97cbe15f7135fa6e0960d19"><td class="memTemplParams" colspan="2"><a class="anchor" id="a3175bd06b97cbe15f7135fa6e0960d19"></a>
template&lt;typename , typename &gt; </td></tr>
<tr class="memitem:a3175bd06b97cbe15f7135fa6e0960d19"><td class="memTemplItemLeft" align="right" valign="top">class&#160;</td><td class="memTemplItemRight" valign="bottom"><b>internal::reservable_predecessor_cache</b></td></tr>
<tr class="separator:a3175bd06b97cbe15f7135fa6e0960d19"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
<hr/>The documentation for this class was generated from the following file:<ul>
<li><a class="el" href="a00184.html">flow_graph.h</a></li>
</ul>
</div><!-- contents -->
<hr>
<p></p>
Copyright &copy; 2005-2016 Intel Corporation. All Rights Reserved.
<p></p>
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.
<p></p>
* Other names and brands may be claimed as the property of others.