• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4<title>basic_waitable_timer::expires_from_now (3 of 3 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="../expires_from_now.html" title="basic_waitable_timer::expires_from_now">
9<link rel="prev" href="overload2.html" title="basic_waitable_timer::expires_from_now (2 of 3 overloads)">
10<link rel="next" href="../expiry.html" title="basic_waitable_timer::expiry">
11</head>
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>
20</tr></table>
21<hr>
22<div class="spirit-nav">
23<a accesskey="p" href="overload2.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../expires_from_now.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="../expiry.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
24</div>
25<div class="section">
26<div class="titlepage"><div><div><h5 class="title">
27<a name="boost_asio.reference.basic_waitable_timer.expires_from_now.overload3"></a><a class="link" href="overload3.html" title="basic_waitable_timer::expires_from_now (3 of 3 overloads)">basic_waitable_timer::expires_from_now
28          (3 of 3 overloads)</a>
29</h5></div></div></div>
30<p>
31            (Deprecated: Use <code class="computeroutput">expires_after()</code>.) Set the timer's expiry
32            time relative to now.
33          </p>
34<pre class="programlisting">std::size_t expires_from_now(
35    const duration &amp; expiry_time,
36    boost::system::error_code &amp; ec);
37</pre>
38<p>
39            This function sets the expiry time. Any pending asynchronous wait operations
40            will be cancelled. The handler for each cancelled operation will be invoked
41            with the <code class="computeroutput">boost::asio::error::operation_aborted</code> error code.
42          </p>
43<h6>
44<a name="boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.h0"></a>
45            <span class="phrase"><a name="boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.parameters"></a></span><a class="link" href="overload3.html#boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.parameters">Parameters</a>
46          </h6>
47<div class="variablelist">
48<p class="title"><b></b></p>
49<dl class="variablelist">
50<dt><span class="term">expiry_time</span></dt>
51<dd><p>
52                  The expiry time to be used for the timer.
53                </p></dd>
54<dt><span class="term">ec</span></dt>
55<dd><p>
56                  Set to indicate what error occurred, if any.
57                </p></dd>
58</dl>
59</div>
60<h6>
61<a name="boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.h1"></a>
62            <span class="phrase"><a name="boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.return_value"></a></span><a class="link" href="overload3.html#boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.return_value">Return
63            Value</a>
64          </h6>
65<p>
66            The number of asynchronous operations that were cancelled.
67          </p>
68<h6>
69<a name="boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.h2"></a>
70            <span class="phrase"><a name="boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.remarks"></a></span><a class="link" href="overload3.html#boost_asio.reference.basic_waitable_timer.expires_from_now.overload3.remarks">Remarks</a>
71          </h6>
72<p>
73            If the timer has already expired when <code class="computeroutput">expires_from_now()</code>
74            is called, then the handlers for asynchronous wait operations will:
75          </p>
76<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
77<li class="listitem">
78                have already been invoked; or
79              </li>
80<li class="listitem">
81                have been queued for invocation in the near future.
82              </li>
83</ul></div>
84<p>
85            These handlers can no longer be cancelled, and therefore are passed an
86            error code that indicates the successful completion of the wait operation.
87          </p>
88</div>
89<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
90<td align="left"></td>
91<td align="right"><div class="copyright-footer">Copyright © 2003-2020 Christopher M.
92      Kohlhoff<p>
93        Distributed under the Boost Software License, Version 1.0. (See accompanying
94        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      </p>
96</div></td>
97</tr></table>
98<hr>
99<div class="spirit-nav">
100<a accesskey="p" href="overload2.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../expires_from_now.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="../expiry.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
101</div>
102</body>
103</html>
104