Service.html 4.5 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
  4. <title>Service requirements</title>
  5. <link rel="stylesheet" href="../../boostbook.css" type="text/css">
  6. <meta name="generator" content="DocBook XSL Stylesheets V1.75.2">
  7. <link rel="home" href="../../index.html" title="Asio">
  8. <link rel="up" href="../reference.html" title="Reference">
  9. <link rel="prev" href="SerialPortService.html" title="Serial port service requirements">
  10. <link rel="next" href="SettableSerialPortOption.html" title="Settable serial port option requirements">
  11. </head>
  12. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
  13. <table cellpadding="2" width="100%"><tr><td valign="top"><img alt="asio C++ library" width="250" height="60" src="../../asio.png"></td></tr></table>
  14. <hr>
  15. <div class="spirit-nav">
  16. <a accesskey="p" href="SerialPortService.html"><img src="../../prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../home.png" alt="Home"></a><a accesskey="n" href="SettableSerialPortOption.html"><img src="../../next.png" alt="Next"></a>
  17. </div>
  18. <div class="section">
  19. <div class="titlepage"><div><div><h3 class="title">
  20. <a name="asio.reference.Service"></a><a class="link" href="Service.html" title="Service requirements">Service requirements</a>
  21. </h3></div></div></div>
  22. <p>
  23. A class is a service if it is publicly derived from another service, or if
  24. it is a class derived from <code class="computeroutput"><span class="identifier">io_service</span><span class="special">::</span><span class="identifier">service</span></code>
  25. and contains a publicly-accessible declaration as follows:
  26. </p>
  27. <pre class="programlisting"><span class="keyword">static</span> <span class="identifier">io_service</span><span class="special">::</span><span class="identifier">id</span> <span class="identifier">id</span><span class="special">;</span>
  28. </pre>
  29. <p>
  30. All services define a one-argument constructor that takes a reference to
  31. the <code class="computeroutput"><span class="identifier">io_service</span></code> object that
  32. owns the service. This constructor is <span class="emphasis"><em>explicit</em></span>, preventing
  33. its participation in automatic conversions. For example:
  34. </p>
  35. <pre class="programlisting"><span class="keyword">class</span> <span class="identifier">my_service</span> <span class="special">:</span> <span class="keyword">public</span> <span class="identifier">io_service</span><span class="special">::</span><span class="identifier">service</span>
  36. <span class="special">{</span>
  37. <span class="keyword">public</span><span class="special">:</span>
  38. <span class="keyword">static</span> <span class="identifier">io_service</span><span class="special">::</span><span class="identifier">id</span> <span class="identifier">id</span><span class="special">;</span>
  39. <span class="keyword">explicit</span> <span class="identifier">my_service</span><span class="special">(</span><span class="identifier">io_service</span><span class="special">&amp;</span> <span class="identifier">ios</span><span class="special">);</span>
  40. <span class="keyword">private</span><span class="special">:</span>
  41. <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">shutdown_service</span><span class="special">();</span>
  42. <span class="special">...</span>
  43. <span class="special">};</span>
  44. </pre>
  45. <p>
  46. A service's <code class="computeroutput"><span class="identifier">shutdown_service</span></code>
  47. member function must cause all copies of user-defined handler objects that
  48. are held by the service to be destroyed.
  49. </p>
  50. </div>
  51. <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
  52. <td align="left"></td>
  53. <td align="right"><div class="copyright-footer">Copyright &#169; 2003-2014 Christopher M. Kohlhoff<p>
  54. Distributed under the Boost Software License, Version 1.0. (See accompanying
  55. 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>)
  56. </p>
  57. </div></td>
  58. </tr></table>
  59. <hr>
  60. <div class="spirit-nav">
  61. <a accesskey="p" href="SerialPortService.html"><img src="../../prev.png" alt="Prev"></a><a accesskey="u" href="../reference.html"><img src="../../up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../home.png" alt="Home"></a><a accesskey="n" href="SettableSerialPortOption.html"><img src="../../next.png" alt="Next"></a>
  62. </div>
  63. </body>
  64. </html>