3 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
4 <title>basic_waitable_timer::cancel (1 of 2 overloads)</title>
5 <link rel="stylesheet" href="../../../../../../doc/src/boostbook.css" type="text/css">
6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7 <link rel="home" href="../../../../boost_asio.html" title="Boost.Asio">
8 <link rel="up" href="../cancel.html" title="basic_waitable_timer::cancel">
9 <link rel="prev" href="../cancel.html" title="basic_waitable_timer::cancel">
10 <link rel="next" href="overload2.html" title="basic_waitable_timer::cancel (2 of 2 overloads)">
12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
13 <table cellpadding="2" width="100%"><tr>
14 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
15 <td align="center"><a href="../../../../../../index.html">Home</a></td>
16 <td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td>
17 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
18 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
19 <td align="center"><a href="../../../../../../more/index.htm">More</a></td>
22 <div class="spirit-nav">
23 <a accesskey="p" href="../cancel.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../cancel.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../boost_asio.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="overload2.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
26 <div class="titlepage"><div><div><h5 class="title">
27 <a name="boost_asio.reference.basic_waitable_timer.cancel.overload1"></a><a class="link" href="overload1.html" title="basic_waitable_timer::cancel (1 of 2 overloads)">basic_waitable_timer::cancel
28 (1 of 2 overloads)</a>
29 </h5></div></div></div>
31 Cancel any asynchronous operations that are waiting on the timer.
33 <pre class="programlisting"><span class="identifier">std</span><span class="special">::</span><span class="identifier">size_t</span> <span class="identifier">cancel</span><span class="special">();</span>
36 This function forces the completion of any pending asynchronous wait
37 operations against the timer. The handler for each cancelled operation
38 will be invoked with the <code class="computeroutput"><span class="identifier">boost</span><span class="special">::</span><span class="identifier">asio</span><span class="special">::</span><span class="identifier">error</span><span class="special">::</span><span class="identifier">operation_aborted</span></code>
42 Cancelling the timer does not change the expiry time.
45 <a name="boost_asio.reference.basic_waitable_timer.cancel.overload1.h0"></a>
46 <span class="phrase"><a name="boost_asio.reference.basic_waitable_timer.cancel.overload1.return_value"></a></span><a class="link" href="overload1.html#boost_asio.reference.basic_waitable_timer.cancel.overload1.return_value">Return
50 The number of asynchronous operations that were cancelled.
53 <a name="boost_asio.reference.basic_waitable_timer.cancel.overload1.h1"></a>
54 <span class="phrase"><a name="boost_asio.reference.basic_waitable_timer.cancel.overload1.exceptions"></a></span><a class="link" href="overload1.html#boost_asio.reference.basic_waitable_timer.cancel.overload1.exceptions">Exceptions</a>
56 <div class="variablelist">
57 <p class="title"><b></b></p>
58 <dl class="variablelist">
59 <dt><span class="term">boost::system::system_error</span></dt>
66 <a name="boost_asio.reference.basic_waitable_timer.cancel.overload1.h2"></a>
67 <span class="phrase"><a name="boost_asio.reference.basic_waitable_timer.cancel.overload1.remarks"></a></span><a class="link" href="overload1.html#boost_asio.reference.basic_waitable_timer.cancel.overload1.remarks">Remarks</a>
70 If the timer has already expired when <code class="computeroutput"><span class="identifier">cancel</span><span class="special">()</span></code> is called, then the handlers for asynchronous
73 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
75 have already been invoked; or
78 have been queued for invocation in the near future.
82 These handlers can no longer be cancelled, and therefore are passed an
83 error code that indicates the successful completion of the wait operation.
86 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
87 <td align="left"></td>
88 <td align="right"><div class="copyright-footer">Copyright © 2003-2017 Christopher M. Kohlhoff<p>
89 Distributed under the Boost Software License, Version 1.0. (See accompanying
90 file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
95 <div class="spirit-nav">
96 <a accesskey="p" href="../cancel.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../cancel.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../../boost_asio.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="overload2.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>