/Src/Dependencies/Boost/libs/test/doc/html/utf/user-guide/test-organization/auto-nullary-test-case.html

http://hadesmem.googlecode.com/ · HTML · 89 lines · 84 code · 5 blank · 0 comment · 0 complexity · 5c06f4f02db558f9050d02e4f822d302 MD5 · raw file 

    

  1. <html>
    2. 

  2. <head>
    3. 

  3. <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
    4. 

  4. <title>Nullary function based test case with automated registration</title>
    5. 

  5. <link rel="stylesheet" href="../../../../style/style.css" type="text/css">
    6. 

  6. <meta name="generator" content="DocBook XSL Stylesheets V1.74.0">
    7. 

  7. <link rel="home" href="../../../index.html" title="Boost Test Library">
    8. 

  8. <link rel="up" href="nullary-test-case.html" title="Nullary function based test case">
    9. 

  9. <link rel="prev" href="manual-nullary-test-case.html" title="Manually registered nullary function based test case">
    10. 

  10. <link rel="next" href="unary-test-case.html" title="Unary function based test case">
    11. 

  11. <script language="JavaScript1.2" src="../../../../js/boost-test.js"></script>
    12. 

  12. </head>
    13. 

  13. <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
    14. 

  14. <table width="100%"><tr>
    15. 

  15. <td width="10%"><a href="../../../index.html"><img alt="Home" width="229" height="61" border="0" src="../../../../../../../libs/test/docbook/img/boost.test.logo.png"></a></td>
    16. 

  16. <td valign="middle" align="left"> &gt; <a href="../../../utf.html">The Unit Test Framework</a> &gt; <a href="../../user-guide.html">User's guide</a><a href="../../testing-tools.html">
    17. 

  17.       &gt;
    18. 

  18.       </a><a href="../test-organization.html">Test organization</a><a href="../fixture.html">
    19. 

  19.       &gt;
    20. 

  20.       </a><a href="nullary-test-case.html">Nullary function based test case</a><a href="unary-test-case.html">
    21. 

  21.       &gt;
    22. 

  22.       </a><b>Automated registration</b>
    23. 

  23. </td>
    24. 

  24. <td><div class="spirit-nav">
    25. 

  25. <a href="manual-nullary-test-case.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a href="unary-test-case.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
    26. 

  26. </div></td>
    27. 

  27. </tr></table>
    28. 

  28. <hr>
    29. 

  29. <div class="section" lang="en">
    30. 

  30. <div class="titlepage"><div><div><h6 class="title">
    31. 

  31. <a name="utf.user-guide.test-organization.auto-nullary-test-case"></a>Nullary function based test case with automated registration</h6></div></div></div>
    32. 

  32. <p class="first-line-indented">
    33. 

  33.     To create a nullary free function cased test case, which is registered in place of implementation, employ the
    34. 

  34.     macro BOOST_AUTO_TEST_CASE.
    35. 

  35.    </p>
    36. 

  36. <pre class="inline-synopsis">
    37. 

  37. <a name="BOOST_AUTO_TEST_CASE"></a>BOOST_AUTO_TEST_CASE(<span class="emphasis"><em>test_case_name</em></span>)</pre>
    38. 

  38. <p class="first-line-indented">
    39. 

  39.     The macro is designed to closely mimic nullary free function syntax. Changes that are required to make an
    40. 

  40.     existing test case, implemented as a free function, registered in place are illustrated in the following
    41. 

  41.     example (compare with <a class="xref" href="manual-nullary-test-case.html#utf.user-guide.test-organization.manual-nullary-test-case.example01" title="Example 5. Nullary free function manually registered">Example 5, &#8220;Nullary free function manually registered&#8221;</a>):
    42. 

  42.    </p>
    43. 

  43. <div class="example">
    44. 

  44. <a name="utf.user-guide.test-organization.auto-nullary-test-case.example06"></a><p class="title"><b>Example 10. Nullary function based test case with automated registration</b></p>
    45. 

  45. <div class="example-contents">
    46. 

  46. <pre class="programlisting">#define BOOST_TEST_MODULE example
    47. 

  47. #include &lt;boost/test/included/unit_test.hpp&gt;
    48. 

  48. 

  49. //____________________________________________________________________________//
    50. 

  50. 

  51. BOOST_AUTO_TEST_CASE( free_test_function )
    52. 

  52. {
    53. 

  53.     BOOST_CHECK( true /* test assertion */ );
    54. 

  54. }
    55. 

  55. 

  56. //____________________________________________________________________________//
    57. 

  57. 

  58. </pre>
    59. 

  59. <table class="simplelist" border="0" summary="Simple list"><tr>
    60. 

  60. <td><code class="literal"><a href="../../../../src/examples/example06.cpp" target="_top">Source code</a></code></td>
    61. 

  61. <td> | </td>
    62. 

  62. <td><code class="literal"><a href="#" target="_top" id="id649807" onclick="toggle_element( 'example06-output', 'id649807', 'Show output', 'Hide output' ); return false;">Show output</a></code></td>
    63. 

  63. </tr></table>
    64. 

  64. <pre class="example-output" id="example06-output">&gt; example --log_level=test_suite
    65. 

  65. Running 1 test case...
    66. 

  66. Entering test suite "example"
    67. 

  67. Entering test case "free_test_function"
    68. 

  68. Leaving test case "free_test_function"; testing time: 16ms
    69. 

  69. Leaving test suite "example"
    70. 

  70. 

  71. *** No errors detected
    72. 

  72. </pre>
    73. 

  73. </div>
    74. 

  74. </div>
    75. 

  75. <br class="example-break"><p class="first-line-indented">
    76. 

  76.     With this macro you don't need to implement the initialization function at all. The macro creates and
    77. 

  77.     registers the test case with the name free_test_function automatically.
    78. 

  78.    </p>
    79. 

  79. </div>
    80. 

  80. <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
    81. 

  81. <td align="left"></td>
    82. 

  82. <td align="right"><div class="copyright-footer">Copyright Š 2001-2007 Gennadiy Rozental</div></td>
    83. 

  83. </tr></table>
    84. 

  84. <hr>
    85. 

  85. <div class="spirit-nav">
    86. 

  86. <a accesskey="p" href="manual-nullary-test-case.html"><img src="../../../../../../../doc/html/images/prev.png" alt="Prev"></a><a accesskey="u" href="nullary-test-case.html"><img src="../../../../../../../doc/html/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/html/images/home.png" alt="Home"></a><a accesskey="n" href="unary-test-case.html"><img src="../../../../../../../doc/html/images/next.png" alt="Next"></a>
    87. 

  87. </div>
    88. 

  88. </body>
    89. 

  89. </html>
    90.