diff options
Diffstat (limited to 'doc/html/signals2')
| -rw-r--r-- | doc/html/signals2/api_changes.html | 20 | ||||
| -rw-r--r-- | doc/html/signals2/faq.html | 12 | ||||
| -rw-r--r-- | doc/html/signals2/rationale.html | 46 | ||||
| -rw-r--r-- | doc/html/signals2/reference.html | 10 | ||||
| -rw-r--r-- | doc/html/signals2/tests.html | 12 | ||||
| -rw-r--r-- | doc/html/signals2/thread-safety.html | 18 | ||||
| -rw-r--r-- | doc/html/signals2/tutorial.html | 100 |
7 files changed, 109 insertions, 109 deletions
diff --git a/doc/html/signals2/api_changes.html b/doc/html/signals2/api_changes.html index 4a74fd11cf..9f346e42a1 100644 --- a/doc/html/signals2/api_changes.html +++ b/doc/html/signals2/api_changes.html @@ -73,7 +73,7 @@ <p> Automatic connection management is now achieved through the use of <code class="computeroutput">shared_ptr</code>/<code class="computeroutput">weak_ptr</code> - and <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp720124368-bb">signals2::slot::track</a></code>(), as described in the + and <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp746817216-bb">signals2::slot::track</a></code>(), as described in the <a class="link" href="tutorial.html#signals2.tutorial.connection-management" title="Automatic Connection Management (Intermediate)">tutorial</a>. However, the old (thread-unsafe) Boost.Signals scheme of automatic connection management is still supported via the <code class="computeroutput"><a class="link" href="../boost/signals2/trackable.html" title="Class trackable">boost::signals2::trackable</a></code> class. @@ -107,7 +107,7 @@ move the connection creation from the constructor to to the an <code class="computeroutput">adl_postconstruct</code> function, where a reference to the owning <code class="computeroutput">shared_ptr</code> is available for - passing to <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp720124368-bb">signals2::slot::track</a></code>. + passing to <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp746817216-bb">signals2::slot::track</a></code>. The <code class="computeroutput"><a class="link" href="../boost/signals2/deconstruct.html" title="Function deconstruct">deconstruct</a></code> function would be used create objects of the class and run their associated <code class="computeroutput">adl_postconstruct</code> function. You can enforce use of <code class="computeroutput"><a class="link" href="../boost/signals2/deconstruct.html" title="Function deconstruct">deconstruct</a></code> by @@ -161,7 +161,7 @@ <p> The <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html" title="Class template signal">signals2::signal</a></code> class has an additional typedef <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#boost.signals2.signal.extended_slot_type">signals2::signal::extended_slot_type</a></code> - and new <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719885936-bb">signals2::signal::connect_extended</a></code>() + and new <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746578784-bb">signals2::signal::connect_extended</a></code>() methods. These allow connection of slots which take an additional <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html" title="Class connection">signals2::connection</a></code> argument, giving them thread-safe access to their signal/slot connection when they are invoked. There is also a @@ -174,7 +174,7 @@ if you have slots which need access to their <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html" title="Class connection">signals2::connection</a></code> to the signal invoking them (for example to block or disconnect their connection) you may wish to connect the slots with - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719885936-bb">signals2::signal::connect_extended</a></code>(). + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746578784-bb">signals2::signal::connect_extended</a></code>(). This also requires adding an additional connection argument to the slot. More information on how and why to use extended slots is available in the <a class="link" href="tutorial.html#signals2.tutorial.extended-slot-type" title="Giving a Slot Access to its Connection (Advanced)">tutorial</a>. @@ -197,14 +197,14 @@ </li> <li class="listitem"> <p>The <code class="computeroutput">signal::combiner()</code> method, which formerly returned a reference to the - signal's combiner has been replaced by <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719943696-bb">signals2::signal::combiner</a></code> - (which now returns the combiner by value) and <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719946304-bb">signals2::signal::set_combiner</a></code>. + signal's combiner has been replaced by <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746636544-bb">signals2::signal::combiner</a></code> + (which now returns the combiner by value) and <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746639152-bb">signals2::signal::set_combiner</a></code>. </p> <p> During porting it should be straightforward to replace uses of the old reference-returning <code class="computeroutput">signal::combiner()</code> - function with the new "by-value" <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719943696-bb">signals2::signal::combiner</a></code> - and <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719946304-bb">signals2::signal::set_combiner</a></code> functions. + function with the new "by-value" <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746636544-bb">signals2::signal::combiner</a></code> + and <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746639152-bb">signals2::signal::set_combiner</a></code> functions. However, you will need to inspect each call of the <code class="computeroutput">combiner</code> method in your code to determine if your program logic has been broken by the changed return type. @@ -271,7 +271,7 @@ <div class="titlepage"><div><div><h4 class="title"> <a name="signals2.api_history.1-45"></a>Version 1.45</h4></div></div></div> <p> - Version 1.45 added <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp720138384-bb">slot::track_foreign</a></code>(). This method allows tracking + Version 1.45 added <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp746831232-bb">slot::track_foreign</a></code>(). This method allows tracking of objects owned by <code class="computeroutput">shared_ptr</code> classes other than <code class="computeroutput">boost::shared_ptr</code>, for example <code class="computeroutput">std::shared_ptr</code>. </p> @@ -292,7 +292,7 @@ immediately blocking its connection. </p></li> <li class="listitem"><p> - The <code class="computeroutput"><a class="link" href="../boost/signals2/shared_connection_block.html#idp719800880-bb">shared_connection_block::connection</a></code>() query has been + The <code class="computeroutput"><a class="link" href="../boost/signals2/shared_connection_block.html#idp746493728-bb">shared_connection_block::connection</a></code>() query has been added, to provide access to the <code class="computeroutput">shared_connection_block</code>s associated connection. </p></li> diff --git a/doc/html/signals2/faq.html b/doc/html/signals2/faq.html index 8df1e23eb1..6fecf60648 100644 --- a/doc/html/signals2/faq.html +++ b/doc/html/signals2/faq.html @@ -27,11 +27,11 @@ <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="signals2.faq"></a>Frequently Asked Questions</h2></div></div></div> <div class="qandaset"> -<a name="idp525016672"></a><dl> -<dt>1. <a href="faq.html#idp525016928">Don't noncopyable signal semantics mean that a class +<a name="idp508747424"></a><dl> +<dt>1. <a href="faq.html#idp508747680">Don't noncopyable signal semantics mean that a class with a signal member will be noncopyable as well?</a> </dt> -<dt>2. <a href="faq.html#idp525019280">Is Boost.Signals2 thread-safe?</a> +<dt>2. <a href="faq.html#idp508750032">Is Boost.Signals2 thread-safe?</a> </dt> </dl> <table border="0" style="width: 100%;"> @@ -42,7 +42,7 @@ <tbody> <tr class="question"> <td align="left" valign="top"> -<a name="idp525016928"></a><a name="idp525017184"></a><p><b>1.</b></p> +<a name="idp508747680"></a><a name="idp508747936"></a><p><b>1.</b></p> </td> <td align="left" valign="top"><p>Don't noncopyable signal semantics mean that a class with a signal member will be noncopyable as well?</p></td> @@ -57,7 +57,7 @@ </tr> <tr class="question"> <td align="left" valign="top"> -<a name="idp525019280"></a><a name="idp525019536"></a><p><b>2.</b></p> +<a name="idp508750032"></a><a name="idp508750288"></a><p><b>2.</b></p> </td> <td align="left" valign="top"><p>Is Boost.Signals2 thread-safe?</p></td> </tr> @@ -71,7 +71,7 @@ with signal invocation, you will need to use automatic connection management. That is, the objects will need to be owned by <code class="computeroutput">shared_ptr</code> and passed to the slot's - <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp720124368-bb">track</a></code>() method before the slot is connected. + <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp746817216-bb">track</a></code>() method before the slot is connected. The <code class="computeroutput"><a class="link" href="../boost/signals2/trackable.html" title="Class trackable">signals2::trackable</a></code> scheme of automatic connection management is NOT thread-safe, and is only provided to ease porting of single-threaded code from Boost.Signals to Boost.Signals2. diff --git a/doc/html/signals2/rationale.html b/doc/html/signals2/rationale.html index fda1eeef67..b86251860e 100644 --- a/doc/html/signals2/rationale.html +++ b/doc/html/signals2/rationale.html @@ -27,17 +27,17 @@ <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="signals2.rationale"></a>Design Rationale</h2></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="rationale.html#idp525029280">User-level Connection Management</a></span></dt> -<dt><span class="section"><a href="rationale.html#idp525047920">Automatic Connection Management</a></span></dt> -<dt><span class="section"><a href="rationale.html#idp525065040"><code class="computeroutput">optional_last_value</code> as the Default Combiner</a></span></dt> -<dt><span class="section"><a href="rationale.html#idp525071584">Combiner Interface</a></span></dt> -<dt><span class="section"><a href="rationale.html#idp525087552">Connection Interfaces: += operator</a></span></dt> -<dt><span class="section"><a href="rationale.html#idp525106976">Signals2 Mutex Classes</a></span></dt> -<dt><span class="section"><a href="rationale.html#idp525117456">Comparison with other Signal/Slot implementations</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508760160">User-level Connection Management</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508778800">Automatic Connection Management</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508795920"><code class="computeroutput">optional_last_value</code> as the Default Combiner</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508802464">Combiner Interface</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508817536">Connection Interfaces: += operator</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508836912">Signals2 Mutex Classes</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508847392">Comparison with other Signal/Slot implementations</a></span></dt> </dl></div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp525029280"></a>User-level Connection Management</h3></div></div></div> +<a name="idp508760160"></a>User-level Connection Management</h3></div></div></div> <p> Users need to have fine control over the connection of signals to slots and their eventual disconnection. The primary approach taken by Boost.Signals2 is to return a @@ -45,14 +45,14 @@ connected/disconnected query, manual disconnection, and an automatic disconnection on destruction mode (<code class="computeroutput"><a class="link" href="../boost/signals2/scoped_connection.html" title="Class scoped_connection">signals2::scoped_connection</a></code>). In addition, two other interfaces are supported by the - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719898512-bb">signal::disconnect</a></code> overloaded method:</p> + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746591360-bb">signal::disconnect</a></code> overloaded method:</p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> <li class="listitem"><p><span class="bold"><strong>Pass slot to disconnect</strong></span>: in this interface model, the disconnection of a slot connected with - <code class="computeroutput">sig.<a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a>(typeof(sig)::slot_type(slot_func))</code> is + <code class="computeroutput">sig.<a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a>(typeof(sig)::slot_type(slot_func))</code> is performed via - <code class="computeroutput">sig.<a class="link" href="../boost/signals2/signal.html#idp719898512-bb">disconnect</a>(slot_func)</code>. Internally, + <code class="computeroutput">sig.<a class="link" href="../boost/signals2/signal.html#idp746591360-bb">disconnect</a>(slot_func)</code>. Internally, a linear search using slot comparison is performed and the slot, if found, is removed from the list. Unfortunately, querying connectedness ends up as a @@ -80,14 +80,14 @@ </ul></div> <p> This type of interface is supported in Boost.Signals2 via the slot grouping mechanism, and the overload of - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719898512-bb">signal::disconnect</a></code> + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746591360-bb">signal::disconnect</a></code> which takes an argument of the signal's <code class="computeroutput">Group</code> type.</p> </li> </ul></div> </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp525047920"></a>Automatic Connection Management</h3></div></div></div> +<a name="idp508778800"></a>Automatic Connection Management</h3></div></div></div> <p>Automatic connection management in Signals2 depends on the use of <code class="computeroutput">boost::shared_ptr</code> to manage the lifetimes of tracked objects. This is differs from @@ -129,7 +129,7 @@ </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp525065040"></a><code class="computeroutput">optional_last_value</code> as the Default Combiner</h3></div></div></div> +<a name="idp508795920"></a><code class="computeroutput">optional_last_value</code> as the Default Combiner</h3></div></div></div> <p> The default combiner for Boost.Signals2 has changed from the <code class="computeroutput">last_value</code> combiner used by default in the original Boost.Signals library. @@ -145,7 +145,7 @@ </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp525071584"></a>Combiner Interface</h3></div></div></div> +<a name="idp508802464"></a>Combiner Interface</h3></div></div></div> <p> The Combiner interface was chosen to mimic a call to an algorithm in the C++ standard library. It is felt that by viewing slot call results as merely a sequence of values accessed by input @@ -273,9 +273,9 @@ private: </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp525087552"></a>Connection Interfaces: += operator</h3></div></div></div> +<a name="idp508817536"></a>Connection Interfaces: += operator</h3></div></div></div> <p> Boost.Signals2 supports a connection syntax with the form - <code class="computeroutput">sig.<a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a>(slot)</code>, but a + <code class="computeroutput">sig.<a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a>(slot)</code>, but a more terse syntax <code class="computeroutput">sig += slot</code> has been suggested (and has been used by other signals & slots implementations). There are several reasons as to why this syntax has been @@ -313,7 +313,7 @@ private: </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp525106976"></a>Signals2 Mutex Classes</h3></div></div></div> +<a name="idp508836912"></a>Signals2 Mutex Classes</h3></div></div></div> <p> The Boost.Signals2 library provides 2 mutex classes: <code class="computeroutput"><a class="link" href="../boost/signals2/mutex.html" title="Class mutex">boost::signals2::mutex</a></code>, and <code class="computeroutput"><a class="link" href="../boost/signals2/dummy_mutex.html" title="Class dummy_mutex">boost::signals2::dummy_mutex</a></code>. The motivation for providing @@ -331,14 +331,14 @@ private: </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp525117456"></a>Comparison with other Signal/Slot implementations</h3></div></div></div> +<a name="idp508847392"></a>Comparison with other Signal/Slot implementations</h3></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="rationale.html#idp525118160">libsigc++</a></span></dt> -<dt><span class="section"><a href="rationale.html#idp525125280">.NET delegates</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508848096">libsigc++</a></span></dt> +<dt><span class="section"><a href="rationale.html#idp508855216">.NET delegates</a></span></dt> </dl></div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp525118160"></a>libsigc++</h4></div></div></div> +<a name="idp508848096"></a>libsigc++</h4></div></div></div> <p> <a href="http://libsigc.sourceforge.net" target="_top">libsigc++</a> is a C++ signals & slots library that originally started as part of an initiative to wrap the C interfaces to <a href="http://www.gtk.org" target="_top">GTK</a> libraries in C++, and has @@ -368,7 +368,7 @@ private: </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp525125280"></a>.NET delegates</h4></div></div></div> +<a name="idp508855216"></a>.NET delegates</h4></div></div></div> <p> <a href="http://www.microsoft.com" target="_top">Microsoft</a> has introduced the .NET Framework and an associated set of languages and language extensions, one of which is the diff --git a/doc/html/signals2/reference.html b/doc/html/signals2/reference.html index 531d05cdd6..f1f730de19 100644 --- a/doc/html/signals2/reference.html +++ b/doc/html/signals2/reference.html @@ -56,7 +56,7 @@ <pre class="synopsis"><span class="keyword">namespace</span> <span class="identifier">boost</span> <span class="special">{</span> <span class="keyword">namespace</span> <span class="identifier">signals2</span> <span class="special">{</span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/connection.html" title="Class connection">connection</a><span class="special">;</span> - <span class="keyword">void</span> <a class="link" href="../boost/signals2/connection.html#boost.signals2.connection.swap_idp719483632"><span class="identifier">swap</span></a><span class="special">(</span><a class="link" href="../boost/signals2/connection.html" title="Class connection">connection</a><span class="special">&</span><span class="special">,</span> <a class="link" href="../boost/signals2/connection.html" title="Class connection">connection</a><span class="special">&</span><span class="special">)</span><span class="special">;</span> + <span class="keyword">void</span> <a class="link" href="../boost/signals2/connection.html#boost.signals2.connection.swap_idp746176480"><span class="identifier">swap</span></a><span class="special">(</span><a class="link" href="../boost/signals2/connection.html" title="Class connection">connection</a><span class="special">&</span><span class="special">,</span> <a class="link" href="../boost/signals2/connection.html" title="Class connection">connection</a><span class="special">&</span><span class="special">)</span><span class="special">;</span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/scoped_connection.html" title="Class scoped_connection">scoped_connection</a><span class="special">;</span> <span class="special">}</span> <span class="special">}</span></pre> @@ -95,7 +95,7 @@ <span class="keyword">namespace</span> <span class="identifier">signals2</span> <span class="special">{</span> <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> T<span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/last_value.html" title="Class template last_value">last_value</a><span class="special">;</span> - <span class="keyword">template</span><span class="special"><</span><span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/last_value_vo_idp719678976.html" title="Class last_value<void>">last_value</a><span class="special"><</span><span class="keyword">void</span><span class="special">></span><span class="special">;</span> + <span class="keyword">template</span><span class="special"><</span><span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/last_value_vo_idp746371824.html" title="Class last_value<void>">last_value</a><span class="special"><</span><span class="keyword">void</span><span class="special">></span><span class="special">;</span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/no_slots_error.html" title="Class no_slots_error">no_slots_error</a><span class="special">;</span> <span class="special">}</span> @@ -117,7 +117,7 @@ <span class="keyword">namespace</span> <span class="identifier">signals2</span> <span class="special">{</span> <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> T<span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/optional_last_value.html" title="Class template optional_last_value">optional_last_value</a><span class="special">;</span> - <span class="keyword">template</span><span class="special"><</span><span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/optional_last_idp719737328.html" title="Class optional_last_value<void>">optional_last_value</a><span class="special"><</span><span class="keyword">void</span><span class="special">></span><span class="special">;</span> + <span class="keyword">template</span><span class="special"><</span><span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/optional_last_idp746430176.html" title="Class optional_last_value<void>">optional_last_value</a><span class="special"><</span><span class="keyword">void</span><span class="special">></span><span class="special">;</span> <span class="special">}</span> <span class="special">}</span></pre> </div> @@ -148,7 +148,7 @@ <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Signature<span class="special">,</span> <span class="keyword">typename</span> Combiner<span class="special">,</span> <span class="keyword">typename</span> Group<span class="special">,</span> <span class="keyword">typename</span> GroupCompare<span class="special">,</span> <span class="keyword">typename</span> SlotFunction<span class="special">,</span> <span class="keyword">typename</span> ExtendedSlotFunction<span class="special">,</span> <span class="keyword">typename</span> Mutex<span class="special">></span> - <span class="keyword">void</span> <a class="link" href="../boost/signals2/signal.html#boost.signals2.signal.swap_idp719956512"><span class="identifier">swap</span></a><span class="special">(</span><a class="link" href="../boost/signals2/signal.html" title="Class template signal">signal</a><span class="special"><</span><span class="identifier">Signature</span><span class="special">,</span> <span class="identifier">Combiner</span><span class="special">,</span> <span class="identifier">Group</span><span class="special">,</span> <span class="identifier">GroupCompare</span><span class="special">,</span> <span class="identifier">SlotFunction</span><span class="special">,</span> <span class="identifier">ExtendedSlotFunction</span><span class="special">,</span> <span class="identifier">Mutex</span><span class="special">></span><span class="special">&</span><span class="special">,</span> + <span class="keyword">void</span> <a class="link" href="../boost/signals2/signal.html#boost.signals2.signal.swap_idp746649360"><span class="identifier">swap</span></a><span class="special">(</span><a class="link" href="../boost/signals2/signal.html" title="Class template signal">signal</a><span class="special"><</span><span class="identifier">Signature</span><span class="special">,</span> <span class="identifier">Combiner</span><span class="special">,</span> <span class="identifier">Group</span><span class="special">,</span> <span class="identifier">GroupCompare</span><span class="special">,</span> <span class="identifier">SlotFunction</span><span class="special">,</span> <span class="identifier">ExtendedSlotFunction</span><span class="special">,</span> <span class="identifier">Mutex</span><span class="special">></span><span class="special">&</span><span class="special">,</span> <a class="link" href="../boost/signals2/signal.html" title="Class template signal">signal</a><span class="special"><</span><span class="identifier">Signature</span><span class="special">,</span> <span class="identifier">Combiner</span><span class="special">,</span> <span class="identifier">Group</span><span class="special">,</span> <span class="identifier">GroupCompare</span><span class="special">,</span> <span class="identifier">SlotFunction</span><span class="special">,</span> <span class="identifier">ExtendedSlotFunction</span><span class="special">,</span> <span class="identifier">Mutex</span><span class="special">></span><span class="special">&</span><span class="special">)</span><span class="special">;</span> <span class="special">}</span> <span class="special">}</span></pre> @@ -180,7 +180,7 @@ <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Group<span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/keywords/group_type.html" title="Class template group_type">group_type</a><span class="special">;</span> <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> GroupCompare<span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/keywords/group_compare_type.html" title="Class template group_compare_type">group_compare_type</a><span class="special">;</span> <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> SlotFunction<span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/keywords/slot_function_type.html" title="Class template slot_function_type">slot_function_type</a><span class="special">;</span> - <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> ExtendedSlotFunction<span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/keywords/extended_slot_idp720010032.html" title="Class template extended_slot_function_type">extended_slot_function_type</a><span class="special">;</span> + <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> ExtendedSlotFunction<span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/keywords/extended_slot_idp746702880.html" title="Class template extended_slot_function_type">extended_slot_function_type</a><span class="special">;</span> <span class="keyword">template</span><span class="special"><</span><span class="keyword">typename</span> Mutex<span class="special">></span> <span class="keyword">class</span> <a class="link" href="../boost/signals2/keywords/mutex_type.html" title="Class template mutex_type">mutex_type</a><span class="special">;</span> <span class="special">}</span> <span class="special">}</span> diff --git a/doc/html/signals2/tests.html b/doc/html/signals2/tests.html index c9e438c894..4e31fb8bee 100644 --- a/doc/html/signals2/tests.html +++ b/doc/html/signals2/tests.html @@ -8,7 +8,7 @@ <link rel="home" href="../index.html" title="The Boost C++ Libraries BoostBook Documentation Subset"> <link rel="up" href="../signals2.html" title="Chapter 36. Boost.Signals2"> <link rel="prev" href="api_changes.html" title="Signals2 API Changes"> -<link rel="next" href="../boost_staticassert.html" title="Chapter 37. Boost.StaticAssert"> +<link rel="next" href="../stacktrace.html" title="Chapter 37. Boost.Stacktrace 1.0"> </head> <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"> <table cellpadding="2" width="100%"><tr> @@ -21,15 +21,15 @@ </tr></table> <hr> <div class="spirit-nav"> -<a accesskey="p" href="api_changes.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../signals2.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../boost_staticassert.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> +<a accesskey="p" href="api_changes.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../signals2.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../stacktrace.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> </div> <div class="section"> <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="signals2.tests"></a>Testsuite</h2></div></div></div> -<div class="toc"><dl class="toc"><dt><span class="section"><a href="tests.html#idp525261728">Acceptance tests</a></span></dt></dl></div> +<div class="toc"><dl class="toc"><dt><span class="section"><a href="tests.html#idp508991856">Acceptance tests</a></span></dt></dl></div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp525261728"></a>Acceptance tests</h3></div></div></div> +<a name="idp508991856"></a>Acceptance tests</h3></div></div></div> <div class="informaltable"><table class="table"> <colgroup> <col> @@ -54,7 +54,7 @@ <tr> <td><p><a href="../../../libs/signals2/test/dead_slot_test.cpp" target="_top">dead_slot_test.cpp</a></p></td> <td><p>run</p></td> -<td><p>Ensure that calling <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a></code> with a slot +<td><p>Ensure that calling <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a></code> with a slot that has already expired does not actually connect to the slot.</p></td> <td> </td> @@ -112,7 +112,7 @@ connect to the slot.</p></td> </tr></table> <hr> <div class="spirit-nav"> -<a accesskey="p" href="api_changes.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../signals2.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../boost_staticassert.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> +<a accesskey="p" href="api_changes.html"><img src="../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../signals2.html"><img src="../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../index.html"><img src="../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="../stacktrace.html"><img src="../../../doc/src/images/next.png" alt="Next"></a> </div> </body> </html> diff --git a/doc/html/signals2/thread-safety.html b/doc/html/signals2/thread-safety.html index 7afec5aa09..3c3b447568 100644 --- a/doc/html/signals2/thread-safety.html +++ b/doc/html/signals2/thread-safety.html @@ -27,13 +27,13 @@ <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="signals2.thread-safety"></a>Thread-Safety</h2></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="thread-safety.html#idp524963664">Introduction</a></span></dt> -<dt><span class="section"><a href="thread-safety.html#idp524969824">Signals and combiners</a></span></dt> -<dt><span class="section"><a href="thread-safety.html#idp524992928">Connections and other classes</a></span></dt> +<dt><span class="section"><a href="thread-safety.html#idp508695472">Introduction</a></span></dt> +<dt><span class="section"><a href="thread-safety.html#idp508701568">Signals and combiners</a></span></dt> +<dt><span class="section"><a href="thread-safety.html#idp508723680">Connections and other classes</a></span></dt> </dl></div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp524963664"></a>Introduction</h3></div></div></div> +<a name="idp508695472"></a>Introduction</h3></div></div></div> <p> The primary motivation for Boost.Signals2 is to provide a version of the original Boost.Signals library which can be used safely in a @@ -50,7 +50,7 @@ </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp524969824"></a>Signals and combiners</h3></div></div></div> +<a name="idp508701568"></a>Signals and combiners</h3></div></div></div> <p> Each signal object default-constructs a <code class="computeroutput">Mutex</code> object to protect its internal state. Furthermore, a <code class="computeroutput">Mutex</code> is created @@ -62,7 +62,7 @@ signal's methods are called. The mutex is usually held until the method completes, however there is one major exception to this rule. When a signal is invoked by calling - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719925040-bb">signal::operator()</a></code>, + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746617888-bb">signal::operator()</a></code>, the invocation first acquires a lock on the signal's mutex. Then it obtains a handle to the signal's slot list and combiner. Next it releases the signal's mutex, before invoking the combiner to @@ -109,7 +109,7 @@ Note that since we unlock the connection's mutex before executing its associated slot, it is possible a slot will still be executing after it has been disconnected by a - <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html#idp719442048-bb">connection::disconnect</a>()</code>, if + <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html#idp746134896-bb">connection::disconnect</a>()</code>, if the disconnect was called concurrently with signal invocation. </p> <p> @@ -126,7 +126,7 @@ Future signal invocations will receive a handle to the newly created deep copy of the slot list, and the old slot list will be destroyed once it is no longer in use. Similarly, if you change a signal's combiner with - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719946304-bb">signal::set_combiner</a></code> + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746639152-bb">signal::set_combiner</a></code> while a signal invocation is running concurrently, the concurrent signal invocation will continue to use the old combiner undisturbed, while future signal invocations will receive a handle to the new combiner. @@ -164,7 +164,7 @@ </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp524992928"></a>Connections and other classes</h3></div></div></div> +<a name="idp508723680"></a>Connections and other classes</h3></div></div></div> <p> The methods of the <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html" title="Class connection">signals2::connection</a></code> class are thread-safe, with the exception of assignment and swap. This is achived via locking the mutex diff --git a/doc/html/signals2/tutorial.html b/doc/html/signals2/tutorial.html index 60264aa355..542d073f34 100644 --- a/doc/html/signals2/tutorial.html +++ b/doc/html/signals2/tutorial.html @@ -27,19 +27,19 @@ <div class="titlepage"><div><div><h2 class="title" style="clear: both"> <a name="signals2.tutorial"></a>Tutorial</h2></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="tutorial.html#idp521584688">How to Read this Tutorial</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521591472">Hello, World! (Beginner)</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521599200">Calling Multiple Slots</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521627648">Passing Values to and from Slots</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521679408">Connection Management</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505317376">How to Read this Tutorial</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505324064">Hello, World! (Beginner)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505331792">Calling Multiple Slots</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505359920">Passing Values to and from Slots</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505411616">Connection Management</a></span></dt> <dt><span class="section"><a href="tutorial.html#signals2.tutorial.document-view">Example: Document-View</a></span></dt> <dt><span class="section"><a href="tutorial.html#signals2.tutorial.extended-slot-type">Giving a Slot Access to its Connection (Advanced)</a></span></dt> <dt><span class="section"><a href="tutorial.html#signals2.tutorial.signal-mutex-template-parameter">Changing the <code class="computeroutput">Mutex</code> Type of a Signal (Advanced).</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521830576">Linking against the Signals2 library</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505562992">Linking against the Signals2 library</a></span></dt> </dl></div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp521584688"></a>How to Read this Tutorial</h3></div></div></div> +<a name="idp505317376"></a>How to Read this Tutorial</h3></div></div></div> <p>This tutorial is not meant to be read linearly. Its top-level structure roughly separates different concepts in the library (e.g., handling calling multiple slots, passing values to and from @@ -59,7 +59,7 @@ will not need to read the <span class="emphasis"><em>Advanced</em></span> sectio </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp521591472"></a>Hello, World! (Beginner)</h3></div></div></div> +<a name="idp505324064"></a>Hello, World! (Beginner)</h3></div></div></div> <p>The following example writes "Hello, World!" using signals and slots. First, we create a signal <code class="computeroutput">sig</code>, a signal that takes no arguments and has a void return value. Next, we connect @@ -89,14 +89,14 @@ World!".</p> </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp521599200"></a>Calling Multiple Slots</h3></div></div></div> +<a name="idp505331792"></a>Calling Multiple Slots</h3></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="tutorial.html#idp521599744">Connecting Multiple Slots (Beginner)</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521609920">Ordering Slot Call Groups (Intermediate)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505332336">Connecting Multiple Slots (Beginner)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505342512">Ordering Slot Call Groups (Intermediate)</a></span></dt> </dl></div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521599744"></a>Connecting Multiple Slots (Beginner)</h4></div></div></div> +<a name="idp505332336"></a>Connecting Multiple Slots (Beginner)</h4></div></div></div> <p>Calling a single slot from a signal isn't very interesting, so we can make the Hello, World program more interesting by splitting the work of printing "Hello, World!" into two completely separate @@ -140,7 +140,7 @@ Hello, World! </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521609920"></a>Ordering Slot Call Groups (Intermediate)</h4></div></div></div> +<a name="idp505342512"></a>Ordering Slot Call Groups (Intermediate)</h4></div></div></div> <p>Slots are free to have side effects, and that can mean that some slots will have to be called before others even if they are not connected in that order. The Boost.Signals2 library allows slots to be placed into groups that are ordered in @@ -166,7 +166,7 @@ group parameter and those that don't? The "unnamed" slots (i.e., those that have been connected without specifying a group name) can be placed at the front or back of the slot list (by passing <code class="computeroutput">boost::signals2::at_front</code> or <code class="computeroutput">boost::signals2::at_back</code> -as the last parameter to <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a></code>, respectively), +as the last parameter to <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a></code>, respectively), and default to the end of the list. When a group is specified, the final <code class="computeroutput">at_front</code> or <code class="computeroutput">at_back</code> parameter describes where the slot @@ -204,14 +204,14 @@ Hello, World! </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp521627648"></a>Passing Values to and from Slots</h3></div></div></div> +<a name="idp505359920"></a>Passing Values to and from Slots</h3></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="tutorial.html#idp521628208">Slot Arguments (Beginner)</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521641072">Signal Return Values (Advanced)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505360480">Slot Arguments (Beginner)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505373280">Signal Return Values (Advanced)</a></span></dt> </dl></div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521628208"></a>Slot Arguments (Beginner)</h4></div></div></div> +<a name="idp505360480"></a>Slot Arguments (Beginner)</h4></div></div></div> <p>Signals can propagate arguments to each of the slots they call. For instance, a signal that propagates mouse motion events might want to pass along the new mouse coordinates and whether the mouse @@ -272,7 +272,7 @@ connected to <code class="computeroutput">sig</code> must therefore be able to t </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521641072"></a>Signal Return Values (Advanced)</h4></div></div></div> +<a name="idp505373280"></a>Signal Return Values (Advanced)</h4></div></div></div> <p>Just as slots can receive arguments, they can also return values. These values can then be returned back to the caller of the signal through a <em class="firstterm">combiner</em>. The combiner is a mechanism @@ -451,20 +451,20 @@ struct DistributeRequest { </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp521679408"></a>Connection Management</h3></div></div></div> +<a name="idp505411616"></a>Connection Management</h3></div></div></div> <div class="toc"><dl class="toc"> -<dt><span class="section"><a href="tutorial.html#idp521679952">Disconnecting Slots (Beginner)</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521689552">Blocking Slots (Beginner)</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521696320">Scoped Connections (Intermediate)</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521707584">Disconnecting Equivalent Slots (Intermediate)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505412160">Disconnecting Slots (Beginner)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505421696">Blocking Slots (Beginner)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505428464">Scoped Connections (Intermediate)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505439728">Disconnecting Equivalent Slots (Intermediate)</a></span></dt> <dt><span class="section"><a href="tutorial.html#signals2.tutorial.connection-management">Automatic Connection Management (Intermediate)</a></span></dt> <dt><span class="section"><a href="tutorial.html#signals2.tutorial.deconstruct">Postconstructors and Predestructors (Advanced)</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521761184">When Can Disconnections Occur? (Intermediate)</a></span></dt> -<dt><span class="section"><a href="tutorial.html#idp521768784">Passing Slots (Intermediate)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505493408">When Can Disconnections Occur? (Intermediate)</a></span></dt> +<dt><span class="section"><a href="tutorial.html#idp505501008">Passing Slots (Intermediate)</a></span></dt> </dl></div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521679952"></a>Disconnecting Slots (Beginner)</h4></div></div></div> +<a name="idp505412160"></a>Disconnecting Slots (Beginner)</h4></div></div></div> <p>Slots aren't expected to exist indefinitely after they are connected. Often slots are only used to receive a few events and are then disconnected, and the programmer needs control to decide @@ -473,8 +473,8 @@ when a slot should no longer be connected.</p> <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html" title="Class connection">boost::signals2::connection</a></code> class. The <code class="computeroutput">connection</code> class uniquely represents the connection between a particular signal and a particular slot. The -<code class="computeroutput"><a class="link" href="../boost/signals2/connection.html#idp719446912-bb">connected</a>()</code> method checks if the signal and slot are -still connected, and the <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html#idp719442048-bb">disconnect()</a></code> method +<code class="computeroutput"><a class="link" href="../boost/signals2/connection.html#idp746139760-bb">connected</a>()</code> method checks if the signal and slot are +still connected, and the <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html#idp746134896-bb">disconnect()</a></code> method disconnects the signal and slot if they are connected before it is called. Each call to the signal's <code class="computeroutput">connect()</code> method returns a connection object, which can be used to determine if the @@ -490,7 +490,7 @@ connection still exists or to disconnect the signal and slot.</p> </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521689552"></a>Blocking Slots (Beginner)</h4></div></div></div> +<a name="idp505421696"></a>Blocking Slots (Beginner)</h4></div></div></div> <p>Slots can be temporarily "blocked", meaning that they will be ignored when the signal is invoked but have not been permanently disconnected. This is typically used to prevent infinite recursion in cases where @@ -499,7 +499,7 @@ invoked again. A <code class="computeroutput"><a class="link" href="../boost/signals2/shared_connection_block.html" title="Class shared_connection_block">boost::signals2::shared_connection_block</a></code> object will temporarily block a slot. The connection is unblocked by either destroying or calling -<code class="computeroutput"><a class="link" href="../boost/signals2/shared_connection_block.html#idp719787520-bb">unblock</a></code> +<code class="computeroutput"><a class="link" href="../boost/signals2/shared_connection_block.html#idp746480368-bb">unblock</a></code> on all the <code class="computeroutput">shared_connection_block</code> objects that reference the connection. Here is an example of @@ -519,7 +519,7 @@ blocking/unblocking slots:</p> </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521696320"></a>Scoped Connections (Intermediate)</h4></div></div></div> +<a name="idp505428464"></a>Scoped Connections (Intermediate)</h4></div></div></div> <p>The <code class="computeroutput"><a class="link" href="../boost/signals2/scoped_connection.html" title="Class scoped_connection">boost::signals2::scoped_connection</a></code> class references a signal/slot connection that will be disconnected when the <code class="computeroutput">scoped_connection</code> class goes out of scope. This @@ -540,22 +540,22 @@ e.g.,</p> </p> <pre class="programlisting"> // doesn't compile due to compiler attempting to copy a temporary scoped_connection object -// boost::signals2::scoped_connection c0 = sig.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a></code>(ShortLived()); +// boost::signals2::scoped_connection c0 = sig.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a></code>(ShortLived()); // okay -boost::signals2::scoped_connection c1(sig.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a></code>(ShortLived())); +boost::signals2::scoped_connection c1(sig.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a></code>(ShortLived())); // also okay boost::signals2::scoped_connection c2; -c2 = sig.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a></code>(ShortLived()); +c2 = sig.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a></code>(ShortLived()); </pre> </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521707584"></a>Disconnecting Equivalent Slots (Intermediate)</h4></div></div></div> +<a name="idp505439728"></a>Disconnecting Equivalent Slots (Intermediate)</h4></div></div></div> <p>One can disconnect slots that are equivalent to a given function object using a form of the -<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719898512-bb">signal::disconnect</a></code> method, so long as +<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746591360-bb">signal::disconnect</a></code> method, so long as the type of the function object has an accessible <code class="computeroutput">==</code> operator. For instance: @@ -610,7 +610,7 @@ public: // ... NewsMessageArea *newsMessageArea = new NewsMessageArea(/* ... */); // ... -deliverNews.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a></code>(boost::bind(&NewsMessageArea::displayNews, +deliverNews.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a></code>(boost::bind(&NewsMessageArea::displayNews, newsMessageArea, _1)); </pre> <p>However, what if the user closes the news message area, @@ -618,21 +618,21 @@ destroying the <code class="computeroutput">newsMessageArea</code> object that <code class="computeroutput">deliverNews</code> knows about? Most likely, a segmentation fault will occur. However, with Boost.Signals2 one may track any object which is managed by a shared_ptr, by using -<code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp720124368-bb">slot::track</a></code>. A slot will automatically +<code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp746817216-bb">slot::track</a></code>. A slot will automatically disconnect when any of its tracked objects expire. In addition, Boost.Signals2 will ensure that no tracked object expires while the slot it is associated with is in mid-execution. It does so by creating temporary shared_ptr copies of the slot's tracked objects before executing it. To track <code class="computeroutput">NewsMessageArea</code>, we use a shared_ptr to manage its lifetime, and pass the shared_ptr to the slot via its -<code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp720124368-bb">slot::track</a></code> +<code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp746817216-bb">slot::track</a></code> method before connecting it, e.g.:</p> <pre class="programlisting"> // ... boost::shared_ptr<NewsMessageArea> newsMessageArea(new NewsMessageArea(/* ... */)); // ... -deliverNews.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719868960-bb">connect</a></code>(signal_type::slot_type(&NewsMessageArea::displayNews, +deliverNews.<code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746561808-bb">connect</a></code>(signal_type::slot_type(&NewsMessageArea::displayNews, newsMessageArea.get(), _1).track(newsMessageArea)); </pre> <p> @@ -647,14 +647,14 @@ deliverNews.<code class="computeroutput"><a class="link" href="../boost/signals2 <code class="computeroutput">newsMessageArea</code> itself, a copy of the <code class="computeroutput">shared_ptr</code> would have been bound into the slot function, preventing the <code class="computeroutput">shared_ptr</code> from expiring. However, the use of - <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp720124368-bb">slot::track</a></code> + <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp746817216-bb">slot::track</a></code> implies we wish to allow the tracked object to expire, and automatically disconnect the connection when this occurs. </p> <p> <code class="computeroutput">shared_ptr</code> classes other than <code class="computeroutput">boost::shared_ptr</code> (such as <code class="computeroutput">std::shared_ptr</code>) may also be tracked for connection management - purposes. They are supported by the <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp720138384-bb">slot::track_foreign</a></code> method. + purposes. They are supported by the <code class="computeroutput"><a class="link" href="../boost/signals2/slot.html#idp746831232-bb">slot::track_foreign</a></code> method. </p> </div> <div class="section"> @@ -696,7 +696,7 @@ deliverNews.<code class="computeroutput"><a class="link" href="../boost/signals2 </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521761184"></a>When Can Disconnections Occur? (Intermediate)</h4></div></div></div> +<a name="idp505493408"></a>When Can Disconnections Occur? (Intermediate)</h4></div></div></div> <p>Signal/slot disconnections occur when any of these conditions occur:</p> <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "> @@ -731,7 +731,7 @@ signal.</p> </div> <div class="section"> <div class="titlepage"><div><div><h4 class="title"> -<a name="idp521768784"></a>Passing Slots (Intermediate)</h4></div></div></div> +<a name="idp505501008"></a>Passing Slots (Intermediate)</h4></div></div></div> <p>Slots in the Boost.Signals2 library are created from arbitrary function objects, and therefore have no fixed type. However, it is commonplace to require that slots be passed through interfaces that @@ -920,7 +920,7 @@ private: access to a <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html" title="Class connection">signals2::connection</a></code> object which references the invoking signal-slot connection. The difficulty is, the <code class="computeroutput">connection</code> object is returned by the - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719868960-bb">signal::connect</a></code> + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746561808-bb">signal::connect</a></code> method, and therefore is not available until after the slot is already connected to the signal. This can be particularly troublesome in a multi-threaded environment where the signal may be invoked @@ -928,11 +928,11 @@ private: </p> <p> Therefore, the signal classes provide - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719885936-bb">signal::connect_extended</a></code> + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746578784-bb">signal::connect_extended</a></code> methods, which allow slots which take an extra argument to be connected to a signal. The extra argument is a <code class="computeroutput"><a class="link" href="../boost/signals2/connection.html" title="Class connection">signals2::connection</a></code> object which refers to the signal-slot connection currently invoking the slot. - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719885936-bb">signal::connect_extended</a></code> + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746578784-bb">signal::connect_extended</a></code> uses slots of the type given by the <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#boost.signals2.signal.extended_slot_type">signal::extended_slot_type</a></code> typedef. @@ -941,7 +941,7 @@ private: The examples section includes an <a class="link" href="examples.html#signals2.examples.tutorial.extended_slot" title="extended_slot">extended_slot</a> program which demonstrates the syntax for using - <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp719885936-bb">signal::connect_extended</a></code>. + <code class="computeroutput"><a class="link" href="../boost/signals2/signal.html#idp746578784-bb">signal::connect_extended</a></code>. </p> </div> <div class="section"> @@ -980,7 +980,7 @@ bs2::signal_type<void (int), mutex_type<bs2::dummy_mutex> >::type si </div> <div class="section"> <div class="titlepage"><div><div><h3 class="title"> -<a name="idp521830576"></a>Linking against the Signals2 library</h3></div></div></div> +<a name="idp505562992"></a>Linking against the Signals2 library</h3></div></div></div> <p>Unlike the original Boost.Signals library, Boost.Signals2 is currently header-only. </p> </div> |