premiere
/
premiere-libtorrent
2
2
Fork 1
Code Issues Pull Requests Releases Wiki Activity

documented the alert dispatcher mechanism

This commit is contained in:
Arvid Norberg 2007-04-15 18:34:39 +00:00
parent b05abc76f4
commit 24d749e9c9
2 changed files with 85 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

43
docs/manual.html
View File

@ -2884,7 +2884,48 @@ struct fastresume_rejected_alert: torrent_alert
</div>
<div class="section">
<h2><a id="dispatcher" name="dispatcher">dispatcher</a></h2>
<p><em>TODO: describe the dispatcher mechanism</em></p>
<p>The <tt class="docutils literal"><span class="pre">handle_alert</span></tt> class is defined in <tt class="docutils literal"><span class="pre">&lt;libtorrent/alert.hpp&gt;</span></tt>.</p>
<p>Examples usage:</p>
<pre class="literal-block">
struct my_handler
{
void operator()(portmap_error_alert const&amp; a)
{
std::cout &lt;&lt; &quot;Portmapper: &quot; &lt;&lt; a.msg &lt;&lt; std::endl;
}
void operator()(tracker_warning_alert const&amp; a)
{
std::cout &lt;&lt; &quot;Tracker warning: &quot; &lt;&lt; a.msg &lt;&lt; std::endl;
}
void operator()(torrent_finished_alert const&amp; a)
{
// write fast resume data
// ...
std::cout &lt;&lt; a.handle.get_torrent_info().name() &lt;&lt; &quot;completed&quot;
&lt;&lt; std::endl;
}
};
</pre>
<pre class="literal-block">
std::auto_ptr&lt;alert&gt; a;
a = ses.pop_alert();
my_handler h;
while (a.get())
{
handle_alert&lt;portmap_error_alert
, tracker_warning_alert
, torrent_finished_alert
&gt;::handle_alert(h, a);
a = ses.pop_alert();
}
</pre>
<p>In this example 3 alert types are used. You can use any number of template
parameters to select between more types. If the number of types are more than
15, you can define <tt class="docutils literal"><span class="pre">TORRENT_MAX_ALERT_TYPES</span></tt> to a greater number before
including <tt class="docutils literal"><span class="pre">&lt;libtorrent/alert.hpp&gt;</span></tt>.</p>
</div>
</div>
<div class="section">

44
docs/manual.rst
View File

@ -2974,8 +2974,50 @@ resume file was rejected. It is generated at severity level ``warning``.
dispatcher
----------
*TODO: describe the dispatcher mechanism*
The ``handle_alert`` class is defined in ``<libtorrent/alert.hpp>``.
Examples usage::
struct my_handler
{
void operator()(portmap_error_alert const& a)
{
std::cout << "Portmapper: " << a.msg << std::endl;
}
void operator()(tracker_warning_alert const& a)
{
std::cout << "Tracker warning: " << a.msg << std::endl;
}
void operator()(torrent_finished_alert const& a)
{
// write fast resume data
// ...
std::cout << a.handle.get_torrent_info().name() << "completed"
<< std::endl;
}
};
::
std::auto_ptr<alert> a;
a = ses.pop_alert();
my_handler h;
while (a.get())
{
handle_alert<portmap_error_alert
, tracker_warning_alert
, torrent_finished_alert
>::handle_alert(h, a);
a = ses.pop_alert();
}
In this example 3 alert types are used. You can use any number of template
parameters to select between more types. If the number of types are more than
15, you can define ``TORRENT_MAX_ALERT_TYPES`` to a greater number before
including ``<libtorrent/alert.hpp>``.
exceptions