assertion_boost_level_eq_collections.html 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105
  1. <html>
  2. <head>
  3. <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
  4. <title>BOOST_&lt;level&gt;_EQUAL_COLLECTIONS</title>
  5. <link rel="stylesheet" href="../../../boostbook.css" type="text/css">
  6. <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
  7. <link rel="home" href="../../../index.html" title="Boost.Test">
  8. <link rel="up" href="../testing_tool_ref.html" title="Reference API for writing tests">
  9. <link rel="prev" href="assertion_boost_level_eq.html" title="BOOST_&lt;level&gt;_EQUAL">
  10. <link rel="next" href="assertion_boost_level_close.html" title="BOOST_&lt;level&gt;_CLOSE">
  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="assertion_boost_level_eq.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../testing_tool_ref.html"><img src="../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="assertion_boost_level_close.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
  24. </div>
  25. <div class="section">
  26. <div class="titlepage"><div><div><h4 class="title">
  27. <a name="boost_test.utf_reference.testing_tool_ref.assertion_boost_level_eq_collections"></a><a class="link" href="assertion_boost_level_eq_collections.html" title="BOOST_&lt;level&gt;_EQUAL_COLLECTIONS"><code class="computeroutput"><span class="identifier">BOOST_</span><span class="special">&lt;</span><span class="identifier">level</span><span class="special">&gt;</span><span class="identifier">_EQUAL_COLLECTIONS</span></code></a>
  28. </h4></div></div></div>
  29. <pre class="programlisting"><span class="identifier">BOOST_WARN_EQUAL_COLLECTIONS</span><span class="special">(</span><span class="identifier">left_begin</span><span class="special">,</span> <span class="identifier">left_end</span><span class="special">,</span> <span class="identifier">right_begin</span><span class="special">,</span> <span class="identifier">right_end</span><span class="special">);</span>
  30. <span class="identifier">BOOST_CHECK_EQUAL_COLLECTIONS</span><span class="special">(</span><span class="identifier">left_begin</span><span class="special">,</span> <span class="identifier">left_end</span><span class="special">,</span> <span class="identifier">right_begin</span><span class="special">,</span> <span class="identifier">right_end</span><span class="special">);</span>
  31. <span class="identifier">BOOST_REQUIRE_EQUAL_COLLECTIONS</span><span class="special">(</span><span class="identifier">left_begin</span><span class="special">,</span> <span class="identifier">left_end</span><span class="special">,</span> <span class="identifier">right_begin</span><span class="special">,</span> <span class="identifier">right_end</span><span class="special">);</span>
  32. </pre>
  33. <p>
  34. These tools are used to perform an element by element comparison of two
  35. collections. They print all mismatched positions, collection elements at
  36. these positions and check that the collections have the same size. The
  37. first two parameters designate begin and end of the first collection. The
  38. two last parameters designate begin and end of the second collection.
  39. </p>
  40. <h6>
  41. <a name="boost_test.utf_reference.testing_tool_ref.assertion_boost_level_eq_collections.h0"></a>
  42. <span class="phrase"><a name="boost_test.utf_reference.testing_tool_ref.assertion_boost_level_eq_collections.example_descr"></a></span><a class="link" href="assertion_boost_level_eq_collections.html#boost_test.utf_reference.testing_tool_ref.assertion_boost_level_eq_collections.example_descr">Example:
  43. BOOST_&lt;level&gt;_EQUAL_COLLECTIONS usage</a>
  44. </h6>
  45. <div class="informaltable"><table class="table">
  46. <colgroup><col></colgroup>
  47. <thead><tr><th>
  48. <p>
  49. Code
  50. </p>
  51. </th></tr></thead>
  52. <tbody><tr><td>
  53. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#define</span> <span class="identifier">BOOST_TEST_MODULE</span> <span class="identifier">example</span>
  54. <span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">test</span><span class="special">/</span><span class="identifier">included</span><span class="special">/</span><span class="identifier">unit_test</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
  55. <span class="identifier">BOOST_AUTO_TEST_CASE</span><span class="special">(</span> <span class="identifier">test</span> <span class="special">)</span>
  56. <span class="special">{</span>
  57. <span class="keyword">int</span> <span class="identifier">col1</span> <span class="special">[]</span> <span class="special">=</span> <span class="special">{</span> <span class="number">1</span><span class="special">,</span> <span class="number">2</span><span class="special">,</span> <span class="number">3</span><span class="special">,</span> <span class="number">4</span><span class="special">,</span> <span class="number">5</span><span class="special">,</span> <span class="number">6</span><span class="special">,</span> <span class="number">7</span> <span class="special">};</span>
  58. <span class="keyword">int</span> <span class="identifier">col2</span> <span class="special">[]</span> <span class="special">=</span> <span class="special">{</span> <span class="number">1</span><span class="special">,</span> <span class="number">2</span><span class="special">,</span> <span class="number">4</span><span class="special">,</span> <span class="number">4</span><span class="special">,</span> <span class="number">5</span><span class="special">,</span> <span class="number">7</span><span class="special">,</span> <span class="number">7</span> <span class="special">};</span>
  59. <span class="identifier">BOOST_CHECK_EQUAL_COLLECTIONS</span><span class="special">(</span> <span class="identifier">col1</span><span class="special">,</span> <span class="identifier">col1</span><span class="special">+</span><span class="number">7</span><span class="special">,</span> <span class="identifier">col2</span><span class="special">,</span> <span class="identifier">col2</span><span class="special">+</span><span class="number">7</span> <span class="special">);</span>
  60. <span class="special">}</span>
  61. </pre>
  62. </td></tr></tbody>
  63. </table></div>
  64. <div class="informaltable"><table class="table">
  65. <colgroup><col></colgroup>
  66. <thead><tr><th>
  67. <p>
  68. Output
  69. </p>
  70. </th></tr></thead>
  71. <tbody><tr><td>
  72. <pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="special">&gt;</span> <span class="identifier">example</span>
  73. <span class="identifier">Running</span> <span class="number">1</span> <span class="identifier">test</span> <span class="keyword">case</span><span class="special">...</span>
  74. <span class="identifier">test</span><span class="special">.</span><span class="identifier">cpp</span><span class="special">(</span><span class="number">11</span><span class="special">):</span> <span class="identifier">error</span> <span class="identifier">in</span> <span class="string">"test"</span><span class="special">:</span> <span class="identifier">check</span> <span class="special">{</span> <span class="identifier">col1</span><span class="special">,</span> <span class="identifier">col1</span><span class="special">+</span><span class="number">7</span> <span class="special">}</span> <span class="special">==</span> <span class="special">{</span> <span class="identifier">col2</span><span class="special">,</span> <span class="identifier">col2</span><span class="special">+</span><span class="number">7</span> <span class="special">}</span> <span class="identifier">has</span> <span class="identifier">failed</span><span class="special">.</span>
  75. <span class="identifier">Mismatch</span> <span class="identifier">in</span> <span class="identifier">a</span> <span class="identifier">position</span> <span class="number">2</span><span class="special">:</span> <span class="number">3</span> <span class="special">!=</span> <span class="number">4</span>
  76. <span class="identifier">Mismatch</span> <span class="identifier">in</span> <span class="identifier">a</span> <span class="identifier">position</span> <span class="number">5</span><span class="special">:</span> <span class="number">6</span> <span class="special">!=</span> <span class="number">7</span>
  77. <span class="special">***</span> <span class="number">1</span> <span class="identifier">failures</span> <span class="identifier">is</span> <span class="identifier">detected</span> <span class="identifier">in</span> <span class="identifier">test</span> <span class="identifier">suite</span> <span class="string">"example"</span>
  78. </pre>
  79. </td></tr></tbody>
  80. </table></div>
  81. <p>
  82. See also:
  83. </p>
  84. <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; "><li class="listitem">
  85. <a class="link" href="assertion_boost_level_eq.html" title="BOOST_&lt;level&gt;_EQUAL"><code class="computeroutput"><span class="identifier">BOOST_</span><span class="special">&lt;</span><span class="identifier">level</span><span class="special">&gt;</span><span class="identifier">_EQUAL</span></code></a>
  86. </li></ul></div>
  87. </div>
  88. <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
  89. <td align="left"></td>
  90. <td align="right"><div class="copyright-footer">Copyright &#169; 2001-2019 Boost.Test
  91. contributors<p>
  92. Distributed under the Boost Software License, Version 1.0. (See accompanying
  93. 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>)
  94. </p>
  95. </div></td>
  96. </tr></table>
  97. <hr>
  98. <div class="spirit-nav">
  99. <a accesskey="p" href="assertion_boost_level_eq.html"><img src="../../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../testing_tool_ref.html"><img src="../../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../../index.html"><img src="../../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="assertion_boost_level_close.html"><img src="../../../../../../../doc/src/images/next.png" alt="Next"></a>
  100. </div>
  101. </body>
  102. </html>