• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1<html>
2<head>
3<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
4<title>Examples</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="../index.html" title="Chapter 1. Boost.Contract 1.0.0">
8<link rel="up" href="../index.html" title="Chapter 1. Boost.Contract 1.0.0">
9<link rel="prev" href="extras.html" title="Extras">
10<link rel="next" href="../reference.html" title="Reference">
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="extras.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.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="../reference.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
24</div>
25<div class="section">
26<div class="titlepage"><div><div><h2 class="title" style="clear: both">
27<a name="boost_contract.examples"></a><a class="link" href="examples.html" title="Examples">Examples</a>
28</h2></div></div></div>
29<div class="toc"><dl class="toc">
30<dt><span class="section"><a href="examples.html#boost_contract.examples.__n1962___vector__contracts_for_stl_vector_and_comparison_with___n1962___proposed_syntax">[N1962] Vector: Contracts for STL
31      vector and comparison with [N1962] proposed
32      syntax</a></span></dt>
33<dt><span class="section"><a href="examples.html#boost_contract.examples.__n1962___circle__subcontracting">[N1962]
34      Circle: Subcontracting</a></span></dt>
35<dt><span class="section"><a href="examples.html#boost_contract.examples.__n1962___factorial__recursion">[N1962]
36      Factorial: Recursion</a></span></dt>
37<dt><span class="section"><a href="examples.html#boost_contract.examples.__n1962___equal__operators">[N1962]
38      Equal: Operators</a></span></dt>
39<dt><span class="section"><a href="examples.html#boost_contract.examples.__n1962___sum__array_parameter">[N1962]
40      Sum: Array parameter</a></span></dt>
41<dt><span class="section"><a href="examples.html#boost_contract.examples.__n1962___square_root__default_parameters_and_comparison_with_d_syntax">[N1962]
42      Square Root: Default parameters and comparison with D syntax</a></span></dt>
43<dt><span class="section"><a href="examples.html#boost_contract.examples.__meyer97___stack4__comparison_with_eiffel_syntax">[Meyer97]
44      Stack4: Comparison with Eiffel syntax</a></span></dt>
45<dt><span class="section"><a href="examples.html#boost_contract.examples.__meyer97___stack3__error_codes_instead_of_preconditions">[Meyer97]
46      Stack3: Error codes instead of preconditions</a></span></dt>
47<dt><span class="section"><a href="examples.html#boost_contract.examples.__mitchell02___name_list__relaxed_subcontracts">[Mitchell02]
48      Name List: Relaxed subcontracts</a></span></dt>
49<dt><span class="section"><a href="examples.html#boost_contract.examples.__mitchell02___dictionary__key_value_map">[Mitchell02]
50      Dictionary: Key-value map</a></span></dt>
51<dt><span class="section"><a href="examples.html#boost_contract.examples.__mitchell02___courier__subcontracting_and_static_class_invariants">[Mitchell02]
52      Courier: Subcontracting and static class invariants</a></span></dt>
53<dt><span class="section"><a href="examples.html#boost_contract.examples.__mitchell02___stack__stack_like_container">[Mitchell02]
54      Stack: Stack-like container</a></span></dt>
55<dt><span class="section"><a href="examples.html#boost_contract.examples.__mitchell02___simple_queue__queue_like_container_and_disable_old_value_copies_for_audit_assertions">[Mitchell02]
56      Simple Queue: Queue-like container and disable old value copies for audit assertions</a></span></dt>
57<dt><span class="section"><a href="examples.html#boost_contract.examples.__mitchell02___customer_manager__contracts_instead_of_defensive_programming">[Mitchell02]
58      Customer Manager: Contracts instead of defensive programming</a></span></dt>
59<dt><span class="section"><a href="examples.html#boost_contract.examples.__mitchell02___observer__pure_virtual_functions">[Mitchell02]
60      Observer: Pure virtual functions</a></span></dt>
61<dt><span class="section"><a href="examples.html#boost_contract.examples.__mitchell02___counter__subcontracting">[Mitchell02]
62      Counter: Subcontracting</a></span></dt>
63<dt><span class="section"><a href="examples.html#boost_contract.examples.__cline90___vector__comparison_with_a___proposal_syntax">[Cline90]
64      Vector: Comparison with A++ proposal syntax</a></span></dt>
65<dt><span class="section"><a href="examples.html#boost_contract.examples.__cline90___stack__stack_like_container">[Cline90]
66      Stack: Stack-like container</a></span></dt>
67<dt><span class="section"><a href="examples.html#boost_contract.examples.__cline90___vector_stack__subcontracting">[Cline90]
68      Vector-Stack: Subcontracting</a></span></dt>
69<dt><span class="section"><a href="examples.html#boost_contract.examples.__cline90___calendar__a_very_simple_calendar">[Cline90]
70      Calendar: A very simple calendar</a></span></dt>
71</dl></div>
72<p>
73      This section lists some examples taken from different sources discussing contract
74      programming and implemented here using this library.
75    </p>
76<div class="note"><table border="0" summary="Note">
77<tr>
78<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
79<th align="left">Note</th>
80</tr>
81<tr><td align="left" valign="top"><p>
82        Some of these examples might be from old code, containing obsolete coding
83        practices, not optimized for execution speed, not complete, and they might
84        be more relevant in the context of programming languages different from C++.
85        Nevertheless, programmers are encouraged to review these examples to see
86        a few diverse uses of this library that might be relevant to their needs.
87      </p></td></tr>
88</table></div>
89<p>
90      The examples in this sections are taken from the following sources:
91    </p>
92<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
93<li class="listitem">
94          <a class="link" href="bibliography.html#N1962_anchor">[N1962]</a>: Examples from a detailed and
95          complete proposal to add contract programming to C++11 (unfortunately,
96          this proposal was never accepted into the standard).
97        </li>
98<li class="listitem">
99          <a class="link" href="bibliography.html#Meyer97_anchor">[Meyer97]</a>: Examples from the Eiffel
100          programming language (reprogrammed here in C++ using this library).
101        </li>
102<li class="listitem">
103          <a class="link" href="bibliography.html#Mitchell02_anchor">[Mitchell02]</a>: Additional examples
104          from the Eiffel programming language (reprogrammed here in C++ using this
105          library).
106        </li>
107<li class="listitem">
108          <a class="link" href="bibliography.html#Cline90_anchor">[Cline90]</a>: Examples from a very early
109          proposal called Annotated C++ (A++) to add contract programming to C++
110          (A++ was never implemented or proposed for addition to the standard).
111        </li>
112</ul></div>
113<p>
114      The following are some examples of particular interest:
115    </p>
116<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
117<li class="listitem">
118          <a class="link" href="examples.html#N1962_vector_anchor">[N1962] Vector</a>: Complete set
119          of contracts for <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span></code>, plus a comparison with <a class="link" href="bibliography.html#N1962_anchor">[N1962]</a> syntax.
120        </li>
121<li class="listitem">
122          <a class="link" href="examples.html#N1962_square_root_anchor">[N1962] Square Root</a>: Comparison
123          with D syntax.
124        </li>
125<li class="listitem">
126          <a class="link" href="examples.html#Mitchell02_counter_anchor">[Mitchell02] Counter</a>:
127          Subcontracting.
128        </li>
129<li class="listitem">
130          <a class="link" href="examples.html#Meyer97_stack4_anchor">[Meyer97] Stack4</a>: Comparison
131          with Eiffel syntax.
132        </li>
133<li class="listitem">
134          <a class="link" href="examples.html#Cline90_vector_anchor">[Cline90] Vector</a>: Comparison
135          with A++ syntax.
136        </li>
137</ul></div>
138<p>
139      Most of the examples listed here use old values and class invariants which
140      are instead not supported by <a class="link" href="bibliography.html#P0380_anchor">[P0380]</a>. Therefore,
141      there is not meaningful example here that can be directly implemented and compared
142      using <a class="link" href="bibliography.html#P0380_anchor">[P0380]</a> syntax.
143    </p>
144<div class="section">
145<div class="titlepage"><div><div><h3 class="title">
146<a name="boost_contract.examples.__n1962___vector__contracts_for_stl_vector_and_comparison_with___n1962___proposed_syntax"></a><a name="N1962_vector_anchor"></a>[N1962] Vector: Contracts for STL
147      vector and comparison with <a class="link" href="bibliography.html#N1962_anchor">[N1962]</a> proposed
148      syntax</h3></div></div></div>
149<p>
150        On compilers that support C++17 <code class="computeroutput"><span class="keyword">if</span>
151        <span class="keyword">constexpr</span></code>, the following example using
152        this library can be simplified removing <code class="computeroutput"><a class="link" href="../boost/contract/condition_if.html" title="Function template condition_if">boost::contract::condition_if</a></code>
153        and related functor templates such as <code class="computeroutput"><span class="identifier">all_of_equal_to</span></code>,
154        etc., making it more similar to the pseudo-code on the right-hand side (see
155        <a class="link" href="extras.html#boost_contract.extras.assertion_requirements__templates_" title="Assertion Requirements (Templates)">Assertion
156        Requirements</a>).
157      </p>
158<div class="informaltable"><table class="table">
159<colgroup>
160<col>
161<col>
162</colgroup>
163<thead><tr>
164<th>
165                <p>
166                  This library
167                </p>
168              </th>
169<th>
170                <p>
171                  [N1962] proposal (not accepted in C++) plus C++17 <code class="literal">if constexpr</code>
172                </p>
173              </th>
174</tr></thead>
175<tbody><tr>
176<td>
177                <p>
178</p>
179<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
180<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">bind</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
181<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">optional</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
182<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">algorithm</span><span class="special">/</span><span class="identifier">cxx11</span><span class="special">/</span><span class="identifier">all_of</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
183<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">type_traits</span><span class="special">/</span><span class="identifier">has_equal_to</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
184<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">next_prior</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
185<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&gt;</span>
186<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">functional</span><span class="special">&gt;</span>
187<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">iterator</span><span class="special">&gt;</span>
188<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">memory</span><span class="special">&gt;</span>
189<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
190
191<span class="comment">// Could be programmed at call site with C++14 generic lambdas.</span>
192<span class="keyword">struct</span> <span class="identifier">all_of_equal_to</span> <span class="special">{</span>
193    <span class="keyword">typedef</span> <span class="keyword">bool</span> <span class="identifier">result_type</span><span class="special">;</span>
194
195    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
196    <span class="identifier">result_type</span> <span class="keyword">operator</span><span class="special">()(</span><span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
197        <span class="keyword">return</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
198    <span class="special">}</span>
199
200    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
201    <span class="identifier">result_type</span> <span class="keyword">operator</span><span class="special">()(</span><span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">where</span><span class="special">)</span> <span class="special">{</span>
202        <span class="keyword">for</span><span class="special">(</span><span class="identifier">InputIter</span> <span class="identifier">i</span> <span class="special">=</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">j</span> <span class="special">=</span> <span class="identifier">where</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">!=</span> <span class="identifier">last</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">,</span> <span class="special">++</span><span class="identifier">j</span><span class="special">)</span> <span class="special">{</span>
203            <span class="keyword">if</span><span class="special">(*</span><span class="identifier">i</span> <span class="special">!=</span> <span class="special">*</span><span class="identifier">j</span><span class="special">)</span> <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
204        <span class="special">}</span>
205        <span class="keyword">return</span> <span class="keyword">true</span><span class="special">;</span>
206    <span class="special">}</span>
207<span class="special">};</span>
208
209<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">Iter</span><span class="special">&gt;</span>
210<span class="keyword">bool</span> <span class="identifier">valid</span><span class="special">(</span><span class="identifier">Iter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">Iter</span> <span class="identifier">last</span><span class="special">);</span> <span class="comment">// Cannot implement in C++ (for axiom only).</span>
211
212<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">Iter</span><span class="special">&gt;</span>
213<span class="keyword">bool</span> <span class="identifier">contained</span><span class="special">(</span><span class="identifier">Iter</span> <span class="identifier">first1</span><span class="special">,</span> <span class="identifier">Iter</span> <span class="identifier">last1</span><span class="special">,</span> <span class="identifier">Iter</span> <span class="identifier">first2</span><span class="special">,</span> <span class="identifier">Iter</span> <span class="identifier">last2</span><span class="special">);</span> <span class="comment">// For axiom.</span>
214
215<span class="comment">// STL vector requires T copyable but not equality comparable.</span>
216<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">Allocator</span> <span class="special">=</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">allocator</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span>
217<span class="keyword">class</span> <span class="identifier">vector</span> <span class="special">{</span>
218    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
219
220    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
221        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">()</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span>
222        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">())</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">()));</span>
223        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">rbegin</span><span class="special">(),</span> <span class="identifier">rend</span><span class="special">())</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">()));</span>
224        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">&lt;=</span> <span class="identifier">capacity</span><span class="special">());</span>
225        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">&lt;=</span> <span class="identifier">max_size</span><span class="special">());</span>
226    <span class="special">}</span>
227
228<span class="keyword">public</span><span class="special">:</span>
229    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">allocator_type</span> <span class="identifier">allocator_type</span><span class="special">;</span>
230    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">pointer</span> <span class="identifier">pointer</span><span class="special">;</span>
231    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">const_pointer</span> <span class="identifier">const_pointer</span><span class="special">;</span>
232    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">reference</span> <span class="identifier">reference</span><span class="special">;</span>
233    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">const_reference</span> <span class="identifier">const_reference</span><span class="special">;</span>
234    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">value_type</span> <span class="identifier">value_type</span><span class="special">;</span>
235    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">iterator</span> <span class="identifier">iterator</span><span class="special">;</span>
236    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">const_iterator</span><span class="special">;</span>
237    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">size_type</span> <span class="identifier">size_type</span><span class="special">;</span>
238    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">difference_type</span> <span class="identifier">difference_type</span><span class="special">;</span>
239    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">reverse_iterator</span>
240            <span class="identifier">reverse_iterator</span><span class="special">;</span>
241    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">const_reverse_iterator</span>
242            <span class="identifier">const_reverse_iterator</span><span class="special">;</span>
243
244    <span class="identifier">vector</span><span class="special">()</span> <span class="special">:</span> <span class="identifier">vect_</span><span class="special">()</span> <span class="special">{</span>
245        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
246            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
247                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">());</span>
248            <span class="special">})</span>
249        <span class="special">;</span>
250    <span class="special">}</span>
251
252    <span class="keyword">explicit</span> <span class="identifier">vector</span><span class="special">(</span><span class="identifier">Allocator</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">alloc</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">alloc</span><span class="special">)</span> <span class="special">{</span>
253        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
254            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
255                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">());</span>
256                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">get_allocator</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">alloc</span><span class="special">);</span>
257            <span class="special">})</span>
258        <span class="special">;</span>
259    <span class="special">}</span>
260
261    <span class="keyword">explicit</span> <span class="identifier">vector</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">count</span><span class="special">)</span> <span class="special">{</span>
262        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
263            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
264                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">);</span>
265                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
266                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
267                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">all_of_equal_to</span><span class="special">(),</span> <span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span> <span class="identifier">T</span><span class="special">())</span>
268                    <span class="special">)</span>
269                <span class="special">);</span>
270            <span class="special">})</span>
271        <span class="special">;</span>
272    <span class="special">}</span>
273
274    <span class="identifier">vector</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
275        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
276            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
277                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">);</span>
278                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
279                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
280                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">all_of_equal_to</span><span class="special">(),</span> <span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span>
281                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">value</span><span class="special">))</span>
282                    <span class="special">)</span>
283                <span class="special">);</span>
284            <span class="special">})</span>
285        <span class="special">;</span>
286    <span class="special">}</span>
287
288    <span class="identifier">vector</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">,</span> <span class="identifier">Allocator</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">alloc</span><span class="special">)</span> <span class="special">:</span>
289            <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">,</span> <span class="identifier">alloc</span><span class="special">)</span> <span class="special">{</span>
290        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
291            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
292                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">);</span>
293                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
294                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
295                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">all_of_equal_to</span><span class="special">(),</span> <span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span>
296                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">value</span><span class="special">))</span>
297                    <span class="special">)</span>
298                <span class="special">);</span>
299                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">get_allocator</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">alloc</span><span class="special">);</span>
300            <span class="special">})</span>
301        <span class="special">;</span>
302    <span class="special">}</span>
303
304    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
305    <span class="identifier">vector</span><span class="special">(</span><span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">{</span>
306        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
307            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
308                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">==</span>
309                        <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">()));</span>
310            <span class="special">})</span>
311        <span class="special">;</span>
312    <span class="special">}</span>
313
314    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
315    <span class="identifier">vector</span><span class="special">(</span><span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">Allocator</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">alloc</span><span class="special">)</span> <span class="special">:</span>
316            <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">alloc</span><span class="special">)</span> <span class="special">{</span>
317        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
318            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
319                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">==</span>
320                        <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">()));</span>
321                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">get_allocator</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">alloc</span><span class="special">);</span>
322            <span class="special">})</span>
323        <span class="special">;</span>
324    <span class="special">}</span>
325
326    <span class="comment">/* implicit */</span> <span class="identifier">vector</span><span class="special">(</span><span class="identifier">vector</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">other</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">other</span><span class="special">.</span><span class="identifier">vect_</span><span class="special">)</span> <span class="special">{</span>
327        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
328            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
329                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
330                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
331                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">equal_to</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(),</span>
332                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(*</span><span class="keyword">this</span><span class="special">),</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">other</span><span class="special">))</span>
333                    <span class="special">)</span>
334                <span class="special">);</span>
335            <span class="special">})</span>
336        <span class="special">;</span>
337    <span class="special">}</span>
338
339    <span class="identifier">vector</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=(</span><span class="identifier">vector</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">other</span><span class="special">)</span> <span class="special">{</span>
340        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&amp;&gt;</span> <span class="identifier">result</span><span class="special">;</span>
341        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
342            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
343                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
344                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
345                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">equal_to</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(),</span>
346                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(*</span><span class="keyword">this</span><span class="special">),</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">other</span><span class="special">))</span>
347                    <span class="special">)</span>
348                <span class="special">);</span>
349                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
350                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
351                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">equal_to</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(),</span>
352                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(*</span><span class="identifier">result</span><span class="special">),</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(*</span><span class="keyword">this</span><span class="special">))</span>
353                    <span class="special">)</span>
354                <span class="special">);</span>
355            <span class="special">})</span>
356        <span class="special">;</span>
357
358        <span class="keyword">if</span><span class="special">(</span><span class="keyword">this</span> <span class="special">!=</span> <span class="special">&amp;</span><span class="identifier">other</span><span class="special">)</span> <span class="identifier">vect_</span> <span class="special">=</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">vect_</span><span class="special">;</span>
359        <span class="keyword">return</span> <span class="special">*(</span><span class="identifier">result</span> <span class="special">=</span> <span class="special">*</span><span class="keyword">this</span><span class="special">);</span>
360    <span class="special">}</span>
361
362    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">vector</span><span class="special">()</span> <span class="special">{</span>
363        <span class="comment">// Check invariants.</span>
364        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
365    <span class="special">}</span>
366
367    <span class="keyword">void</span> <span class="identifier">reserve</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">)</span> <span class="special">{</span>
368        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
369            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
370                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">());</span>
371            <span class="special">})</span>
372            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
373                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">count</span><span class="special">);</span>
374            <span class="special">})</span>
375        <span class="special">;</span>
376
377        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">reserve</span><span class="special">(</span><span class="identifier">count</span><span class="special">);</span>
378    <span class="special">}</span>
379
380    <span class="identifier">size_type</span> <span class="identifier">capacity</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
381        <span class="identifier">size_type</span> <span class="identifier">result</span><span class="special">;</span>
382        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
383            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
384                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&gt;=</span> <span class="identifier">size</span><span class="special">());</span>
385            <span class="special">})</span>
386        <span class="special">;</span>
387
388        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">();</span>
389    <span class="special">}</span>
390
391    <span class="identifier">iterator</span> <span class="identifier">begin</span><span class="special">()</span> <span class="special">{</span>
392        <span class="identifier">iterator</span> <span class="identifier">result</span><span class="special">;</span>
393        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
394            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
395                <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">end</span><span class="special">());</span>
396            <span class="special">})</span>
397        <span class="special">;</span>
398
399        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
400    <span class="special">}</span>
401
402    <span class="identifier">const_iterator</span> <span class="identifier">begin</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
403        <span class="identifier">const_iterator</span> <span class="identifier">result</span><span class="special">;</span>
404        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
405            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
406                <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">end</span><span class="special">());</span>
407            <span class="special">})</span>
408        <span class="special">;</span>
409
410        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
411    <span class="special">}</span>
412
413    <span class="identifier">iterator</span> <span class="identifier">end</span><span class="special">()</span> <span class="special">{</span>
414        <span class="comment">// Check invariants.</span>
415        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
416        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">end</span><span class="special">();</span>
417    <span class="special">}</span>
418
419    <span class="identifier">const_iterator</span> <span class="identifier">end</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
420        <span class="comment">// Check invariants.</span>
421        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
422        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">end</span><span class="special">();</span>
423    <span class="special">}</span>
424
425    <span class="identifier">reverse_iterator</span> <span class="identifier">rbegin</span><span class="special">()</span> <span class="special">{</span>
426        <span class="identifier">iterator</span> <span class="identifier">result</span><span class="special">;</span>
427        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
428            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
429                <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">rend</span><span class="special">());</span>
430            <span class="special">})</span>
431        <span class="special">;</span>
432
433        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">rbegin</span><span class="special">();</span>
434    <span class="special">}</span>
435
436    <span class="identifier">const_reverse_iterator</span> <span class="identifier">rbegin</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
437        <span class="identifier">const_reverse_iterator</span> <span class="identifier">result</span><span class="special">;</span>
438        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
439            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
440                <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">rend</span><span class="special">());</span>
441            <span class="special">})</span>
442        <span class="special">;</span>
443
444        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">rbegin</span><span class="special">();</span>
445    <span class="special">}</span>
446
447    <span class="identifier">reverse_iterator</span> <span class="identifier">rend</span><span class="special">()</span> <span class="special">{</span>
448        <span class="comment">// Check invariants.</span>
449        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
450        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">rend</span><span class="special">();</span>
451    <span class="special">}</span>
452
453    <span class="identifier">const_reverse_iterator</span> <span class="identifier">rend</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
454        <span class="comment">// Check invariants.</span>
455        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
456        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">rend</span><span class="special">();</span>
457    <span class="special">}</span>
458
459    <span class="keyword">void</span> <span class="identifier">resize</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span> <span class="special">=</span> <span class="identifier">T</span><span class="special">())</span> <span class="special">{</span>
460        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_size</span> <span class="special">=</span>
461                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
462        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
463            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
464                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">);</span>
465                <span class="keyword">if</span><span class="special">(</span><span class="identifier">count</span> <span class="special">&gt;</span> <span class="special">*</span><span class="identifier">old_size</span><span class="special">)</span> <span class="special">{</span>
466                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
467                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
468                            <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">all_of_equal_to</span><span class="special">(),</span> <span class="identifier">begin</span><span class="special">()</span> <span class="special">+</span> <span class="special">*</span><span class="identifier">old_size</span><span class="special">,</span>
469                                    <span class="identifier">end</span><span class="special">(),</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">value</span><span class="special">))</span>
470                        <span class="special">)</span>
471                    <span class="special">);</span>
472                <span class="special">}</span>
473            <span class="special">})</span>
474        <span class="special">;</span>
475
476        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">resize</span><span class="special">(</span><span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
477    <span class="special">}</span>
478
479    <span class="identifier">size_type</span> <span class="identifier">size</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
480        <span class="identifier">size_type</span> <span class="identifier">result</span><span class="special">;</span>
481        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
482            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
483                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&lt;=</span> <span class="identifier">capacity</span><span class="special">());</span>
484            <span class="special">})</span>
485        <span class="special">;</span>
486
487        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span>
488    <span class="special">}</span>
489
490    <span class="identifier">size_type</span> <span class="identifier">max_size</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
491        <span class="identifier">size_type</span> <span class="identifier">result</span><span class="special">;</span>
492        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
493            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
494                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&gt;=</span> <span class="identifier">capacity</span><span class="special">());</span>
495            <span class="special">})</span>
496        <span class="special">;</span>
497
498        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">max_size</span><span class="special">();</span>
499    <span class="special">}</span>
500
501    <span class="keyword">bool</span> <span class="identifier">empty</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
502        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
503        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
504            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
505                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span>
506            <span class="special">})</span>
507        <span class="special">;</span>
508
509        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">empty</span><span class="special">();</span>
510    <span class="special">}</span>
511
512    <span class="identifier">Allocator</span> <span class="identifier">get_allocator</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
513        <span class="comment">// Check invariants.</span>
514        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
515        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">get_allocator</span><span class="special">();</span>
516    <span class="special">}</span>
517
518    <span class="identifier">reference</span> <span class="identifier">at</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">index</span><span class="special">)</span> <span class="special">{</span>
519        <span class="comment">// Check invariants, no pre (throw out_of_range for invalid index).</span>
520        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
521        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="identifier">index</span><span class="special">);</span>
522    <span class="special">}</span>
523
524    <span class="identifier">const_reference</span> <span class="identifier">at</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">index</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
525        <span class="comment">// Check invariants, no pre (throw out_of_range for invalid index).</span>
526        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
527        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="identifier">index</span><span class="special">);</span>
528    <span class="special">}</span>
529
530    <span class="identifier">reference</span> <span class="keyword">operator</span><span class="special">[](</span><span class="identifier">size_type</span> <span class="identifier">index</span><span class="special">)</span> <span class="special">{</span>
531        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
532            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
533                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">index</span> <span class="special">&lt;</span> <span class="identifier">size</span><span class="special">());</span>
534            <span class="special">})</span>
535        <span class="special">;</span>
536
537        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">[</span><span class="identifier">index</span><span class="special">];</span>
538    <span class="special">}</span>
539
540    <span class="identifier">const_reference</span> <span class="keyword">operator</span><span class="special">[](</span><span class="identifier">size_type</span> <span class="identifier">index</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
541        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
542            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
543                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">index</span> <span class="special">&lt;</span> <span class="identifier">size</span><span class="special">());</span>
544            <span class="special">})</span>
545        <span class="special">;</span>
546
547        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">[</span><span class="identifier">index</span><span class="special">];</span>
548    <span class="special">}</span>
549
550    <span class="identifier">reference</span> <span class="identifier">front</span><span class="special">()</span> <span class="special">{</span>
551        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
552            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
553                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
554            <span class="special">})</span>
555        <span class="special">;</span>
556
557        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">front</span><span class="special">();</span>
558    <span class="special">}</span>
559
560    <span class="identifier">const_reference</span> <span class="identifier">front</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
561        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
562            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
563                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
564            <span class="special">})</span>
565        <span class="special">;</span>
566
567        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">front</span><span class="special">();</span>
568    <span class="special">}</span>
569
570    <span class="identifier">reference</span> <span class="identifier">back</span><span class="special">()</span> <span class="special">{</span>
571        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
572            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
573                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
574            <span class="special">})</span>
575        <span class="special">;</span>
576
577        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">back</span><span class="special">();</span>
578    <span class="special">}</span>
579
580    <span class="identifier">const_reference</span> <span class="identifier">back</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
581        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
582            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
583                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
584            <span class="special">})</span>
585        <span class="special">;</span>
586
587        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">back</span><span class="special">();</span>
588    <span class="special">}</span>
589
590    <span class="keyword">void</span> <span class="identifier">push_back</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
591        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_size</span> <span class="special">=</span>
592                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
593        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_capacity</span> <span class="special">=</span>
594                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">());</span>
595        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
596            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
597                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">());</span>
598            <span class="special">})</span>
599            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
600                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_size</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span>
601                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="special">*</span><span class="identifier">old_capacity</span><span class="special">);</span>
602                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
603                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
604                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;(),</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">back</span><span class="special">()),</span>
605                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">value</span><span class="special">))</span>
606                    <span class="special">)</span>
607                <span class="special">);</span>
608            <span class="special">})</span>
609        <span class="special">;</span>
610
611        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(</span><span class="identifier">value</span><span class="special">);</span>
612    <span class="special">}</span>
613
614    <span class="keyword">void</span> <span class="identifier">pop_back</span><span class="special">()</span> <span class="special">{</span>
615        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_size</span> <span class="special">=</span>
616                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
617        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
618            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
619                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
620            <span class="special">})</span>
621            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
622                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_size</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span>
623            <span class="special">})</span>
624        <span class="special">;</span>
625
626        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">pop_back</span><span class="special">();</span>
627    <span class="special">}</span>
628
629    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
630    <span class="keyword">void</span> <span class="identifier">assign</span><span class="special">(</span><span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">{</span>
631        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
632            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
633                <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(</span>
634                        <span class="special">!</span><span class="identifier">contained</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">));</span>
635            <span class="special">})</span>
636            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
637                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">==</span>
638                        <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">()));</span>
639            <span class="special">})</span>
640        <span class="special">;</span>
641
642        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">assign</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">);</span>
643    <span class="special">}</span>
644
645    <span class="keyword">void</span> <span class="identifier">assign</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
646        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
647            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
648                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span> <span class="special">&lt;=</span> <span class="identifier">max_size</span><span class="special">());</span>
649            <span class="special">})</span>
650            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
651                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
652                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
653                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">all_of_equal_to</span><span class="special">(),</span> <span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span>
654                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">value</span><span class="special">))</span>
655                    <span class="special">)</span>
656                <span class="special">);</span>
657            <span class="special">})</span>
658        <span class="special">;</span>
659
660        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">assign</span><span class="special">(</span><span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
661    <span class="special">}</span>
662
663    <span class="identifier">iterator</span> <span class="identifier">insert</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">where</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
664        <span class="identifier">iterator</span> <span class="identifier">result</span><span class="special">;</span>
665        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_size</span> <span class="special">=</span>
666                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
667        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_capacity</span> <span class="special">=</span>
668                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">());</span>
669        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
670            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
671                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">());</span>
672            <span class="special">})</span>
673            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
674                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_size</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span>
675                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="special">*</span><span class="identifier">old_capacity</span><span class="special">);</span>
676                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
677                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
678                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;(),</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(*</span><span class="identifier">result</span><span class="special">),</span>
679                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">value</span><span class="special">))</span>
680                    <span class="special">)</span>
681                <span class="special">);</span>
682                <span class="keyword">if</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;</span> <span class="special">*</span><span class="identifier">old_capacity</span><span class="special">)</span> <span class="special">{</span>
683                    <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(!</span><span class="identifier">valid</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">()));</span>
684                <span class="special">}</span> <span class="keyword">else</span> <span class="special">{</span>
685                    <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(!</span><span class="identifier">valid</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">end</span><span class="special">()));</span>
686                <span class="special">}</span>
687            <span class="special">})</span>
688        <span class="special">;</span>
689
690        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
691    <span class="special">}</span>
692
693    <span class="keyword">void</span> <span class="identifier">insert</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">where</span><span class="special">,</span> <span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
694        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_size</span> <span class="special">=</span>
695                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
696        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_capacity</span> <span class="special">=</span>
697                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">());</span>
698        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">iterator</span><span class="special">&gt;</span> <span class="identifier">old_where</span> <span class="special">=</span>
699                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">where</span><span class="special">);</span>
700        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
701            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
702                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">+</span> <span class="identifier">count</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">());</span>
703            <span class="special">})</span>
704            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
705                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_size</span> <span class="special">+</span> <span class="identifier">count</span><span class="special">);</span>
706                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="special">*</span><span class="identifier">old_capacity</span><span class="special">);</span>
707                <span class="keyword">if</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_capacity</span><span class="special">)</span> <span class="special">{</span>
708                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
709                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
710                            <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">all_of_equal_to</span><span class="special">(),</span>
711                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">prior</span><span class="special">(*</span><span class="identifier">old_where</span><span class="special">),</span>
712                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">prior</span><span class="special">(*</span><span class="identifier">old_where</span><span class="special">)</span> <span class="special">+</span> <span class="identifier">count</span><span class="special">,</span>
713                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">value</span><span class="special">)</span>
714                            <span class="special">)</span>
715                        <span class="special">)</span>
716                    <span class="special">);</span>
717                    <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(!</span><span class="identifier">valid</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">end</span><span class="special">()));</span>
718                <span class="special">}</span> <span class="keyword">else</span> <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(!</span><span class="identifier">valid</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">()));</span>
719            <span class="special">})</span>
720        <span class="special">;</span>
721
722        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
723    <span class="special">}</span>
724
725    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
726    <span class="keyword">void</span> <span class="identifier">insert</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">where</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">{</span>
727        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_size</span> <span class="special">=</span>
728                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
729        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_capacity</span> <span class="special">=</span>
730                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">());</span>
731        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">iterator</span><span class="special">&gt;</span> <span class="identifier">old_where</span> <span class="special">=</span>
732                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">where</span><span class="special">);</span>
733        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
734            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
735                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">+</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">&lt;</span>
736                        <span class="identifier">max_size</span><span class="special">());</span>
737                <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(</span>
738                        <span class="special">!</span><span class="identifier">contained</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">()));</span>
739            <span class="special">})</span>
740            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
741                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_size</span><span class="special">()</span> <span class="special">+</span>
742                        <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">));</span>
743                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="special">*</span><span class="identifier">old_capacity</span><span class="special">);</span>
744                <span class="keyword">if</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_capacity</span><span class="special">)</span> <span class="special">{</span>
745                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span>
746                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(</span>
747                            <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">all_of_equal_to</span><span class="special">(),</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">,</span>
748                                    <span class="special">*</span><span class="identifier">old_where</span><span class="special">)</span>
749                        <span class="special">)</span>
750                    <span class="special">);</span>
751                    <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(!</span><span class="identifier">valid</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">end</span><span class="special">()));</span>
752                <span class="special">}</span> <span class="keyword">else</span> <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(!</span><span class="identifier">valid</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">()));</span>
753            <span class="special">})</span>
754        <span class="special">;</span>
755
756        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">);</span>
757    <span class="special">}</span>
758
759    <span class="identifier">iterator</span> <span class="identifier">erase</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">where</span><span class="special">)</span> <span class="special">{</span>
760        <span class="identifier">iterator</span> <span class="identifier">result</span><span class="special">;</span>
761        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_size</span> <span class="special">=</span>
762                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
763        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
764            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
765                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
766                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">where</span> <span class="special">!=</span> <span class="identifier">end</span><span class="special">());</span>
767            <span class="special">})</span>
768            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
769                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_size</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span>
770                <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">end</span><span class="special">());</span>
771                <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(!</span><span class="identifier">valid</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">end</span><span class="special">()));</span>
772            <span class="special">})</span>
773        <span class="special">;</span>
774
775        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">erase</span><span class="special">(</span><span class="identifier">where</span><span class="special">);</span>
776    <span class="special">}</span>
777
778    <span class="identifier">iterator</span> <span class="identifier">erase</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">iterator</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">{</span>
779        <span class="identifier">iterator</span> <span class="identifier">result</span><span class="special">;</span>
780        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">size_type</span><span class="special">&gt;</span> <span class="identifier">old_size</span> <span class="special">=</span>
781                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
782        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
783            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
784                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">));</span>
785            <span class="special">})</span>
786            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
787                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_size</span> <span class="special">-</span>
788                        <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">));</span>
789                <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">end</span><span class="special">());</span>
790                <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(!</span><span class="identifier">valid</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">));</span>
791            <span class="special">})</span>
792        <span class="special">;</span>
793
794        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">erase</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">);</span>
795    <span class="special">}</span>
796
797    <span class="keyword">void</span> <span class="identifier">clear</span><span class="special">()</span> <span class="special">{</span>
798        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
799            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
800                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">());</span>
801            <span class="special">})</span>
802        <span class="special">;</span>
803
804        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">clear</span><span class="special">();</span>
805    <span class="special">}</span>
806
807    <span class="keyword">void</span> <span class="identifier">swap</span><span class="special">(</span><span class="identifier">vector</span><span class="special">&amp;</span> <span class="identifier">other</span><span class="special">)</span> <span class="special">{</span>
808        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&gt;</span> <span class="identifier">old_me</span><span class="special">,</span> <span class="identifier">old_other</span><span class="special">;</span>
809        <span class="preprocessor">#ifdef</span> <span class="identifier">BOOST_CONTRACT_AUDITS</span>
810            <span class="identifier">old_me</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(*</span><span class="keyword">this</span><span class="special">);</span>
811            <span class="identifier">old_other</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">other</span><span class="special">);</span>
812        <span class="preprocessor">#endif</span>
813        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
814            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
815                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">get_allocator</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">get_allocator</span><span class="special">());</span>
816            <span class="special">})</span>
817            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
818                <span class="identifier">BOOST_CONTRACT_ASSERT_AUDIT</span><span class="special">(</span>
819                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span>
820                            <span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span> <span class="special">&gt;(</span>
821                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">equal_to</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(),</span>
822                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(*</span><span class="keyword">this</span><span class="special">),</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(*</span><span class="identifier">old_other</span><span class="special">))</span>
823                    <span class="special">)</span>
824                <span class="special">);</span>
825                <span class="identifier">BOOST_CONTRACT_ASSERT_AUDIT</span><span class="special">(</span>
826                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">condition_if</span><span class="special">&lt;</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span>
827                            <span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span> <span class="special">&gt;(</span>
828                        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">bind</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">equal_to</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;(),</span>
829                                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(</span><span class="identifier">other</span><span class="special">),</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">cref</span><span class="special">(*</span><span class="identifier">old_me</span><span class="special">))</span>
830                    <span class="special">)</span>
831                <span class="special">);</span>
832            <span class="special">})</span>
833        <span class="special">;</span>
834
835        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">swap</span><span class="special">(</span><span class="identifier">other</span><span class="special">);</span>
836    <span class="special">}</span>
837
838    <span class="keyword">friend</span> <span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">==(</span><span class="identifier">vector</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">left</span><span class="special">,</span> <span class="identifier">vector</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">right</span><span class="special">)</span> <span class="special">{</span>
839        <span class="comment">// Check class invariants for left and right objects.</span>
840        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">left_inv</span> <span class="special">=</span>
841                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(&amp;</span><span class="identifier">left</span><span class="special">);</span>
842        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">right_inv</span> <span class="special">=</span>
843                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(&amp;</span><span class="identifier">right</span><span class="special">);</span>
844        <span class="keyword">return</span> <span class="identifier">left</span><span class="special">.</span><span class="identifier">vect_</span> <span class="special">==</span> <span class="identifier">right</span><span class="special">.</span><span class="identifier">vect_</span><span class="special">;</span>
845    <span class="special">}</span>
846
847<span class="keyword">private</span><span class="special">:</span>
848    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;</span> <span class="identifier">vect_</span><span class="special">;</span>
849<span class="special">};</span>
850
851<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
852    <span class="comment">// char type has operator==.</span>
853
854    <span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">char</span><span class="special">&gt;</span> <span class="identifier">v</span><span class="special">(</span><span class="number">3</span><span class="special">);</span>
855    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">v</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">3</span><span class="special">);</span>
856    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="char">'\0'</span><span class="special">));</span>
857
858    <span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">char</span><span class="special">&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">cv</span> <span class="special">=</span> <span class="identifier">v</span><span class="special">;</span>
859    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">cv</span> <span class="special">==</span> <span class="identifier">v</span><span class="special">);</span>
860
861    <span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">char</span><span class="special">&gt;</span> <span class="identifier">w</span><span class="special">(</span><span class="identifier">v</span><span class="special">);</span>
862    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">w</span> <span class="special">==</span> <span class="identifier">v</span><span class="special">);</span>
863
864    <span class="keyword">typename</span> <span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">char</span><span class="special">&gt;::</span><span class="identifier">iterator</span> <span class="identifier">i</span> <span class="special">=</span> <span class="identifier">v</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
865    <span class="identifier">assert</span><span class="special">(*</span><span class="identifier">i</span> <span class="special">==</span> <span class="char">'\0'</span><span class="special">);</span>
866
867    <span class="keyword">typename</span> <span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">char</span><span class="special">&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">ci</span> <span class="special">=</span> <span class="identifier">cv</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
868    <span class="identifier">assert</span><span class="special">(*</span><span class="identifier">ci</span> <span class="special">==</span> <span class="char">'\0'</span><span class="special">);</span>
869
870    <span class="identifier">v</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">i</span><span class="special">,</span> <span class="number">2</span><span class="special">,</span> <span class="char">'a'</span><span class="special">);</span>
871    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">v</span><span class="special">[</span><span class="number">0</span><span class="special">]</span> <span class="special">==</span> <span class="char">'a'</span><span class="special">);</span>
872    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">v</span><span class="special">[</span><span class="number">1</span><span class="special">]</span> <span class="special">==</span> <span class="char">'a'</span><span class="special">);</span>
873
874    <span class="identifier">v</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(</span><span class="char">'b'</span><span class="special">);</span>
875    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">v</span><span class="special">.</span><span class="identifier">back</span><span class="special">()</span> <span class="special">==</span> <span class="char">'b'</span><span class="special">);</span>
876
877    <span class="keyword">struct</span> <span class="identifier">x</span> <span class="special">{};</span> <span class="comment">// x type doest not have operator==.</span>
878
879    <span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">x</span><span class="special">&gt;</span> <span class="identifier">y</span><span class="special">(</span><span class="number">3</span><span class="special">);</span>
880    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">y</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">3</span><span class="special">);</span>
881
882    <span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">x</span><span class="special">&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">cy</span> <span class="special">=</span> <span class="identifier">y</span><span class="special">;</span>
883    <span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">x</span><span class="special">&gt;</span> <span class="identifier">z</span><span class="special">(</span><span class="identifier">y</span><span class="special">);</span>
884
885    <span class="keyword">typename</span> <span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">x</span><span class="special">&gt;::</span><span class="identifier">iterator</span> <span class="identifier">j</span> <span class="special">=</span> <span class="identifier">y</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
886    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">j</span> <span class="special">!=</span> <span class="identifier">y</span><span class="special">.</span><span class="identifier">end</span><span class="special">());</span>
887    <span class="keyword">typename</span> <span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">x</span><span class="special">&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">cj</span> <span class="special">=</span> <span class="identifier">cy</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
888    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">cj</span> <span class="special">!=</span> <span class="identifier">cy</span><span class="special">.</span><span class="identifier">end</span><span class="special">());</span>
889
890    <span class="identifier">y</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">j</span><span class="special">,</span> <span class="number">2</span><span class="special">,</span> <span class="identifier">x</span><span class="special">());</span>
891    <span class="identifier">y</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(</span><span class="identifier">x</span><span class="special">());</span>
892
893    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
894<span class="special">}</span>
895</pre>
896<p>
897                </p>
898              </td>
899<td>
900                <p>
901</p>
902<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="comment">// Extra spaces, newlines, etc. for visual alignment with this library code.</span>
903
904<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">algorithm</span><span class="special">/</span><span class="identifier">cxx11</span><span class="special">/</span><span class="identifier">all_of</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
905<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">type_traits</span><span class="special">/</span><span class="identifier">has_equal_to</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
906<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">next_prior</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
907<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&gt;</span>
908<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">iterator</span><span class="special">&gt;</span>
909<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">memory</span><span class="special">&gt;</span>
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939<span class="keyword">template</span><span class="special">&lt;</span> <span class="keyword">class</span> <span class="identifier">T</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">Allocator</span> <span class="special">=</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">allocator</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span>
940<span class="keyword">class</span> <span class="identifier">vector</span> <span class="special">{</span>
941
942
943    <span class="identifier">invariant</span> <span class="special">{</span>
944        <span class="identifier">empty</span><span class="special">()</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
945        <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">())</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
946        <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">rbegin</span><span class="special">(),</span> <span class="identifier">rend</span><span class="special">())</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
947        <span class="identifier">size</span><span class="special">()</span> <span class="special">&lt;=</span> <span class="identifier">capacity</span><span class="special">();</span>
948        <span class="identifier">capacity</span><span class="special">()</span> <span class="special">&lt;=</span> <span class="identifier">max_size</span><span class="special">();</span>
949    <span class="special">}</span>
950
951<span class="keyword">public</span><span class="special">:</span>
952    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">allocator_type</span> <span class="identifier">allocator_type</span><span class="special">;</span>
953    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">pointer</span> <span class="identifier">pointer</span><span class="special">;</span>
954    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">const_pointer</span> <span class="identifier">const_pointer</span><span class="special">;</span>
955    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">reference</span> <span class="identifier">reference</span><span class="special">;</span>
956    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">const_reference</span> <span class="identifier">const_reference</span><span class="special">;</span>
957    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">value_type</span> <span class="identifier">value_type</span><span class="special">;</span>
958    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">iterator</span> <span class="identifier">iterator</span><span class="special">;</span>
959    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">const_iterator</span><span class="special">;</span>
960    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">size_type</span> <span class="identifier">size_type</span><span class="special">;</span>
961    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">difference_type</span> <span class="identifier">difference_type</span><span class="special">;</span>
962    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">reverse_iterator</span>
963            <span class="identifier">reverse_iterator</span><span class="special">;</span>
964    <span class="keyword">typedef</span> <span class="keyword">typename</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;::</span><span class="identifier">const_reverse_iterator</span>
965            <span class="identifier">const_reverse_iterator</span><span class="special">;</span>
966
967    <span class="identifier">vector</span><span class="special">()</span>
968        <span class="identifier">postcondition</span> <span class="special">{</span>
969            <span class="identifier">empty</span><span class="special">();</span>
970        <span class="special">}</span>
971        <span class="special">:</span> <span class="identifier">vect_</span><span class="special">()</span>
972    <span class="special">{}</span>
973
974
975    <span class="keyword">explicit</span> <span class="identifier">vector</span><span class="special">(</span><span class="identifier">Allocator</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">alloc</span><span class="special">)</span>
976        <span class="identifier">postcondition</span> <span class="special">{</span>
977            <span class="identifier">empty</span><span class="special">();</span>
978            <span class="identifier">get_allocator</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">alloc</span><span class="special">;</span>
979        <span class="special">}</span>
980        <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">alloc</span><span class="special">)</span>
981    <span class="special">{}</span>
982
983
984    <span class="keyword">explicit</span> <span class="identifier">vector</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">)</span>
985        <span class="identifier">postcondition</span> <span class="special">{</span>
986            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">;</span>
987            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
988                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span> <span class="identifier">T</span><span class="special">());</span>
989            <span class="special">}</span>
990        <span class="special">}</span>
991        <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">count</span><span class="special">)</span>
992    <span class="special">{}</span>
993
994
995
996
997    <span class="identifier">vector</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span>
998        <span class="identifier">postcondition</span> <span class="special">{</span>
999            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">;</span>
1000            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1001                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span> <span class="identifier">value</span><span class="special">);</span>
1002            <span class="special">}</span>
1003        <span class="special">}</span>
1004        <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">)</span>
1005    <span class="special">{}</span>
1006
1007
1008
1009
1010
1011    <span class="identifier">vector</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">,</span> <span class="identifier">Allocator</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">alloc</span><span class="special">)</span>
1012        <span class="identifier">postcondition</span> <span class="special">{</span>
1013            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">;</span>
1014            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1015                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span> <span class="identifier">value</span><span class="special">);</span>
1016            <span class="special">}</span>
1017            <span class="identifier">get_allocator</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">alloc</span><span class="special">;</span>
1018        <span class="special">}</span>
1019        <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">,</span> <span class="identifier">alloc</span><span class="special">)</span>
1020    <span class="special">{}</span>
1021
1022
1023
1024
1025
1026
1027    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
1028    <span class="identifier">vector</span><span class="special">(</span><span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">)</span>
1029        <span class="identifier">postcondition</span> <span class="special">{</span>
1030            <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
1031        <span class="special">}</span>
1032        <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span>
1033    <span class="special">{}</span>
1034
1035
1036
1037    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
1038    <span class="identifier">vector</span><span class="special">(</span><span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">Allocator</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">alloc</span><span class="special">)</span>
1039        <span class="identifier">postcondition</span> <span class="special">{</span>
1040            <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
1041            <span class="identifier">get_allocator</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">alloc</span><span class="special">;</span>
1042        <span class="special">}</span>
1043        <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">alloc</span><span class="special">)</span>
1044    <span class="special">{}</span>
1045
1046
1047
1048
1049    <span class="comment">/* implicit */</span> <span class="identifier">vector</span><span class="special">(</span><span class="identifier">vector</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">other</span><span class="special">)</span>
1050        <span class="identifier">postcondition</span> <span class="special">{</span>
1051            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1052                <span class="special">*</span><span class="keyword">this</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">;</span>
1053            <span class="special">}</span>
1054        <span class="special">}</span>
1055        <span class="special">:</span> <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">other</span><span class="special">.</span><span class="identifier">vect_</span><span class="special">)</span>
1056    <span class="special">{}</span>
1057
1058
1059
1060
1061
1062    <span class="identifier">vector</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=(</span><span class="identifier">vector</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">other</span><span class="special">)</span>
1063        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1064            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1065                <span class="special">*</span><span class="keyword">this</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">;</span>
1066                <span class="identifier">result</span> <span class="special">==</span> <span class="special">*</span><span class="keyword">this</span><span class="special">;</span>
1067            <span class="special">}</span>
1068        <span class="special">}</span>
1069    <span class="special">{</span>
1070        <span class="keyword">if</span><span class="special">(</span><span class="keyword">this</span> <span class="special">!=</span> <span class="special">&amp;</span><span class="identifier">other</span><span class="special">)</span> <span class="identifier">vect_</span> <span class="special">=</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">vect_</span><span class="special">;</span>
1071        <span class="keyword">return</span> <span class="special">*</span><span class="keyword">this</span><span class="special">;</span>
1072    <span class="special">}</span>
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">vector</span><span class="special">()</span> <span class="special">{}</span>
1086
1087
1088
1089
1090    <span class="keyword">void</span> <span class="identifier">reserve</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">)</span>
1091        <span class="identifier">precondition</span> <span class="special">{</span>
1092            <span class="identifier">count</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">();</span>
1093        <span class="special">}</span>
1094        <span class="identifier">postcondition</span> <span class="special">{</span>
1095            <span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">count</span><span class="special">;</span>
1096        <span class="special">}</span>
1097    <span class="special">{</span>
1098        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">reserve</span><span class="special">(</span><span class="identifier">count</span><span class="special">);</span>
1099    <span class="special">}</span>
1100
1101
1102
1103    <span class="identifier">size_type</span> <span class="identifier">capacity</span><span class="special">()</span> <span class="keyword">const</span>
1104        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1105            <span class="identifier">result</span> <span class="special">&gt;=</span> <span class="identifier">size</span><span class="special">();</span>
1106        <span class="special">}</span>
1107    <span class="special">{</span>
1108        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">();</span>
1109    <span class="special">}</span>
1110
1111
1112
1113
1114    <span class="identifier">iterator</span> <span class="identifier">begin</span><span class="special">()</span>
1115        <span class="identifier">postcondition</span> <span class="special">{</span>
1116            <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">result</span> <span class="special">==</span> <span class="identifier">end</span><span class="special">();</span>
1117        <span class="special">}</span>
1118    <span class="special">{</span>
1119        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
1120    <span class="special">}</span>
1121
1122
1123
1124
1125    <span class="identifier">const_iterator</span> <span class="identifier">begin</span><span class="special">()</span> <span class="keyword">const</span>
1126        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1127            <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">result</span> <span class="special">==</span> <span class="identifier">end</span><span class="special">();</span>
1128        <span class="special">}</span>
1129    <span class="special">{</span>
1130        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
1131    <span class="special">}</span>
1132
1133
1134
1135
1136    <span class="identifier">iterator</span> <span class="identifier">end</span><span class="special">()</span> <span class="special">{</span>
1137        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">end</span><span class="special">();</span>
1138    <span class="special">}</span>
1139
1140
1141
1142    <span class="identifier">const_iterator</span> <span class="identifier">end</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
1143        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">end</span><span class="special">();</span>
1144    <span class="special">}</span>
1145
1146
1147
1148    <span class="identifier">reverse_iterator</span> <span class="identifier">rbegin</span><span class="special">()</span>
1149        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1150            <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">result</span> <span class="special">==</span> <span class="identifier">rend</span><span class="special">();</span>
1151        <span class="special">}</span>
1152    <span class="special">{</span>
1153        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">rbegin</span><span class="special">();</span>
1154    <span class="special">}</span>
1155
1156
1157
1158
1159    <span class="identifier">const_reverse_iterator</span> <span class="identifier">rbegin</span><span class="special">()</span> <span class="keyword">const</span>
1160        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1161            <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">result</span> <span class="special">==</span> <span class="identifier">rend</span><span class="special">();</span>
1162        <span class="special">}</span>
1163    <span class="special">{</span>
1164        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">rbegin</span><span class="special">();</span>
1165    <span class="special">}</span>
1166
1167
1168
1169
1170    <span class="identifier">reverse_iterator</span> <span class="identifier">rend</span><span class="special">()</span> <span class="special">{</span>
1171        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">rend</span><span class="special">();</span>
1172    <span class="special">}</span>
1173
1174
1175
1176    <span class="identifier">const_reverse_iterator</span> <span class="identifier">rend</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
1177        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">rend</span><span class="special">();</span>
1178    <span class="special">}</span>
1179
1180
1181
1182    <span class="keyword">void</span> <span class="identifier">resize</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span> <span class="special">=</span> <span class="identifier">T</span><span class="special">())</span>
1183        <span class="identifier">postcondition</span> <span class="special">{</span>
1184            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">;</span>
1185            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1186                <span class="keyword">if</span><span class="special">(</span><span class="identifier">count</span> <span class="special">&gt;</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">size</span><span class="special">()))</span> <span class="special">{</span>
1187                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">begin</span><span class="special">()</span> <span class="special">+</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">size</span><span class="special">()),</span>
1188                            <span class="identifier">end</span><span class="special">(),</span> <span class="identifier">value</span><span class="special">);</span>
1189                <span class="special">}</span>
1190            <span class="special">}</span>
1191        <span class="special">}</span>
1192    <span class="special">{</span>
1193        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">resize</span><span class="special">(</span><span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
1194    <span class="special">}</span>
1195
1196
1197
1198
1199
1200
1201
1202    <span class="identifier">size_type</span> <span class="identifier">size</span><span class="special">()</span> <span class="keyword">const</span>
1203        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1204            <span class="identifier">result</span> <span class="special">&lt;=</span> <span class="identifier">capacity</span><span class="special">();</span>
1205        <span class="special">}</span>
1206    <span class="special">{</span>
1207        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span>
1208    <span class="special">}</span>
1209
1210
1211
1212
1213    <span class="identifier">size_type</span> <span class="identifier">max_size</span><span class="special">()</span> <span class="keyword">const</span>
1214        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1215            <span class="identifier">result</span> <span class="special">&gt;=</span> <span class="identifier">capacity</span><span class="special">();</span>
1216        <span class="special">}</span>
1217    <span class="special">{</span>
1218        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">max_size</span><span class="special">();</span>
1219    <span class="special">}</span>
1220
1221
1222
1223
1224    <span class="keyword">bool</span> <span class="identifier">empty</span><span class="special">()</span> <span class="keyword">const</span>
1225        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1226            <span class="identifier">result</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
1227        <span class="special">}</span>
1228    <span class="special">{</span>
1229        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">empty</span><span class="special">();</span>
1230    <span class="special">}</span>
1231
1232
1233
1234
1235    <span class="identifier">Alloctor</span> <span class="identifier">get_allocator</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
1236        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">get_allocator</span><span class="special">();</span>
1237    <span class="special">}</span>
1238
1239
1240
1241    <span class="identifier">reference</span> <span class="identifier">at</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">index</span><span class="special">)</span> <span class="special">{</span>
1242        <span class="comment">// No precondition (throw out_of_range for invalid index).</span>
1243        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="identifier">index</span><span class="special">);</span>
1244    <span class="special">}</span>
1245
1246
1247    <span class="identifier">const_reference</span> <span class="identifier">at</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">index</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
1248        <span class="comment">// No precondition (throw out_of_range for invalid index).</span>
1249        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="identifier">index</span><span class="special">);</span>
1250    <span class="special">}</span>
1251
1252
1253    <span class="identifier">reference</span> <span class="keyword">operator</span><span class="special">[](</span><span class="identifier">size_type</span> <span class="identifier">index</span><span class="special">)</span>
1254        <span class="identifier">precondition</span> <span class="special">{</span>
1255            <span class="identifier">index</span> <span class="special">&lt;</span> <span class="identifier">size</span><span class="special">();</span>
1256        <span class="special">}</span>
1257    <span class="special">{</span>
1258        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">[</span><span class="identifier">index</span><span class="special">];</span>
1259    <span class="special">}</span>
1260
1261
1262
1263    <span class="identifier">const_reference</span> <span class="keyword">operator</span><span class="special">[](</span><span class="identifier">size_type</span> <span class="identifier">index</span><span class="special">)</span> <span class="keyword">const</span>
1264        <span class="identifier">precondition</span> <span class="special">{</span>
1265            <span class="identifier">index</span> <span class="special">&lt;</span> <span class="identifier">size</span><span class="special">();</span>
1266        <span class="special">}</span>
1267    <span class="special">{</span>
1268        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">[</span><span class="identifier">index</span><span class="special">];</span>
1269    <span class="special">}</span>
1270
1271
1272
1273    <span class="identifier">reference</span> <span class="identifier">front</span><span class="special">()</span>
1274        <span class="identifier">precondition</span> <span class="special">{</span>
1275            <span class="special">!</span><span class="identifier">empty</span><span class="special">();</span>
1276        <span class="special">}</span>
1277    <span class="special">{</span>
1278        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">front</span><span class="special">();</span>
1279    <span class="special">}</span>
1280
1281
1282
1283    <span class="identifier">const_reference</span> <span class="identifier">front</span><span class="special">()</span> <span class="keyword">const</span>
1284        <span class="identifier">precondition</span> <span class="special">{</span>
1285            <span class="special">!</span><span class="identifier">empty</span><span class="special">();</span>
1286        <span class="special">}</span>
1287    <span class="special">{</span>
1288        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">front</span><span class="special">();</span>
1289    <span class="special">}</span>
1290
1291
1292
1293    <span class="identifier">reference</span> <span class="identifier">back</span><span class="special">()</span>
1294        <span class="identifier">precondition</span> <span class="special">{</span>
1295            <span class="special">!</span><span class="identifier">empty</span><span class="special">();</span>
1296        <span class="special">}</span>
1297    <span class="special">{</span>
1298        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">back</span><span class="special">();</span>
1299    <span class="special">}</span>
1300
1301
1302
1303    <span class="identifier">const_reference</span> <span class="identifier">back</span><span class="special">()</span> <span class="keyword">const</span>
1304        <span class="identifier">precondition</span> <span class="special">{</span>
1305            <span class="special">!</span><span class="identifier">empty</span><span class="special">();</span>
1306        <span class="special">}</span>
1307    <span class="special">{</span>
1308        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">back</span><span class="special">();</span>
1309    <span class="special">}</span>
1310
1311
1312
1313    <span class="keyword">void</span> <span class="identifier">push_back</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span>
1314        <span class="identifier">precondition</span> <span class="special">{</span>
1315            <span class="identifier">size</span><span class="special">()</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">();</span>
1316        <span class="special">}</span>
1317        <span class="identifier">postcondition</span> <span class="special">{</span>
1318            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">size</span><span class="special">())</span> <span class="special">+</span> <span class="number">1</span><span class="special">;</span>
1319            <span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">())</span>
1320            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1321                <span class="identifier">back</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">value</span><span class="special">;</span>
1322            <span class="special">}</span>
1323        <span class="special">}</span>
1324    <span class="special">{</span>
1325        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(</span><span class="identifier">value</span><span class="special">);</span>
1326    <span class="special">}</span>
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337    <span class="keyword">void</span> <span class="identifier">pop_back</span><span class="special">()</span>
1338        <span class="identifier">precondition</span> <span class="special">{</span>
1339            <span class="special">!</span><span class="identifier">empty</span><span class="special">();</span>
1340        <span class="special">}</span>
1341        <span class="identifier">postcondition</span> <span class="special">{</span>
1342            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">size</span><span class="special">())</span> <span class="special">-</span> <span class="number">1</span><span class="special">;</span>
1343        <span class="special">}</span>
1344    <span class="special">{</span>
1345        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">pop_back</span><span class="special">();</span>
1346    <span class="special">}</span>
1347
1348
1349
1350
1351
1352    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
1353    <span class="keyword">void</span> <span class="identifier">assign</span><span class="special">(</span><span class="identifier">InputIter</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">InputIter</span> <span class="identifier">last</span><span class="special">)</span>
1354        <span class="comment">// Precondition: [begin(), end()) does not contain [first, last).</span>
1355        <span class="identifier">postcondition</span> <span class="special">{</span>
1356            <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">size</span><span class="special">());</span>
1357        <span class="special">}</span>
1358    <span class="special">{</span>
1359        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">assign</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">);</span>
1360    <span class="special">}</span>
1361
1362
1363
1364
1365
1366
1367
1368    <span class="keyword">void</span> <span class="identifier">assign</span><span class="special">(</span><span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">vallue</span><span class="special">)</span>
1369        <span class="identifier">precondition</span> <span class="special">{</span>
1370            <span class="identifier">count</span> <span class="special">&lt;=</span> <span class="identifier">max_size</span><span class="special">();</span>
1371        <span class="special">}</span>
1372        <span class="identifier">postcondition</span> <span class="special">{</span>
1373            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1374                <span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">end</span><span class="special">(),</span> <span class="identifier">value</span><span class="special">);</span>
1375            <span class="special">}</span>
1376        <span class="special">}</span>
1377    <span class="special">{</span>
1378        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">assign</span><span class="special">(</span><span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
1379    <span class="special">}</span>
1380
1381
1382
1383
1384
1385
1386    <span class="identifier">iterator</span> <span class="identifier">insert</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">where</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span>
1387        <span class="identifier">precondition</span> <span class="special">{</span>
1388            <span class="identifier">size</span><span class="special">()</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">();</span>
1389        <span class="special">}</span>
1390        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1391            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">size</span><span class="special">())</span> <span class="special">+</span> <span class="number">1</span><span class="special">;</span>
1392            <span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">());</span>
1393            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1394                <span class="special">*</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">value</span><span class="special">;</span>
1395            <span class="special">}</span>
1396            <span class="comment">//  if(capacity() &gt; oldof(capacity()))</span>
1397            <span class="comment">//      [begin(), end()) is invalid</span>
1398            <span class="comment">//  else</span>
1399            <span class="comment">//      [where, end()) is invalid</span>
1400        <span class="special">}</span>
1401    <span class="special">{</span>
1402        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
1403    <span class="special">}</span>
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416    <span class="keyword">void</span> <span class="identifier">insert</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">where</span><span class="special">,</span> <span class="identifier">size_type</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span>
1417        <span class="identifier">precondition</span> <span class="special">{</span>
1418            <span class="identifier">size</span><span class="special">()</span> <span class="special">+</span> <span class="identifier">count</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">();</span>
1419        <span class="special">}</span>
1420        <span class="identifier">postcondition</span> <span class="special">{</span>
1421            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">size</span><span class="special">())</span> <span class="special">+</span> <span class="identifier">count</span><span class="special">;</span>
1422            <span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">());</span>
1423            <span class="keyword">if</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()))</span> <span class="special">{</span>
1424                <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1425                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">prior</span><span class="special">(</span><span class="identifier">oldof</span><span class="special">(</span><span class="identifier">where</span><span class="special">)),</span>
1426                            <span class="identifier">boost</span><span class="special">::</span><span class="identifier">prior</span><span class="special">(</span><span class="identifier">oldof</span><span class="special">(</span><span class="identifier">where</span><span class="special">))</span> <span class="special">+</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
1427                <span class="special">}</span>
1428                <span class="comment">// [where, end()) is invalid</span>
1429            <span class="special">}</span>
1430            <span class="comment">// else [begin(), end()) is invalid</span>
1431        <span class="special">}</span>
1432    <span class="special">{</span>
1433        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">count</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
1434    <span class="special">}</span>
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448    <span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">InputIter</span><span class="special">&gt;</span>
1449    <span class="keyword">void</span> <span class="identifier">insert</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">where</span><span class="special">,</span> <span class="identifier">Iterator</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">Iterator</span> <span class="identifier">last</span><span class="special">)</span>
1450        <span class="identifier">precondition</span> <span class="special">{</span>
1451            <span class="identifier">size</span><span class="special">()</span> <span class="special">+</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">)</span> <span class="special">&lt;</span> <span class="identifier">max_size</span><span class="special">();</span>
1452            <span class="comment">// [first, last) is not contained in [begin(), end())</span>
1453        <span class="special">}</span>
1454        <span class="identifier">postcondition</span> <span class="special">{</span>
1455            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">size</span><span class="special">())</span> <span class="special">+</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">);</span>
1456            <span class="identifier">capacity</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">());</span>
1457            <span class="keyword">if</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()))</span> <span class="special">{</span>
1458                <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1459                    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">algorithm</span><span class="special">::</span><span class="identifier">all_of_equal</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">,</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">where</span><span class="special">));</span>
1460                <span class="special">}</span>
1461                <span class="comment">// [where, end()) is invalid</span>
1462            <span class="special">}</span>
1463            <span class="comment">// else [begin(), end()) is invalid</span>
1464        <span class="special">}</span>
1465    <span class="special">{</span>
1466        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">where</span><span class="special">,</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">);</span>
1467    <span class="special">}</span>
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482    <span class="identifier">iterator</span> <span class="identifier">erase</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">where</span><span class="special">)</span>
1483        <span class="identifier">precondition</span> <span class="special">{</span>
1484            <span class="special">!</span><span class="identifier">empty</span><span class="special">();</span>
1485            <span class="identifier">where</span> <span class="special">!=</span> <span class="identifier">end</span><span class="special">();</span>
1486        <span class="special">}</span>
1487        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1488            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldod</span> <span class="identifier">size</span><span class="special">()</span> <span class="special">-</span> <span class="number">1</span><span class="special">;</span>
1489            <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">result</span> <span class="special">==</span> <span class="identifier">end</span><span class="special">();</span>
1490            <span class="comment">// [where, end()) is invalid</span>
1491        <span class="special">}</span>
1492    <span class="special">{</span>
1493        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">erase</span><span class="special">(</span><span class="identifier">where</span><span class="special">);</span>
1494    <span class="special">}</span>
1495
1496
1497
1498
1499
1500
1501    <span class="identifier">iterator</span> <span class="identifier">erase</span><span class="special">(</span><span class="identifier">iterator</span> <span class="identifier">first</span><span class="special">,</span> <span class="identifier">iterator</span> <span class="identifier">last</span><span class="special">)</span>
1502        <span class="identifier">precondition</span> <span class="special">{</span>
1503            <span class="identifier">size</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">lasst</span><span class="special">);</span>
1504        <span class="special">}</span>
1505        <span class="identifier">postcondition</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1506            <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">size</span><span class="special">())</span> <span class="special">-</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">distance</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">);</span>
1507            <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">result</span> <span class="special">==</span> <span class="identifier">end</span><span class="special">();</span>
1508            <span class="comment">// [first, last) is invalid</span>
1509        <span class="special">}</span>
1510    <span class="special">{</span>
1511        <span class="keyword">return</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">erase</span><span class="special">(</span><span class="identifier">first</span><span class="special">,</span> <span class="identifier">last</span><span class="special">);</span>
1512    <span class="special">}</span>
1513
1514
1515
1516
1517
1518
1519
1520    <span class="keyword">void</span> <span class="identifier">clear</span><span class="special">()</span>
1521        <span class="identifier">postcondition</span> <span class="special">{</span>
1522            <span class="identifier">empty</span><span class="special">();</span>
1523        <span class="special">}</span>
1524    <span class="special">{</span>
1525        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">clear</span><span class="special">();</span>
1526    <span class="special">}</span>
1527
1528
1529
1530    <span class="keyword">void</span> <span class="identifier">swap</span><span class="special">(</span><span class="identifier">vector</span><span class="special">&amp;</span> <span class="identifier">other</span><span class="special">)</span>
1531        <span class="identifier">precondition</span> <span class="special">{</span>
1532            <span class="identifier">get_allocator</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">get_allocator</span><span class="special">();</span>
1533        <span class="special">}</span>
1534        <span class="identifier">postcondition</span> <span class="special">{</span>
1535            <span class="keyword">if</span> <span class="keyword">constexpr</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">has_equal_to</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
1536                <span class="special">*</span><span class="keyword">this</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(</span><span class="identifier">other</span><span class="special">);</span>
1537                <span class="identifier">other</span> <span class="special">==</span> <span class="identifier">oldof</span><span class="special">(*</span><span class="keyword">this</span><span class="special">);</span>
1538            <span class="special">}</span>
1539        <span class="special">}</span>
1540    <span class="special">{</span>
1541        <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">swap</span><span class="special">(</span><span class="identifier">other</span><span class="special">);</span>
1542    <span class="special">}</span>
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561    <span class="keyword">friend</span> <span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">==(</span><span class="identifier">vector</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">left</span><span class="special">,</span> <span class="identifier">vector</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">right</span><span class="special">)</span> <span class="special">{</span>
1562        <span class="comment">// Cannot check class invariants for left and right objects.</span>
1563        <span class="keyword">return</span> <span class="identifier">left</span><span class="special">.</span><span class="identifier">vect_</span> <span class="special">==</span> <span class="identifier">right</span><span class="special">.</span><span class="identifier">vect_</span><span class="special">;</span>
1564    <span class="special">}</span>
1565
1566
1567
1568
1569
1570<span class="keyword">private</span><span class="special">:</span>
1571    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">,</span> <span class="identifier">Allocator</span><span class="special">&gt;</span> <span class="identifier">vect_</span><span class="special">;</span>
1572<span class="special">};</span>
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617<span class="comment">// End.</span>
1618</pre>
1619<p>
1620                </p>
1621              </td>
1622</tr></tbody>
1623</table></div>
1624</div>
1625<div class="section">
1626<div class="titlepage"><div><div><h3 class="title">
1627<a name="boost_contract.examples.__n1962___circle__subcontracting"></a><a class="link" href="examples.html#boost_contract.examples.__n1962___circle__subcontracting" title="[N1962] Circle: Subcontracting">[N1962]
1628      Circle: Subcontracting</a>
1629</h3></div></div></div>
1630<p>
1631</p>
1632<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
1633<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
1634
1635<span class="keyword">class</span> <span class="identifier">shape</span> <span class="special">{</span>
1636<span class="keyword">public</span><span class="special">:</span>
1637    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">shape</span><span class="special">()</span> <span class="special">{}</span>
1638
1639    <span class="keyword">virtual</span> <span class="keyword">unsigned</span> <span class="identifier">compute_area</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
1640<span class="special">};</span>
1641
1642<span class="keyword">unsigned</span> <span class="identifier">shape</span><span class="special">::</span><span class="identifier">compute_area</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
1643    <span class="keyword">unsigned</span> <span class="identifier">result</span><span class="special">;</span>
1644    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
1645        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">(</span><span class="keyword">int</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1646            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&gt;</span> <span class="number">0</span><span class="special">);</span>
1647        <span class="special">})</span>
1648    <span class="special">;</span>
1649    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
1650    <span class="keyword">return</span> <span class="identifier">result</span><span class="special">;</span>
1651<span class="special">}</span>
1652
1653<span class="keyword">class</span> <span class="identifier">circle</span>
1654    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">public</span> <span class="identifier">shape</span>
1655    <span class="special">:</span> <span class="identifier">BASES</span>
1656<span class="special">{</span>
1657    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
1658
1659    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
1660    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
1661
1662    <span class="identifier">BOOST_CONTRACT_OVERRIDE</span><span class="special">(</span><span class="identifier">compute_area</span><span class="special">);</span>
1663
1664<span class="keyword">public</span><span class="special">:</span>
1665    <span class="keyword">static</span> <span class="keyword">int</span> <span class="keyword">const</span> <span class="identifier">pi</span> <span class="special">=</span> <span class="number">3</span><span class="special">;</span> <span class="comment">// Truncated to int from 3.14...</span>
1666
1667    <span class="keyword">explicit</span> <span class="identifier">circle</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="identifier">a_radius</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">radius_</span><span class="special">(</span><span class="identifier">a_radius</span><span class="special">)</span> <span class="special">{</span>
1668        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
1669            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1670                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">radius</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">a_radius</span><span class="special">);</span>
1671            <span class="special">})</span>
1672        <span class="special">;</span>
1673    <span class="special">}</span>
1674
1675    <span class="keyword">virtual</span> <span class="keyword">unsigned</span> <span class="identifier">compute_area</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="keyword">const</span>
1676            <span class="comment">/* override */</span> <span class="special">{</span>
1677        <span class="keyword">unsigned</span> <span class="identifier">result</span><span class="special">;</span>
1678        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
1679                <span class="identifier">override_compute_area</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">circle</span><span class="special">::</span><span class="identifier">compute_area</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
1680            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">(</span><span class="keyword">unsigned</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1681                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">pi</span> <span class="special">*</span> <span class="identifier">radius</span><span class="special">()</span> <span class="special">*</span> <span class="identifier">radius</span><span class="special">());</span>
1682            <span class="special">})</span>
1683        <span class="special">;</span>
1684
1685        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">pi</span> <span class="special">*</span> <span class="identifier">radius</span><span class="special">()</span> <span class="special">*</span> <span class="identifier">radius</span><span class="special">();</span>
1686    <span class="special">}</span>
1687
1688    <span class="keyword">unsigned</span> <span class="identifier">radius</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
1689        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
1690        <span class="keyword">return</span> <span class="identifier">radius_</span><span class="special">;</span>
1691    <span class="special">}</span>
1692
1693<span class="keyword">private</span><span class="special">:</span>
1694    <span class="keyword">unsigned</span> <span class="identifier">radius_</span><span class="special">;</span>
1695<span class="special">};</span>
1696
1697<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
1698    <span class="identifier">circle</span> <span class="identifier">c</span><span class="special">(</span><span class="number">2</span><span class="special">);</span>
1699    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">c</span><span class="special">.</span><span class="identifier">radius</span><span class="special">()</span> <span class="special">==</span> <span class="number">2</span><span class="special">);</span>
1700    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">c</span><span class="special">.</span><span class="identifier">compute_area</span><span class="special">()</span> <span class="special">==</span> <span class="number">12</span><span class="special">);</span>
1701    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
1702<span class="special">}</span>
1703</pre>
1704<p>
1705      </p>
1706</div>
1707<div class="section">
1708<div class="titlepage"><div><div><h3 class="title">
1709<a name="boost_contract.examples.__n1962___factorial__recursion"></a><a name="N1962_factorial_anchor"></a><a class="link" href="examples.html#boost_contract.examples.__n1962___factorial__recursion" title="[N1962] Factorial: Recursion">[N1962]
1710      Factorial: Recursion</a>
1711</h3></div></div></div>
1712<p>
1713</p>
1714<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
1715<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
1716
1717<span class="keyword">int</span> <span class="identifier">factorial</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">n</span><span class="special">)</span> <span class="special">{</span>
1718    <span class="keyword">int</span> <span class="identifier">result</span><span class="special">;</span>
1719    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
1720        <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1721            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">n</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Non-negative natural number.</span>
1722            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">n</span> <span class="special">&lt;=</span> <span class="number">12</span><span class="special">);</span> <span class="comment">// Max function input.</span>
1723        <span class="special">})</span>
1724        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1725            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&gt;=</span> <span class="number">1</span><span class="special">);</span>
1726            <span class="keyword">if</span><span class="special">(</span><span class="identifier">n</span> <span class="special">&lt;</span> <span class="number">2</span><span class="special">)</span> <span class="special">{</span> <span class="comment">// Select assertion.</span>
1727                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="number">1</span><span class="special">);</span>
1728            <span class="special">}</span> <span class="keyword">else</span> <span class="special">{</span>
1729                <span class="comment">// Assertions automatically disabled in other assertions.</span>
1730                <span class="comment">// Therefore, this postcondition can recursively call the</span>
1731                <span class="comment">// function without causing infinite recursion.</span>
1732                <span class="identifier">BOOST_CONTRACT_ASSERT_AUDIT</span><span class="special">(</span><span class="identifier">n</span> <span class="special">*</span> <span class="identifier">factorial</span><span class="special">(</span><span class="identifier">n</span> <span class="special">-</span> <span class="number">1</span><span class="special">));</span>
1733            <span class="special">}</span>
1734        <span class="special">})</span>
1735    <span class="special">;</span>
1736
1737    <span class="keyword">return</span> <span class="identifier">n</span> <span class="special">&lt;</span> <span class="number">2</span> <span class="special">?</span> <span class="special">(</span><span class="identifier">result</span> <span class="special">=</span> <span class="number">1</span><span class="special">)</span> <span class="special">:</span> <span class="special">(</span><span class="identifier">result</span> <span class="special">=</span> <span class="identifier">n</span> <span class="special">*</span> <span class="identifier">factorial</span><span class="special">(</span><span class="identifier">n</span> <span class="special">-</span> <span class="number">1</span><span class="special">));</span>
1738<span class="special">}</span>
1739
1740<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
1741    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">factorial</span><span class="special">(</span><span class="number">4</span><span class="special">)</span> <span class="special">==</span> <span class="number">24</span><span class="special">);</span>
1742    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
1743<span class="special">}</span>
1744</pre>
1745<p>
1746      </p>
1747</div>
1748<div class="section">
1749<div class="titlepage"><div><div><h3 class="title">
1750<a name="boost_contract.examples.__n1962___equal__operators"></a><a class="link" href="examples.html#boost_contract.examples.__n1962___equal__operators" title="[N1962] Equal: Operators">[N1962]
1751      Equal: Operators</a>
1752</h3></div></div></div>
1753<p>
1754</p>
1755<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
1756<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
1757
1758<span class="comment">// Forward declaration because == and != contracts use one another's function.</span>
1759<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
1760<span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">==(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">left</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">right</span><span class="special">);</span>
1761
1762<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
1763<span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">!=(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">left</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">right</span><span class="special">)</span> <span class="special">{</span>
1764    <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
1765    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
1766        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1767            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="special">!(</span><span class="identifier">left</span> <span class="special">==</span> <span class="identifier">right</span><span class="special">));</span>
1768        <span class="special">})</span>
1769    <span class="special">;</span>
1770
1771    <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">left</span><span class="special">.</span><span class="identifier">value</span> <span class="special">!=</span> <span class="identifier">right</span><span class="special">.</span><span class="identifier">value</span><span class="special">);</span>
1772<span class="special">}</span>
1773
1774<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
1775<span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">==(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">left</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">right</span><span class="special">)</span> <span class="special">{</span>
1776    <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
1777    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
1778        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1779            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="special">!(</span><span class="identifier">left</span> <span class="special">!=</span> <span class="identifier">right</span><span class="special">));</span>
1780        <span class="special">})</span>
1781    <span class="special">;</span>
1782
1783    <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">left</span><span class="special">.</span><span class="identifier">value</span> <span class="special">==</span> <span class="identifier">right</span><span class="special">.</span><span class="identifier">value</span><span class="special">);</span>
1784<span class="special">}</span>
1785
1786<span class="keyword">struct</span> <span class="identifier">number</span> <span class="special">{</span> <span class="keyword">int</span> <span class="identifier">value</span><span class="special">;</span> <span class="special">};</span>
1787
1788<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
1789    <span class="identifier">number</span> <span class="identifier">n</span><span class="special">;</span>
1790    <span class="identifier">n</span><span class="special">.</span><span class="identifier">value</span> <span class="special">=</span> <span class="number">123</span><span class="special">;</span>
1791
1792    <span class="identifier">assert</span><span class="special">((</span><span class="identifier">n</span> <span class="special">==</span> <span class="identifier">n</span><span class="special">)</span> <span class="special">==</span> <span class="keyword">true</span><span class="special">);</span>   <span class="comment">// Explicitly call operator==.</span>
1793    <span class="identifier">assert</span><span class="special">((</span><span class="identifier">n</span> <span class="special">!=</span> <span class="identifier">n</span><span class="special">)</span> <span class="special">==</span> <span class="keyword">false</span><span class="special">);</span>  <span class="comment">// Explicitly call operator!=.</span>
1794
1795    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
1796<span class="special">}</span>
1797</pre>
1798<p>
1799      </p>
1800</div>
1801<div class="section">
1802<div class="titlepage"><div><div><h3 class="title">
1803<a name="boost_contract.examples.__n1962___sum__array_parameter"></a><a class="link" href="examples.html#boost_contract.examples.__n1962___sum__array_parameter" title="[N1962] Sum: Array parameter">[N1962]
1804      Sum: Array parameter</a>
1805</h3></div></div></div>
1806<p>
1807</p>
1808<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
1809<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
1810
1811<span class="keyword">int</span> <span class="identifier">sum</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">count</span><span class="special">,</span> <span class="keyword">int</span><span class="special">*</span> <span class="identifier">array</span><span class="special">)</span> <span class="special">{</span>
1812    <span class="keyword">int</span> <span class="identifier">result</span><span class="special">;</span>
1813    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
1814        <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1815            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span> <span class="special">%</span> <span class="number">4</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
1816        <span class="special">})</span>
1817    <span class="special">;</span>
1818
1819    <span class="identifier">result</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
1820    <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">count</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="identifier">result</span> <span class="special">+=</span> <span class="identifier">array</span><span class="special">[</span><span class="identifier">i</span><span class="special">];</span>
1821    <span class="keyword">return</span> <span class="identifier">result</span><span class="special">;</span>
1822<span class="special">}</span>
1823
1824<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
1825    <span class="keyword">int</span> <span class="identifier">a</span><span class="special">[</span><span class="number">4</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>
1826    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">sum</span><span class="special">(</span><span class="number">4</span><span class="special">,</span> <span class="identifier">a</span><span class="special">)</span> <span class="special">==</span> <span class="number">10</span><span class="special">);</span>
1827    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
1828<span class="special">}</span>
1829</pre>
1830<p>
1831      </p>
1832</div>
1833<div class="section">
1834<div class="titlepage"><div><div><h3 class="title">
1835<a name="boost_contract.examples.__n1962___square_root__default_parameters_and_comparison_with_d_syntax"></a><a name="N1962_square_root_anchor"></a><a class="link" href="examples.html#boost_contract.examples.__n1962___square_root__default_parameters_and_comparison_with_d_syntax" title="[N1962] Square Root: Default parameters and comparison with D syntax">[N1962]
1836      Square Root: Default parameters and comparison with D syntax</a>
1837</h3></div></div></div>
1838<div class="informaltable"><table class="table">
1839<colgroup>
1840<col>
1841<col>
1842</colgroup>
1843<thead><tr>
1844<th>
1845                <p>
1846                  This Library
1847                </p>
1848              </th>
1849<th>
1850                <p>
1851                  The D Programming Language
1852                </p>
1853              </th>
1854</tr></thead>
1855<tbody><tr>
1856<td>
1857                <p>
1858</p>
1859<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
1860<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cmath</span><span class="special">&gt;</span>
1861<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
1862
1863<span class="keyword">long</span> <span class="identifier">lsqrt</span><span class="special">(</span><span class="keyword">long</span> <span class="identifier">x</span><span class="special">)</span> <span class="special">{</span>
1864    <span class="keyword">long</span> <span class="identifier">result</span><span class="special">;</span>
1865    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
1866        <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1867            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">x</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
1868        <span class="special">})</span>
1869        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1870            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">*</span> <span class="identifier">result</span> <span class="special">&lt;=</span> <span class="identifier">x</span><span class="special">);</span>
1871            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">((</span><span class="identifier">result</span> <span class="special">+</span> <span class="number">1</span><span class="special">)</span> <span class="special">*</span> <span class="special">(</span><span class="identifier">result</span> <span class="special">+</span> <span class="number">1</span><span class="special">)</span> <span class="special">&gt;</span> <span class="identifier">x</span><span class="special">);</span>
1872        <span class="special">})</span>
1873    <span class="special">;</span>
1874
1875    <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="keyword">long</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">sqrt</span><span class="special">(</span><span class="keyword">double</span><span class="special">(</span><span class="identifier">x</span><span class="special">)));</span>
1876<span class="special">}</span>
1877
1878<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
1879    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">lsqrt</span><span class="special">(</span><span class="number">4</span><span class="special">)</span> <span class="special">==</span> <span class="number">2</span><span class="special">);</span>
1880    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
1881<span class="special">}</span>
1882</pre>
1883<p>
1884                </p>
1885              </td>
1886<td>
1887                <p>
1888</p>
1889<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="comment">// Extra spaces, newlines, etc. for visual alignment with this library code.</span>
1890
1891
1892
1893<span class="keyword">long</span> <span class="identifier">lsqrt</span><span class="special">(</span><span class="keyword">long</span> <span class="identifier">x</span><span class="special">)</span>
1894<span class="identifier">in</span> <span class="special">{</span>
1895    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">x</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
1896<span class="special">}</span>
1897<span class="identifier">out</span><span class="special">(</span><span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
1898    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">result</span> <span class="special">*</span> <span class="identifier">result</span> <span class="special">&lt;=</span> <span class="identifier">x</span><span class="special">);</span>
1899    <span class="identifier">assert</span><span class="special">((</span><span class="identifier">result</span> <span class="special">+</span> <span class="number">1</span><span class="special">)</span> <span class="special">*</span> <span class="special">(</span><span class="identifier">result</span> <span class="special">+</span> <span class="number">1</span><span class="special">)</span> <span class="special">&gt;</span> <span class="identifier">x</span><span class="special">);</span>
1900<span class="special">}</span>
1901<span class="keyword">do</span> <span class="special">{</span>
1902    <span class="keyword">return</span> <span class="identifier">cast</span><span class="special">(</span><span class="keyword">long</span><span class="special">)</span><span class="identifier">std</span><span class="special">.</span><span class="identifier">math</span><span class="special">.</span><span class="identifier">sqrt</span><span class="special">(</span><span class="identifier">cast</span><span class="special">(</span><span class="identifier">real</span><span class="special">)</span><span class="identifier">x</span><span class="special">);</span>
1903<span class="special">}</span>
1904
1905
1906
1907
1908
1909
1910
1911
1912<span class="comment">// End.</span>
1913</pre>
1914<p>
1915                </p>
1916              </td>
1917</tr></tbody>
1918</table></div>
1919</div>
1920<div class="section">
1921<div class="titlepage"><div><div><h3 class="title">
1922<a name="boost_contract.examples.__meyer97___stack4__comparison_with_eiffel_syntax"></a><a name="Meyer97_stack4_anchor"></a><a class="link" href="examples.html#boost_contract.examples.__meyer97___stack4__comparison_with_eiffel_syntax" title="[Meyer97] Stack4: Comparison with Eiffel syntax">[Meyer97]
1923      Stack4: Comparison with Eiffel syntax</a>
1924</h3></div></div></div>
1925<div class="informaltable"><table class="table">
1926<colgroup>
1927<col>
1928<col>
1929</colgroup>
1930<thead><tr>
1931<th>
1932                <p>
1933                  This Library
1934                </p>
1935              </th>
1936<th>
1937                <p>
1938                  The Eiffel Programming Language
1939                </p>
1940              </th>
1941</tr></thead>
1942<tbody>
1943<tr>
1944<td>
1945                <p>
1946</p>
1947<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="comment">// File: stack4.hpp</span>
1948<span class="preprocessor">#ifndef</span> <span class="identifier">STACK4_HPP_</span>
1949<span class="preprocessor">#define</span> <span class="identifier">STACK4_HPP_</span>
1950
1951<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
1952
1953<span class="comment">// Dispenser with LIFO access policy and fixed max capacity.</span>
1954<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
1955<span class="keyword">class</span> <span class="identifier">stack4</span>
1956    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">private</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">stack4</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span>
1957    <span class="special">:</span> <span class="identifier">BASES</span>
1958<span class="special">{</span>
1959    <span class="keyword">friend</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
1960    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
1961    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
1962
1963    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
1964        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Count non-negative.</span>
1965        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&lt;=</span> <span class="identifier">capacity</span><span class="special">());</span> <span class="comment">// Count bounded.</span>
1966        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">()</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span> <span class="comment">// Empty if no elem.</span>
1967    <span class="special">}</span>
1968
1969<span class="keyword">public</span><span class="special">:</span>
1970    <span class="comment">/* Initialization */</span>
1971
1972    <span class="comment">// Allocate static from a maximum of n elements.</span>
1973    <span class="keyword">explicit</span> <span class="identifier">stack4</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">n</span><span class="special">)</span> <span class="special">:</span>
1974        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">stack4</span><span class="special">&gt;([&amp;]</span> <span class="special">{</span>
1975            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">n</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Non-negative capacity.</span>
1976        <span class="special">})</span>
1977    <span class="special">{</span>
1978        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
1979            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1980                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">n</span><span class="special">);</span> <span class="comment">// Capacity set.</span>
1981            <span class="special">})</span>
1982        <span class="special">;</span>
1983
1984        <span class="identifier">capacity_</span> <span class="special">=</span> <span class="identifier">n</span><span class="special">;</span>
1985        <span class="identifier">count_</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
1986        <span class="identifier">array_</span> <span class="special">=</span> <span class="keyword">new</span> <span class="identifier">T</span><span class="special">[</span><span class="identifier">n</span><span class="special">];</span>
1987    <span class="special">}</span>
1988
1989    <span class="comment">// Deep copy via constructor.</span>
1990    <span class="comment">/* implicit */</span> <span class="identifier">stack4</span><span class="special">(</span><span class="identifier">stack4</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">other</span><span class="special">)</span> <span class="special">{</span>
1991        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
1992            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
1993                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">());</span>
1994                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">count</span><span class="special">());</span>
1995                <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(*</span><span class="keyword">this</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">);</span>
1996            <span class="special">})</span>
1997        <span class="special">;</span>
1998
1999        <span class="identifier">capacity_</span> <span class="special">=</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">capacity_</span><span class="special">;</span>
2000        <span class="identifier">count_</span> <span class="special">=</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">count_</span><span class="special">;</span>
2001        <span class="identifier">array_</span> <span class="special">=</span> <span class="keyword">new</span> <span class="identifier">T</span><span class="special">[</span><span class="identifier">other</span><span class="special">.</span><span class="identifier">capacity_</span><span class="special">];</span>
2002        <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">count_</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="identifier">array_</span><span class="special">[</span><span class="identifier">i</span><span class="special">]</span> <span class="special">=</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">array_</span><span class="special">[</span><span class="identifier">i</span><span class="special">];</span>
2003    <span class="special">}</span>
2004
2005    <span class="comment">// Deep copy via assignment.</span>
2006    <span class="identifier">stack4</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">=(</span><span class="identifier">stack4</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">other</span><span class="special">)</span> <span class="special">{</span>
2007        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2008            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2009                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">());</span>
2010                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">count</span><span class="special">());</span>
2011                <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(*</span><span class="keyword">this</span> <span class="special">==</span> <span class="identifier">other</span><span class="special">);</span>
2012            <span class="special">})</span>
2013        <span class="special">;</span>
2014
2015        <span class="keyword">delete</span><span class="special">[]</span> <span class="identifier">array_</span><span class="special">;</span>
2016        <span class="identifier">capacity_</span> <span class="special">=</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">capacity_</span><span class="special">;</span>
2017        <span class="identifier">count_</span> <span class="special">=</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">count_</span><span class="special">;</span>
2018        <span class="identifier">array_</span> <span class="special">=</span> <span class="keyword">new</span> <span class="identifier">T</span><span class="special">[</span><span class="identifier">other</span><span class="special">.</span><span class="identifier">capacity_</span><span class="special">];</span>
2019        <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">count_</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="identifier">array_</span><span class="special">[</span><span class="identifier">i</span><span class="special">]</span> <span class="special">=</span> <span class="identifier">other</span><span class="special">.</span><span class="identifier">array_</span><span class="special">[</span><span class="identifier">i</span><span class="special">];</span>
2020        <span class="keyword">return</span> <span class="special">*</span><span class="keyword">this</span><span class="special">;</span>
2021    <span class="special">}</span>
2022
2023    <span class="comment">// Destroy this stack.</span>
2024    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">stack4</span><span class="special">()</span> <span class="special">{</span>
2025        <span class="comment">// Check invariants.</span>
2026        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2027        <span class="keyword">delete</span><span class="special">[]</span> <span class="identifier">array_</span><span class="special">;</span>
2028    <span class="special">}</span>
2029
2030    <span class="comment">/* Access */</span>
2031
2032    <span class="comment">// Max number of stack elements.</span>
2033    <span class="keyword">int</span> <span class="identifier">capacity</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2034        <span class="comment">// Check invariants.</span>
2035        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2036        <span class="keyword">return</span> <span class="identifier">capacity_</span><span class="special">;</span>
2037    <span class="special">}</span>
2038
2039    <span class="comment">// Number of stack elements.</span>
2040    <span class="keyword">int</span> <span class="identifier">count</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2041        <span class="comment">// Check invariants.</span>
2042        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2043        <span class="keyword">return</span> <span class="identifier">count_</span><span class="special">;</span>
2044    <span class="special">}</span>
2045
2046    <span class="comment">// Top element.</span>
2047    <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">item</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2048        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2049            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2050                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span> <span class="comment">// Not empty (i.e., count &gt; 0).</span>
2051            <span class="special">})</span>
2052        <span class="special">;</span>
2053
2054        <span class="keyword">return</span> <span class="identifier">array_</span><span class="special">[</span><span class="identifier">count_</span> <span class="special">-</span> <span class="number">1</span><span class="special">];</span>
2055    <span class="special">}</span>
2056
2057    <span class="comment">/* Status Report */</span>
2058
2059    <span class="comment">// Is stack empty?</span>
2060    <span class="keyword">bool</span> <span class="identifier">empty</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2061        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
2062        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2063            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2064                <span class="comment">// Empty definition.</span>
2065                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span>
2066            <span class="special">})</span>
2067        <span class="special">;</span>
2068
2069        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">count_</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
2070    <span class="special">}</span>
2071
2072    <span class="comment">// Is stack full?</span>
2073    <span class="keyword">bool</span> <span class="identifier">full</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2074        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
2075        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2076            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2077                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span> <span class="comment">// Full definition.</span>
2078                        <span class="identifier">result</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">capacity</span><span class="special">()));</span>
2079            <span class="special">})</span>
2080        <span class="special">;</span>
2081
2082        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">count_</span> <span class="special">==</span> <span class="identifier">capacity_</span><span class="special">);</span>
2083    <span class="special">}</span>
2084
2085    <span class="comment">/* Element Change */</span>
2086
2087    <span class="comment">// Add x on top.</span>
2088    <span class="keyword">void</span> <span class="identifier">put</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">x</span><span class="special">)</span> <span class="special">{</span>
2089        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
2090        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2091            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2092                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">full</span><span class="special">());</span> <span class="comment">// Not full.</span>
2093            <span class="special">})</span>
2094            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2095                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span> <span class="comment">// Not empty.</span>
2096                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">item</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">x</span><span class="special">);</span> <span class="comment">// Added to top.</span>
2097                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// One more.</span>
2098            <span class="special">})</span>
2099        <span class="special">;</span>
2100
2101        <span class="identifier">array_</span><span class="special">[</span><span class="identifier">count_</span><span class="special">++]</span> <span class="special">=</span> <span class="identifier">x</span><span class="special">;</span>
2102    <span class="special">}</span>
2103
2104    <span class="comment">// Remove top element.</span>
2105    <span class="keyword">void</span> <span class="identifier">remove</span><span class="special">()</span> <span class="special">{</span>
2106        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
2107        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2108            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2109                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span> <span class="comment">// Not empty (i.e., count &gt; 0).</span>
2110            <span class="special">})</span>
2111            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2112                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">full</span><span class="special">());</span> <span class="comment">// Not full.</span>
2113                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// One less.</span>
2114            <span class="special">})</span>
2115        <span class="special">;</span>
2116
2117        <span class="special">--</span><span class="identifier">count_</span><span class="special">;</span>
2118    <span class="special">}</span>
2119
2120    <span class="comment">/* Friend Helpers */</span>
2121
2122    <span class="keyword">friend</span> <span class="keyword">bool</span> <span class="keyword">operator</span><span class="special">==(</span><span class="identifier">stack4</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">left</span><span class="special">,</span> <span class="identifier">stack4</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">right</span><span class="special">)</span> <span class="special">{</span>
2123        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">inv1</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(&amp;</span><span class="identifier">left</span><span class="special">);</span>
2124        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">inv2</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(&amp;</span><span class="identifier">right</span><span class="special">);</span>
2125        <span class="keyword">if</span><span class="special">(</span><span class="identifier">left</span><span class="special">.</span><span class="identifier">count_</span> <span class="special">!=</span> <span class="identifier">right</span><span class="special">.</span><span class="identifier">count_</span><span class="special">)</span> <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
2126        <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">left</span><span class="special">.</span><span class="identifier">count_</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="special">{</span>
2127            <span class="keyword">if</span><span class="special">(</span><span class="identifier">left</span><span class="special">.</span><span class="identifier">array_</span><span class="special">[</span><span class="identifier">i</span><span class="special">]</span> <span class="special">!=</span> <span class="identifier">right</span><span class="special">.</span><span class="identifier">array_</span><span class="special">[</span><span class="identifier">i</span><span class="special">])</span> <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
2128        <span class="special">}</span>
2129        <span class="keyword">return</span> <span class="keyword">true</span><span class="special">;</span>
2130    <span class="special">}</span>
2131
2132<span class="keyword">private</span><span class="special">:</span>
2133    <span class="keyword">int</span> <span class="identifier">capacity_</span><span class="special">;</span>
2134    <span class="keyword">int</span> <span class="identifier">count_</span><span class="special">;</span>
2135    <span class="identifier">T</span><span class="special">*</span> <span class="identifier">array_</span><span class="special">;</span> <span class="comment">// Internally use C-style array.</span>
2136<span class="special">};</span>
2137
2138<span class="preprocessor">#endif</span> <span class="comment">// #include guard</span>
2139</pre>
2140<p>
2141                </p>
2142              </td>
2143<td>
2144                <p>
2145</p>
2146<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="special">--</span> <span class="identifier">Extra</span> <span class="identifier">spaces</span><span class="special">,</span> <span class="identifier">newlines</span><span class="special">,</span> <span class="identifier">etc</span><span class="special">.</span> <span class="keyword">for</span> <span class="identifier">visual</span> <span class="identifier">alignment</span> <span class="identifier">with</span> <span class="keyword">this</span> <span class="identifier">library</span> <span class="identifier">code</span><span class="special">.</span>
2147
2148
2149
2150
2151
2152<span class="identifier">indexing</span>
2153    <span class="identifier">destription</span><span class="special">:</span> <span class="string">"Dispenser with LIFO access policy and a fixed max capacity."</span>
2154<span class="keyword">class</span> <span class="identifier">interface</span> <span class="identifier">STACK4</span><span class="special">[</span><span class="identifier">G</span><span class="special">]</span> <span class="identifier">creation</span> <span class="identifier">make</span> <span class="special">--</span> <span class="identifier">Interface</span> <span class="identifier">only</span> <span class="special">(</span><span class="identifier">no</span> <span class="identifier">implementation</span><span class="special">).</span>
2155
2156
2157
2158
2159
2160
2161
2162<span class="identifier">invariant</span>
2163    <span class="identifier">count_non_negative</span><span class="special">:</span> <span class="identifier">count</span> <span class="special">&gt;=</span> <span class="number">0</span>
2164    <span class="identifier">count_bounded</span><span class="special">:</span> <span class="identifier">count</span> <span class="special">&lt;=</span> <span class="identifier">capacity</span>
2165    <span class="identifier">empty_if_no_elements</span><span class="special">:</span> <span class="identifier">empty</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">count</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
2166
2167
2168
2169<span class="identifier">feature</span> <span class="special">--</span> <span class="identifier">Initialization</span>
2170
2171    <span class="special">--</span> <span class="identifier">Allocate</span> <span class="identifier">stack</span> <span class="keyword">for</span> <span class="identifier">a</span> <span class="identifier">maximum</span> <span class="identifier">of</span> <span class="identifier">n</span> <span class="identifier">elements</span><span class="special">.</span>
2172    <span class="identifier">make</span><span class="special">(</span><span class="identifier">n</span><span class="special">:</span> <span class="identifier">INTEGER</span><span class="special">)</span> <span class="identifier">is</span>
2173        <span class="identifier">require</span>
2174            <span class="identifier">non_negative_capacity</span><span class="special">:</span> <span class="identifier">n</span> <span class="special">&gt;=</span> <span class="number">0</span>
2175        <span class="identifier">ensure</span>
2176            <span class="identifier">capacity_set</span><span class="special">:</span> <span class="identifier">capacity</span> <span class="special">=</span> <span class="identifier">n</span>
2177        <span class="identifier">end</span>
2178
2179
2180
2181
2182
2183
2184
2185
2186
2187
2188
2189
2190
2191
2192
2193
2194
2195
2196
2197
2198
2199
2200
2201
2202
2203
2204
2205
2206
2207
2208
2209
2210
2211
2212
2213
2214
2215
2216
2217
2218
2219
2220
2221
2222
2223
2224
2225
2226
2227
2228
2229<span class="identifier">feature</span> <span class="special">--</span> <span class="identifier">Access</span>
2230
2231    <span class="special">--</span> <span class="identifier">Max</span> <span class="identifier">number</span> <span class="identifier">of</span> <span class="identifier">stack</span> <span class="identifier">elements</span><span class="special">.</span>
2232    <span class="identifier">capacity</span><span class="special">:</span> <span class="identifier">INTEGER</span>
2233
2234
2235
2236
2237
2238    <span class="special">--</span> <span class="identifier">Number</span> <span class="identifier">of</span> <span class="identifier">stack</span> <span class="identifier">elements</span><span class="special">.</span>
2239    <span class="identifier">count</span><span class="special">:</span> <span class="identifier">INTEGER</span>
2240
2241
2242
2243
2244
2245    <span class="special">--</span> <span class="identifier">Top</span> <span class="identifier">element</span><span class="special">.</span>
2246    <span class="identifier">item</span><span class="special">:</span> <span class="identifier">G</span> <span class="identifier">is</span>
2247        <span class="identifier">require</span>
2248            <span class="identifier">not_empty</span><span class="special">:</span> <span class="keyword">not</span> <span class="identifier">empty</span> <span class="special">--</span> <span class="identifier">i</span><span class="special">.</span><span class="identifier">e</span><span class="special">.,</span> <span class="identifier">count</span> <span class="special">&gt;</span> <span class="number">0</span>
2249        <span class="identifier">end</span>
2250
2251
2252
2253
2254
2255
2256<span class="identifier">feature</span> <span class="special">--</span> <span class="identifier">Status</span> <span class="identifier">report</span>
2257
2258    <span class="special">--</span> <span class="identifier">Is</span> <span class="identifier">stack</span> <span class="identifier">empty</span><span class="special">?</span>
2259    <span class="identifier">empty</span><span class="special">:</span> <span class="identifier">BOOLEAN</span> <span class="identifier">is</span>
2260        <span class="identifier">ensure</span>
2261            <span class="identifier">empty_definition</span><span class="special">:</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">count</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
2262        <span class="identifier">end</span>
2263
2264
2265
2266
2267
2268
2269
2270
2271    <span class="special">--</span> <span class="identifier">Is</span> <span class="identifier">stack</span> <span class="identifier">full</span><span class="special">?</span>
2272    <span class="identifier">full</span><span class="special">:</span> <span class="identifier">BOOLEAN</span> <span class="identifier">is</span>
2273        <span class="identifier">ensure</span>
2274            <span class="identifier">full_definition</span><span class="special">:</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">count</span> <span class="special">=</span> <span class="identifier">capacity</span><span class="special">)</span>
2275        <span class="identifier">end</span>
2276
2277
2278
2279
2280
2281
2282
2283
2284<span class="identifier">feature</span> <span class="special">--</span> <span class="identifier">Element</span> <span class="identifier">change</span>
2285
2286    <span class="special">--</span> <span class="identifier">Add</span> <span class="identifier">x</span> <span class="identifier">on</span> <span class="identifier">top</span><span class="special">.</span>
2287    <span class="identifier">put</span><span class="special">(</span><span class="identifier">x</span><span class="special">:</span> <span class="identifier">G</span><span class="special">)</span> <span class="identifier">is</span>
2288        <span class="identifier">require</span>
2289            <span class="identifier">not_full</span><span class="special">:</span> <span class="keyword">not</span> <span class="identifier">full</span>
2290        <span class="identifier">ensure</span>
2291            <span class="identifier">not_empty</span><span class="special">:</span> <span class="keyword">not</span> <span class="identifier">empty</span>
2292            <span class="identifier">added_to_top</span><span class="special">:</span> <span class="identifier">item</span> <span class="special">=</span> <span class="identifier">x</span>
2293            <span class="identifier">one_more_item</span><span class="special">:</span> <span class="identifier">count</span> <span class="special">=</span> <span class="identifier">old</span> <span class="identifier">count</span> <span class="special">+</span> <span class="number">1</span>
2294        <span class="identifier">end</span>
2295
2296
2297
2298
2299
2300
2301
2302
2303    <span class="special">--</span> <span class="identifier">Remove</span> <span class="identifier">top</span> <span class="identifier">element</span><span class="special">.</span>
2304    <span class="identifier">remove</span> <span class="identifier">is</span>
2305        <span class="identifier">require</span>
2306            <span class="identifier">not_empty</span><span class="special">:</span> <span class="keyword">not</span> <span class="identifier">empty</span> <span class="special">--</span> <span class="identifier">i</span><span class="special">.</span><span class="identifier">e</span><span class="special">.,</span> <span class="identifier">count</span> <span class="special">&gt;</span> <span class="number">0</span>
2307        <span class="identifier">ensure</span>
2308            <span class="identifier">not_full</span><span class="special">:</span> <span class="keyword">not</span> <span class="identifier">full</span>
2309            <span class="identifier">one_fewer_item</span><span class="special">:</span> <span class="identifier">count</span> <span class="special">=</span> <span class="identifier">old</span> <span class="identifier">count</span> <span class="special">-</span> <span class="number">1</span>
2310
2311        <span class="identifier">end</span>
2312
2313
2314
2315
2316
2317
2318
2319
2320
2321
2322
2323
2324
2325
2326
2327
2328
2329
2330
2331
2332
2333
2334
2335<span class="identifier">end</span> <span class="special">--</span> <span class="keyword">class</span> <span class="identifier">interface</span> <span class="identifier">STACK4</span>
2336
2337<span class="special">--</span> <span class="identifier">End</span><span class="special">.</span>
2338</pre>
2339<p>
2340                </p>
2341              </td>
2342</tr>
2343<tr>
2344<td>
2345                <p>
2346</p>
2347<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#include</span> <span class="string">"stack4.hpp"</span>
2348<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
2349
2350<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
2351    <span class="identifier">stack4</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">s</span><span class="special">(</span><span class="number">3</span><span class="special">);</span>
2352    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="number">3</span><span class="special">);</span>
2353    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
2354    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">empty</span><span class="special">());</span>
2355    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">full</span><span class="special">());</span>
2356
2357    <span class="identifier">s</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="number">123</span><span class="special">);</span>
2358    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">empty</span><span class="special">());</span>
2359    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">full</span><span class="special">());</span>
2360    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">item</span><span class="special">()</span> <span class="special">==</span> <span class="number">123</span><span class="special">);</span>
2361
2362    <span class="identifier">s</span><span class="special">.</span><span class="identifier">remove</span><span class="special">();</span>
2363    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">empty</span><span class="special">());</span>
2364    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">full</span><span class="special">());</span>
2365
2366    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
2367<span class="special">}</span>
2368</pre>
2369<p>
2370                </p>
2371              </td>
2372<td>
2373              </td>
2374</tr>
2375</tbody>
2376</table></div>
2377</div>
2378<div class="section">
2379<div class="titlepage"><div><div><h3 class="title">
2380<a name="boost_contract.examples.__meyer97___stack3__error_codes_instead_of_preconditions"></a><a class="link" href="examples.html#boost_contract.examples.__meyer97___stack3__error_codes_instead_of_preconditions" title="[Meyer97] Stack3: Error codes instead of preconditions">[Meyer97]
2381      Stack3: Error codes instead of preconditions</a>
2382</h3></div></div></div>
2383<p>
2384</p>
2385<pre class="programlisting"><span class="comment">// File: stack3.cpp</span>
2386<span class="preprocessor">#include</span> <span class="string">"stack4.hpp"</span>
2387<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
2388<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">optional</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
2389<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
2390
2391<span class="comment">// Dispenser LIFO with max capacity using error codes.</span>
2392<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
2393<span class="keyword">class</span> <span class="identifier">stack3</span> <span class="special">{</span>
2394    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
2395
2396    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2397        <span class="keyword">if</span><span class="special">(!</span><span class="identifier">error</span><span class="special">())</span> <span class="special">{</span>
2398            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Count non-negative.</span>
2399            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&lt;=</span> <span class="identifier">capacity</span><span class="special">());</span> <span class="comment">// Count bounded.</span>
2400            <span class="comment">// Empty if no element.</span>
2401            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">()</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span>
2402        <span class="special">}</span>
2403    <span class="special">}</span>
2404
2405<span class="keyword">public</span><span class="special">:</span>
2406    <span class="keyword">enum</span> <span class="identifier">error_code</span> <span class="special">{</span>
2407        <span class="identifier">no_error</span> <span class="special">=</span> <span class="number">0</span><span class="special">,</span>
2408        <span class="identifier">overflow_error</span><span class="special">,</span>
2409        <span class="identifier">underflow_error</span><span class="special">,</span>
2410        <span class="identifier">size_error</span>
2411    <span class="special">};</span>
2412
2413    <span class="comment">/* Initialization */</span>
2414
2415    <span class="comment">// Create stack for max of n elems, if n &lt; 0 set error (no preconditions).</span>
2416    <span class="keyword">explicit</span> <span class="identifier">stack3</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">n</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">default_value</span> <span class="special">=</span> <span class="identifier">T</span><span class="special">())</span> <span class="special">:</span>
2417            <span class="identifier">stack_</span><span class="special">(</span><span class="number">0</span><span class="special">),</span> <span class="identifier">error_</span><span class="special">(</span><span class="identifier">no_error</span><span class="special">)</span> <span class="special">{</span>
2418        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2419            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2420                <span class="comment">// Error if impossible.</span>
2421                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">((</span><span class="identifier">n</span> <span class="special">&lt;</span> <span class="number">0</span><span class="special">)</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">error</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">size_error</span><span class="special">));</span>
2422                <span class="comment">// No error if possible.</span>
2423                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">((</span><span class="identifier">n</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">)</span> <span class="special">==</span> <span class="special">!</span><span class="identifier">error</span><span class="special">());</span>
2424                <span class="comment">// Created if no error.</span>
2425                <span class="keyword">if</span><span class="special">(!</span><span class="identifier">error</span><span class="special">())</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">n</span><span class="special">);</span>
2426            <span class="special">})</span>
2427        <span class="special">;</span>
2428
2429        <span class="keyword">if</span><span class="special">(</span><span class="identifier">n</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">)</span> <span class="identifier">stack_</span> <span class="special">=</span> <span class="identifier">stack4</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;(</span><span class="identifier">n</span><span class="special">);</span>
2430        <span class="keyword">else</span> <span class="identifier">error_</span> <span class="special">=</span> <span class="identifier">size_error</span><span class="special">;</span>
2431    <span class="special">}</span>
2432
2433    <span class="comment">/* Access */</span>
2434
2435    <span class="comment">// Max number of stack elements.</span>
2436    <span class="keyword">int</span> <span class="identifier">capacity</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2437        <span class="comment">// Check invariants.</span>
2438        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2439        <span class="keyword">return</span> <span class="identifier">stack_</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">();</span>
2440    <span class="special">}</span>
2441
2442    <span class="comment">// Number of stack elements.</span>
2443    <span class="keyword">int</span> <span class="identifier">count</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2444        <span class="comment">// Check invariants.</span>
2445        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2446        <span class="keyword">return</span> <span class="identifier">stack_</span><span class="special">.</span><span class="identifier">count</span><span class="special">();</span>
2447    <span class="special">}</span>
2448
2449    <span class="comment">// Top element if present, otherwise none and set error (no preconditions).</span>
2450    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;</span> <span class="identifier">item</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2451        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2452            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2453                <span class="comment">// Error if impossible.</span>
2454                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">()</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">error</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">underflow_error</span><span class="special">));</span>
2455                <span class="comment">// No error if possible.</span>
2456                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">()</span> <span class="special">==</span> <span class="special">!</span><span class="identifier">error</span><span class="special">());</span>
2457            <span class="special">})</span>
2458        <span class="special">;</span>
2459
2460        <span class="keyword">if</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">())</span> <span class="special">{</span>
2461            <span class="identifier">error_</span> <span class="special">=</span> <span class="identifier">no_error</span><span class="special">;</span>
2462            <span class="keyword">return</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;(</span><span class="identifier">stack_</span><span class="special">.</span><span class="identifier">item</span><span class="special">());</span>
2463        <span class="special">}</span> <span class="keyword">else</span> <span class="special">{</span>
2464            <span class="identifier">error_</span> <span class="special">=</span> <span class="identifier">underflow_error</span><span class="special">;</span>
2465            <span class="keyword">return</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;();</span>
2466        <span class="special">}</span>
2467    <span class="special">}</span>
2468
2469    <span class="comment">/* Status Report */</span>
2470
2471    <span class="comment">// Error indicator set by various operations.</span>
2472    <span class="identifier">error_code</span> <span class="identifier">error</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2473        <span class="comment">// Check invariants.</span>
2474        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2475        <span class="keyword">return</span> <span class="identifier">error_</span><span class="special">;</span>
2476    <span class="special">}</span>
2477
2478    <span class="keyword">bool</span> <span class="identifier">empty</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2479        <span class="comment">// Check invariants.</span>
2480        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2481        <span class="keyword">return</span> <span class="identifier">stack_</span><span class="special">.</span><span class="identifier">empty</span><span class="special">();</span>
2482    <span class="special">}</span>
2483
2484    <span class="keyword">bool</span> <span class="identifier">full</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2485        <span class="comment">// Check invariants.</span>
2486        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2487        <span class="keyword">return</span> <span class="identifier">stack_</span><span class="special">.</span><span class="identifier">full</span><span class="special">();</span>
2488    <span class="special">}</span>
2489
2490    <span class="comment">/* Element Change */</span>
2491
2492    <span class="comment">// Add x to top if capacity allows, otherwise set error (no preconditions).</span>
2493    <span class="keyword">void</span> <span class="identifier">put</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">x</span><span class="special">)</span> <span class="special">{</span>
2494        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">bool</span><span class="special">&gt;</span> <span class="identifier">old_full</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">full</span><span class="special">());</span>
2495        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
2496        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2497            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2498                <span class="comment">// Error if impossible.</span>
2499                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(*</span><span class="identifier">old_full</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">error</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">overflow_error</span><span class="special">));</span>
2500                <span class="comment">// No error if possible.</span>
2501                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!*</span><span class="identifier">old_full</span> <span class="special">==</span> <span class="special">!</span><span class="identifier">error</span><span class="special">());</span>
2502                <span class="keyword">if</span><span class="special">(!</span><span class="identifier">error</span><span class="special">())</span> <span class="special">{</span> <span class="comment">// If no error...</span>
2503                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span> <span class="comment">// ...not empty.</span>
2504                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(*</span><span class="identifier">item</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">x</span><span class="special">);</span> <span class="comment">// ...added to top.</span>
2505                    <span class="comment">// ...one more.</span>
2506                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span>
2507                <span class="special">}</span>
2508            <span class="special">})</span>
2509        <span class="special">;</span>
2510
2511        <span class="keyword">if</span><span class="special">(</span><span class="identifier">full</span><span class="special">())</span> <span class="identifier">error_</span> <span class="special">=</span> <span class="identifier">overflow_error</span><span class="special">;</span>
2512        <span class="keyword">else</span> <span class="special">{</span>
2513            <span class="identifier">stack_</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="identifier">x</span><span class="special">);</span>
2514            <span class="identifier">error_</span> <span class="special">=</span> <span class="identifier">no_error</span><span class="special">;</span>
2515        <span class="special">}</span>
2516    <span class="special">}</span>
2517
2518    <span class="comment">// Remove top element if possible, otherwise set error (no preconditions).</span>
2519    <span class="keyword">void</span> <span class="identifier">remove</span><span class="special">()</span> <span class="special">{</span>
2520        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">bool</span><span class="special">&gt;</span> <span class="identifier">old_empty</span> <span class="special">=</span>
2521                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">empty</span><span class="special">());</span>
2522        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
2523        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2524            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2525                <span class="comment">// Error if impossible.</span>
2526                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(*</span><span class="identifier">old_empty</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">error</span><span class="special">()</span> <span class="special">==</span>
2527                        <span class="identifier">underflow_error</span><span class="special">));</span>
2528                <span class="comment">// No error if possible.</span>
2529                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!*</span><span class="identifier">old_empty</span> <span class="special">==</span> <span class="special">!</span><span class="identifier">error</span><span class="special">());</span>
2530                <span class="keyword">if</span><span class="special">(!</span><span class="identifier">error</span><span class="special">())</span> <span class="special">{</span> <span class="comment">// If no error...</span>
2531                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">full</span><span class="special">());</span> <span class="comment">// ...not full.</span>
2532                    <span class="comment">// ...one less.</span>
2533                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span>
2534                <span class="special">}</span>
2535            <span class="special">})</span>
2536        <span class="special">;</span>
2537
2538        <span class="keyword">if</span><span class="special">(</span><span class="identifier">empty</span><span class="special">())</span> <span class="identifier">error_</span> <span class="special">=</span> <span class="identifier">underflow_error</span><span class="special">;</span>
2539        <span class="keyword">else</span> <span class="special">{</span>
2540            <span class="identifier">stack_</span><span class="special">.</span><span class="identifier">remove</span><span class="special">();</span>
2541            <span class="identifier">error_</span> <span class="special">=</span> <span class="identifier">no_error</span><span class="special">;</span>
2542        <span class="special">}</span>
2543    <span class="special">}</span>
2544
2545<span class="keyword">private</span><span class="special">:</span>
2546    <span class="identifier">stack4</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="identifier">stack_</span><span class="special">;</span>
2547    <span class="keyword">mutable</span> <span class="identifier">error_code</span> <span class="identifier">error_</span><span class="special">;</span>
2548<span class="special">};</span>
2549
2550<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
2551    <span class="identifier">stack3</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">s</span><span class="special">(</span><span class="number">3</span><span class="special">);</span>
2552    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="number">3</span><span class="special">);</span>
2553    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
2554    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">empty</span><span class="special">());</span>
2555    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">full</span><span class="special">());</span>
2556
2557    <span class="identifier">s</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="number">123</span><span class="special">);</span>
2558    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">empty</span><span class="special">());</span>
2559    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">full</span><span class="special">());</span>
2560    <span class="identifier">assert</span><span class="special">(*</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">item</span><span class="special">()</span> <span class="special">==</span> <span class="number">123</span><span class="special">);</span>
2561
2562    <span class="identifier">s</span><span class="special">.</span><span class="identifier">remove</span><span class="special">();</span>
2563    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">empty</span><span class="special">());</span>
2564    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">full</span><span class="special">());</span>
2565
2566    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
2567<span class="special">}</span>
2568</pre>
2569<p>
2570      </p>
2571</div>
2572<div class="section">
2573<div class="titlepage"><div><div><h3 class="title">
2574<a name="boost_contract.examples.__mitchell02___name_list__relaxed_subcontracts"></a><a class="link" href="examples.html#boost_contract.examples.__mitchell02___name_list__relaxed_subcontracts" title="[Mitchell02] Name List: Relaxed subcontracts">[Mitchell02]
2575      Name List: Relaxed subcontracts</a>
2576</h3></div></div></div>
2577<p>
2578</p>
2579<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
2580<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">string</span><span class="special">&gt;</span>
2581<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&gt;</span>
2582<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">algorithm</span><span class="special">&gt;</span>
2583<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
2584
2585<span class="comment">// List of names.</span>
2586<span class="keyword">class</span> <span class="identifier">name_list</span> <span class="special">{</span>
2587    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
2588
2589    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2590        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Non-negative count.</span>
2591    <span class="special">}</span>
2592
2593<span class="keyword">public</span><span class="special">:</span>
2594    <span class="comment">/* Creation */</span>
2595
2596    <span class="comment">// Create an empty list.</span>
2597    <span class="identifier">name_list</span><span class="special">()</span> <span class="special">{</span>
2598        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2599            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2600                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Empty list.</span>
2601            <span class="special">})</span>
2602        <span class="special">;</span>
2603    <span class="special">}</span>
2604
2605    <span class="comment">// Destroy list.</span>
2606    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">name_list</span><span class="special">()</span> <span class="special">{</span>
2607        <span class="comment">// Check invariants.</span>
2608        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2609    <span class="special">}</span>
2610
2611    <span class="comment">/* Basic Queries */</span>
2612
2613    <span class="comment">// Number of names in list.</span>
2614    <span class="keyword">int</span> <span class="identifier">count</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2615        <span class="comment">// Check invariants.</span>
2616        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2617        <span class="keyword">return</span> <span class="identifier">names_</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span>
2618    <span class="special">}</span>
2619
2620    <span class="comment">// Is name in list?</span>
2621    <span class="keyword">bool</span> <span class="identifier">has</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">name</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
2622        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
2623        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2624            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2625                <span class="comment">// If empty, has not.</span>
2626                <span class="keyword">if</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">)</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">result</span><span class="special">);</span>
2627            <span class="special">})</span>
2628        <span class="special">;</span>
2629
2630        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">names_</span><span class="special">.</span><span class="identifier">cend</span><span class="special">()</span> <span class="special">!=</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">find</span><span class="special">(</span><span class="identifier">names_</span><span class="special">.</span><span class="identifier">cbegin</span><span class="special">(),</span>
2631                <span class="identifier">names_</span><span class="special">.</span><span class="identifier">cend</span><span class="special">(),</span> <span class="identifier">name</span><span class="special">);</span>
2632    <span class="special">}</span>
2633
2634    <span class="comment">/* Commands */</span>
2635
2636    <span class="comment">// Add name to list, if name not already in list.</span>
2637    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">put</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">name</span><span class="special">,</span>
2638            <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="special">{</span>
2639        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">bool</span><span class="special">&gt;</span> <span class="identifier">old_has_name</span> <span class="special">=</span>
2640                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">has</span><span class="special">(</span><span class="identifier">name</span><span class="special">));</span>
2641        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span>
2642                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">count</span><span class="special">());</span>
2643        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
2644            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2645                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">name</span><span class="special">));</span> <span class="comment">// Not already in list.</span>
2646            <span class="special">})</span>
2647            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2648                <span class="keyword">if</span><span class="special">(!*</span><span class="identifier">old_has_name</span><span class="special">)</span> <span class="special">{</span> <span class="comment">// If-guard allows to relax subcontracts.</span>
2649                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">name</span><span class="special">));</span> <span class="comment">// Name in list.</span>
2650                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Inc.</span>
2651                <span class="special">}</span>
2652            <span class="special">})</span>
2653        <span class="special">;</span>
2654
2655        <span class="identifier">names_</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(</span><span class="identifier">name</span><span class="special">);</span>
2656    <span class="special">}</span>
2657
2658<span class="keyword">private</span><span class="special">:</span>
2659    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">&gt;</span> <span class="identifier">names_</span><span class="special">;</span>
2660<span class="special">};</span>
2661
2662<span class="keyword">class</span> <span class="identifier">relaxed_name_list</span>
2663    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">public</span> <span class="identifier">name_list</span>
2664    <span class="special">:</span> <span class="identifier">BASES</span>
2665<span class="special">{</span>
2666    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
2667
2668    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span> <span class="comment">// Subcontracting.</span>
2669    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
2670
2671    <span class="identifier">BOOST_CONTRACT_OVERRIDE</span><span class="special">(</span><span class="identifier">put</span><span class="special">);</span>
2672
2673<span class="keyword">public</span><span class="special">:</span>
2674    <span class="comment">/*  Commands */</span>
2675
2676    <span class="comment">// Add name to list, or do nothing if name already in list (relaxed).</span>
2677    <span class="keyword">void</span> <span class="identifier">put</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">name</span><span class="special">,</span>
2678            <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="comment">/* override */</span> <span class="special">{</span>
2679        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">bool</span><span class="special">&gt;</span> <span class="identifier">old_has_name</span> <span class="special">=</span>
2680                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">has</span><span class="special">(</span><span class="identifier">name</span><span class="special">));</span>
2681        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span>
2682                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">count</span><span class="special">());</span>
2683        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
2684                <span class="identifier">override_put</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">relaxed_name_list</span><span class="special">::</span><span class="identifier">put</span><span class="special">,</span> <span class="keyword">this</span><span class="special">,</span> <span class="identifier">name</span><span class="special">)</span>
2685            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span> <span class="comment">// Relax inherited preconditions.</span>
2686                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">name</span><span class="special">));</span> <span class="comment">// Already in list.</span>
2687            <span class="special">})</span>
2688            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span> <span class="comment">// Inherited post. not checked given if-guard.</span>
2689                <span class="keyword">if</span><span class="special">(*</span><span class="identifier">old_has_name</span><span class="special">)</span> <span class="special">{</span>
2690                    <span class="comment">// Count unchanged if name already in list.</span>
2691                    <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span><span class="special">);</span>
2692                <span class="special">}</span>
2693            <span class="special">})</span>
2694        <span class="special">;</span>
2695
2696        <span class="keyword">if</span><span class="special">(!</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">name</span><span class="special">))</span> <span class="identifier">name_list</span><span class="special">::</span><span class="identifier">put</span><span class="special">(</span><span class="identifier">name</span><span class="special">);</span> <span class="comment">// Else, do nothing.</span>
2697    <span class="special">}</span>
2698<span class="special">};</span>
2699
2700<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
2701    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span> <span class="identifier">js</span> <span class="special">=</span> <span class="string">"John Smith"</span><span class="special">;</span>
2702
2703    <span class="identifier">relaxed_name_list</span> <span class="identifier">rl</span><span class="special">;</span>
2704    <span class="identifier">rl</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="identifier">js</span><span class="special">);</span>
2705    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">rl</span><span class="special">.</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">js</span><span class="special">));</span>
2706    <span class="identifier">rl</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="identifier">js</span><span class="special">);</span> <span class="comment">// OK, relaxed contracts allow calling this again (do nothing).</span>
2707
2708    <span class="identifier">name_list</span> <span class="identifier">nl</span><span class="special">;</span>
2709    <span class="identifier">nl</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="identifier">js</span><span class="special">);</span>
2710    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">nl</span><span class="special">.</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">js</span><span class="special">));</span>
2711    <span class="comment">// nl.put(js); // Error, contracts do not allow calling this again.</span>
2712
2713    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
2714<span class="special">}</span>
2715</pre>
2716<p>
2717      </p>
2718</div>
2719<div class="section">
2720<div class="titlepage"><div><div><h3 class="title">
2721<a name="boost_contract.examples.__mitchell02___dictionary__key_value_map"></a><a class="link" href="examples.html#boost_contract.examples.__mitchell02___dictionary__key_value_map" title="[Mitchell02] Dictionary: Key-value map">[Mitchell02]
2722      Dictionary: Key-value map</a>
2723</h3></div></div></div>
2724<p>
2725</p>
2726<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
2727<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">utility</span><span class="special">&gt;</span>
2728<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">map</span><span class="special">&gt;</span>
2729<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
2730
2731<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">K</span><span class="special">,</span> <span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
2732<span class="keyword">class</span> <span class="identifier">dictionary</span> <span class="special">{</span>
2733    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
2734
2735    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2736        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Non-negative count.</span>
2737    <span class="special">}</span>
2738
2739<span class="keyword">public</span><span class="special">:</span>
2740    <span class="comment">/* Creation */</span>
2741
2742    <span class="comment">// Create empty dictionary.</span>
2743    <span class="identifier">dictionary</span><span class="special">()</span> <span class="special">{</span>
2744        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2745            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2746                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Empty.</span>
2747            <span class="special">})</span>
2748        <span class="special">;</span>
2749    <span class="special">}</span>
2750
2751    <span class="comment">// Destroy dictionary.</span>
2752    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">dictionary</span><span class="special">()</span> <span class="special">{</span>
2753        <span class="comment">// Check invariants.</span>
2754        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2755    <span class="special">}</span>
2756
2757    <span class="comment">/* Basic Queries */</span>
2758
2759    <span class="comment">// Number of key entries.</span>
2760    <span class="keyword">int</span> <span class="identifier">count</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2761        <span class="comment">// Check invariants.</span>
2762        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2763        <span class="keyword">return</span> <span class="identifier">items_</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span>
2764    <span class="special">}</span>
2765
2766    <span class="comment">// Has entry for key?</span>
2767    <span class="keyword">bool</span> <span class="identifier">has</span><span class="special">(</span><span class="identifier">K</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">key</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
2768        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
2769        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2770            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2771                <span class="comment">// Empty has no key.</span>
2772                <span class="keyword">if</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">)</span> <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">result</span><span class="special">);</span>
2773            <span class="special">})</span>
2774        <span class="special">;</span>
2775
2776        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">items_</span><span class="special">.</span><span class="identifier">find</span><span class="special">(</span><span class="identifier">key</span><span class="special">)</span> <span class="special">!=</span> <span class="identifier">items_</span><span class="special">.</span><span class="identifier">end</span><span class="special">());</span>
2777    <span class="special">}</span>
2778
2779    <span class="comment">// Value for a given key.</span>
2780    <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value_for</span><span class="special">(</span><span class="identifier">K</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">key</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
2781        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2782            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2783                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">key</span><span class="special">));</span> <span class="comment">// Has key.</span>
2784            <span class="special">})</span>
2785        <span class="special">;</span>
2786
2787        <span class="comment">// Find != end because of precondition (no defensive programming).</span>
2788        <span class="keyword">return</span> <span class="identifier">items_</span><span class="special">.</span><span class="identifier">find</span><span class="special">(</span><span class="identifier">key</span><span class="special">)-&gt;</span><span class="identifier">second</span><span class="special">;</span>
2789    <span class="special">}</span>
2790
2791    <span class="comment">/* Commands */</span>
2792
2793    <span class="comment">// Add value of a given key.</span>
2794    <span class="keyword">void</span> <span class="identifier">put</span><span class="special">(</span><span class="identifier">K</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">key</span><span class="special">,</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
2795        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
2796        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2797            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2798                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">key</span><span class="special">));</span> <span class="comment">// Has not key already.</span>
2799            <span class="special">})</span>
2800            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2801                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Count inc.</span>
2802                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">key</span><span class="special">));</span> <span class="comment">// Has key.</span>
2803                <span class="comment">// Value set for key.</span>
2804                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">value_for</span><span class="special">(</span><span class="identifier">key</span><span class="special">)</span> <span class="special">==</span> <span class="identifier">value</span><span class="special">);</span>
2805            <span class="special">})</span>
2806        <span class="special">;</span>
2807
2808        <span class="identifier">items_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">make_pair</span><span class="special">(</span><span class="identifier">key</span><span class="special">,</span> <span class="identifier">value</span><span class="special">));</span>
2809    <span class="special">}</span>
2810
2811    <span class="comment">// Remove value for given key.</span>
2812    <span class="keyword">void</span> <span class="identifier">remove</span><span class="special">(</span><span class="identifier">K</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">key</span><span class="special">)</span> <span class="special">{</span>
2813        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
2814        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
2815            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2816                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">key</span><span class="special">));</span> <span class="comment">// Has key.</span>
2817            <span class="special">})</span>
2818            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2819                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Count dec.</span>
2820                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">key</span><span class="special">));</span> <span class="comment">// Has not key.</span>
2821            <span class="special">})</span>
2822        <span class="special">;</span>
2823
2824        <span class="identifier">items_</span><span class="special">.</span><span class="identifier">erase</span><span class="special">(</span><span class="identifier">key</span><span class="special">);</span>
2825    <span class="special">}</span>
2826
2827<span class="keyword">private</span><span class="special">:</span>
2828    <span class="identifier">std</span><span class="special">::</span><span class="identifier">map</span><span class="special">&lt;</span><span class="identifier">K</span><span class="special">,</span> <span class="identifier">T</span><span class="special">&gt;</span> <span class="identifier">items_</span><span class="special">;</span>
2829<span class="special">};</span>
2830
2831<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
2832    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span> <span class="identifier">js</span> <span class="special">=</span> <span class="string">"John Smith"</span><span class="special">;</span>
2833
2834    <span class="identifier">dictionary</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span><span class="special">,</span> <span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">ages</span><span class="special">;</span>
2835    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">ages</span><span class="special">.</span><span class="identifier">has</span><span class="special">(</span><span class="identifier">js</span><span class="special">));</span>
2836
2837    <span class="identifier">ages</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="identifier">js</span><span class="special">,</span> <span class="number">23</span><span class="special">);</span>
2838    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">ages</span><span class="special">.</span><span class="identifier">value_for</span><span class="special">(</span><span class="identifier">js</span><span class="special">)</span> <span class="special">==</span> <span class="number">23</span><span class="special">);</span>
2839
2840    <span class="identifier">ages</span><span class="special">.</span><span class="identifier">remove</span><span class="special">(</span><span class="identifier">js</span><span class="special">);</span>
2841    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">ages</span><span class="special">.</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
2842
2843    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
2844<span class="special">}</span>
2845</pre>
2846<p>
2847      </p>
2848</div>
2849<div class="section">
2850<div class="titlepage"><div><div><h3 class="title">
2851<a name="boost_contract.examples.__mitchell02___courier__subcontracting_and_static_class_invariants"></a><a class="link" href="examples.html#boost_contract.examples.__mitchell02___courier__subcontracting_and_static_class_invariants" title="[Mitchell02] Courier: Subcontracting and static class invariants">[Mitchell02]
2852      Courier: Subcontracting and static class invariants</a>
2853</h3></div></div></div>
2854<p>
2855</p>
2856<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
2857<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">string</span><span class="special">&gt;</span>
2858<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
2859
2860<span class="keyword">struct</span> <span class="identifier">package</span> <span class="special">{</span>
2861    <span class="keyword">double</span> <span class="identifier">weight_kg</span><span class="special">;</span>
2862    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">location</span><span class="special">;</span>
2863    <span class="keyword">double</span> <span class="identifier">accepted_hour</span><span class="special">;</span>
2864    <span class="keyword">double</span> <span class="identifier">delivered_hour</span><span class="special">;</span>
2865
2866    <span class="keyword">explicit</span> <span class="identifier">package</span><span class="special">(</span>
2867        <span class="keyword">double</span> <span class="identifier">_weight_kg</span><span class="special">,</span>
2868        <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">_location</span> <span class="special">=</span> <span class="string">""</span><span class="special">,</span>
2869        <span class="keyword">double</span> <span class="identifier">_accepted_hour</span> <span class="special">=</span> <span class="number">0.0</span><span class="special">,</span>
2870        <span class="keyword">double</span> <span class="identifier">_delivered_hour</span> <span class="special">=</span> <span class="number">0.0</span>
2871    <span class="special">)</span> <span class="special">:</span>
2872        <span class="identifier">weight_kg</span><span class="special">(</span><span class="identifier">_weight_kg</span><span class="special">),</span>
2873        <span class="identifier">location</span><span class="special">(</span><span class="identifier">_location</span><span class="special">),</span>
2874        <span class="identifier">accepted_hour</span><span class="special">(</span><span class="identifier">_accepted_hour</span><span class="special">),</span>
2875        <span class="identifier">delivered_hour</span><span class="special">(</span><span class="identifier">_delivered_hour</span><span class="special">)</span>
2876    <span class="special">{}</span>
2877<span class="special">};</span>
2878
2879<span class="comment">// Courier for package delivery.</span>
2880<span class="keyword">class</span> <span class="identifier">courier</span>
2881    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">private</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">courier</span><span class="special">&gt;</span>
2882    <span class="special">:</span> <span class="identifier">BASES</span>
2883<span class="special">{</span>
2884    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
2885
2886    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
2887    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
2888
2889    <span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">static_invariant</span><span class="special">()</span> <span class="special">{</span>
2890        <span class="comment">// Positive min. insurance.</span>
2891        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">min_insurance_usd</span> <span class="special">&gt;=</span> <span class="number">0.0</span><span class="special">);</span>
2892    <span class="special">}</span>
2893
2894    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2895        <span class="comment">// Above min. insurance.</span>
2896        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">insurance_cover_usd</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">min_insurance_usd</span><span class="special">);</span>
2897    <span class="special">}</span>
2898
2899<span class="keyword">public</span><span class="special">:</span>
2900    <span class="keyword">static</span> <span class="keyword">double</span> <span class="identifier">min_insurance_usd</span><span class="special">;</span>
2901
2902    <span class="comment">/* Creation */</span>
2903
2904    <span class="comment">// Create courier with specified insurance value.</span>
2905    <span class="keyword">explicit</span> <span class="identifier">courier</span><span class="special">(</span><span class="keyword">double</span> <span class="identifier">_insurance_cover_usd</span> <span class="special">=</span> <span class="identifier">min_insurance_usd</span><span class="special">)</span> <span class="special">:</span>
2906        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">courier</span><span class="special">&gt;([&amp;]</span> <span class="special">{</span>
2907            <span class="comment">// Positive insurance.</span>
2908            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">_insurance_cover_usd</span> <span class="special">&gt;=</span> <span class="number">0.0</span><span class="special">);</span>
2909        <span class="special">}),</span>
2910        <span class="identifier">insurance_cover_usd_</span><span class="special">(</span><span class="identifier">_insurance_cover_usd</span><span class="special">)</span>
2911    <span class="special">{</span>
2912        <span class="comment">// Check invariants.</span>
2913        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2914    <span class="special">}</span>
2915
2916    <span class="comment">// Destroy courier.</span>
2917    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">courier</span><span class="special">()</span> <span class="special">{</span>
2918        <span class="comment">// Check invariants.</span>
2919        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2920    <span class="special">}</span>
2921
2922    <span class="comment">/* Queries */</span>
2923
2924    <span class="comment">// Return insurance cover.</span>
2925    <span class="keyword">double</span> <span class="identifier">insurance_cover_usd</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2926        <span class="comment">// Check invariants.</span>
2927        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
2928        <span class="keyword">return</span> <span class="identifier">insurance_cover_usd_</span><span class="special">;</span>
2929    <span class="special">}</span>
2930
2931    <span class="comment">/* Commands */</span>
2932
2933    <span class="comment">// Deliver package to destination.</span>
2934    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">deliver</span><span class="special">(</span>
2935        <span class="identifier">package</span><span class="special">&amp;</span> <span class="identifier">package_delivery</span><span class="special">,</span>
2936        <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">destination</span><span class="special">,</span>
2937        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span>
2938    <span class="special">)</span> <span class="special">{</span>
2939        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
2940            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2941                <span class="comment">// Within max weight of this delivery.</span>
2942                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">weight_kg</span> <span class="special">&lt;</span> <span class="number">5.0</span><span class="special">);</span>
2943            <span class="special">})</span>
2944            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
2945                <span class="comment">// Within max delivery type.</span>
2946                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="keyword">double</span><span class="special">(</span><span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">delivered_hour</span> <span class="special">-</span>
2947                        <span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">accepted_hour</span><span class="special">)</span> <span class="special">&lt;=</span> <span class="number">3.0</span><span class="special">);</span>
2948                <span class="comment">// Delivered at destination.</span>
2949                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">location</span> <span class="special">==</span> <span class="identifier">destination</span><span class="special">);</span>
2950            <span class="special">})</span>
2951        <span class="special">;</span>
2952
2953        <span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">location</span> <span class="special">=</span> <span class="identifier">destination</span><span class="special">;</span>
2954        <span class="comment">// Delivery takes 2.5 hours.</span>
2955        <span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">delivered_hour</span> <span class="special">=</span> <span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">accepted_hour</span> <span class="special">+</span> <span class="number">2.5</span><span class="special">;</span>
2956    <span class="special">}</span>
2957
2958<span class="keyword">private</span><span class="special">:</span>
2959    <span class="keyword">double</span> <span class="identifier">insurance_cover_usd_</span><span class="special">;</span>
2960<span class="special">};</span>
2961
2962<span class="keyword">double</span> <span class="identifier">courier</span><span class="special">::</span><span class="identifier">min_insurance_usd</span> <span class="special">=</span> <span class="number">10.0e+6</span><span class="special">;</span>
2963
2964<span class="comment">// Different courier for package delivery.</span>
2965<span class="keyword">class</span> <span class="identifier">different_courier</span>
2966    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">private</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span> <span class="special">\</span>
2967            <span class="identifier">different_courier</span><span class="special">&gt;,</span> <span class="keyword">public</span> <span class="identifier">courier</span>
2968    <span class="special">:</span> <span class="identifier">BASES</span>
2969<span class="special">{</span>
2970    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
2971
2972    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span> <span class="comment">// Subcontracting.</span>
2973    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
2974
2975    <span class="keyword">static</span> <span class="keyword">void</span> <span class="identifier">static_invariant</span><span class="special">()</span> <span class="special">{</span>
2976        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span> <span class="comment">// Better insurance amount.</span>
2977                <span class="identifier">different_insurance_usd</span> <span class="special">&gt;=</span> <span class="identifier">courier</span><span class="special">::</span><span class="identifier">min_insurance_usd</span><span class="special">);</span>
2978    <span class="special">}</span>
2979
2980    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
2981        <span class="comment">// Above different insurance value.</span>
2982        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">insurance_cover_usd</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="identifier">different_insurance_usd</span><span class="special">);</span>
2983    <span class="special">}</span>
2984
2985    <span class="identifier">BOOST_CONTRACT_OVERRIDE</span><span class="special">(</span><span class="identifier">deliver</span><span class="special">)</span>
2986
2987<span class="keyword">public</span><span class="special">:</span>
2988    <span class="keyword">static</span> <span class="keyword">double</span> <span class="identifier">different_insurance_usd</span><span class="special">;</span>
2989
2990    <span class="comment">/* Creation */</span>
2991
2992    <span class="comment">// Create courier with specified insurance value.</span>
2993    <span class="keyword">explicit</span> <span class="identifier">different_courier</span><span class="special">(</span>
2994            <span class="keyword">double</span> <span class="identifier">insurance_cover_usd</span> <span class="special">=</span> <span class="identifier">different_insurance_usd</span><span class="special">)</span> <span class="special">:</span>
2995        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">different_courier</span><span class="special">&gt;([&amp;]</span> <span class="special">{</span>
2996            <span class="comment">// Positive insurance value.</span>
2997            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">insurance_cover_usd</span> <span class="special">&gt;</span> <span class="number">0.0</span><span class="special">);</span>
2998        <span class="special">}),</span>
2999        <span class="identifier">courier</span><span class="special">(</span><span class="identifier">insurance_cover_usd</span><span class="special">)</span>
3000    <span class="special">{</span>
3001        <span class="comment">// Check invariants.</span>
3002        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3003    <span class="special">}</span>
3004
3005    <span class="comment">// Destroy courier.</span>
3006    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">different_courier</span><span class="special">()</span> <span class="special">{</span>
3007        <span class="comment">// Check invariants.</span>
3008        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3009    <span class="special">}</span>
3010
3011    <span class="comment">/* Commands */</span>
3012
3013    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">deliver</span><span class="special">(</span>
3014        <span class="identifier">package</span><span class="special">&amp;</span> <span class="identifier">package_delivery</span><span class="special">,</span>
3015        <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">destination</span><span class="special">,</span>
3016        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span>
3017    <span class="special">)</span> <span class="comment">/* override */</span> <span class="special">{</span>
3018        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
3019            <span class="identifier">override_deliver</span>
3020        <span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">different_courier</span><span class="special">::</span><span class="identifier">deliver</span><span class="special">,</span> <span class="keyword">this</span><span class="special">,</span> <span class="identifier">package_delivery</span><span class="special">,</span> <span class="identifier">destination</span><span class="special">)</span>
3021            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3022                <span class="comment">// Package can weight more (weaker precondition).</span>
3023                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">weight_kg</span> <span class="special">&lt;=</span> <span class="number">8.0</span><span class="special">);</span>
3024            <span class="special">})</span>
3025            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3026                <span class="comment">// Faster delivery (stronger postcondition).</span>
3027                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="keyword">double</span><span class="special">(</span><span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">delivered_hour</span> <span class="special">-</span>
3028                        <span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">accepted_hour</span><span class="special">)</span> <span class="special">&lt;=</span> <span class="number">2.0</span><span class="special">);</span>
3029                <span class="comment">// Inherited "delivery at destination" postcondition.</span>
3030            <span class="special">})</span>
3031        <span class="special">;</span>
3032
3033        <span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">location</span> <span class="special">=</span> <span class="identifier">destination</span><span class="special">;</span>
3034        <span class="comment">// Delivery takes 0.5 hours.</span>
3035        <span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">delivered_hour</span> <span class="special">=</span> <span class="identifier">package_delivery</span><span class="special">.</span><span class="identifier">accepted_hour</span> <span class="special">+</span> <span class="number">0.5</span><span class="special">;</span>
3036    <span class="special">}</span>
3037<span class="special">};</span>
3038
3039<span class="keyword">double</span> <span class="identifier">different_courier</span><span class="special">::</span><span class="identifier">different_insurance_usd</span> <span class="special">=</span> <span class="number">20.0e+6</span><span class="special">;</span>
3040
3041<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
3042    <span class="identifier">package</span> <span class="identifier">cups</span><span class="special">(</span><span class="number">3.6</span><span class="special">,</span> <span class="string">"store"</span><span class="special">);</span>
3043    <span class="identifier">courier</span> <span class="identifier">c</span><span class="special">;</span>
3044    <span class="identifier">c</span><span class="special">.</span><span class="identifier">deliver</span><span class="special">(</span><span class="identifier">cups</span><span class="special">,</span> <span class="string">"home"</span><span class="special">);</span>
3045    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">cups</span><span class="special">.</span><span class="identifier">location</span> <span class="special">==</span> <span class="string">"home"</span><span class="special">);</span>
3046
3047    <span class="identifier">package</span> <span class="identifier">desk</span><span class="special">(</span><span class="number">7.2</span><span class="special">,</span> <span class="string">"store"</span><span class="special">);</span>
3048    <span class="identifier">different_courier</span> <span class="identifier">dc</span><span class="special">;</span>
3049    <span class="identifier">dc</span><span class="special">.</span><span class="identifier">deliver</span><span class="special">(</span><span class="identifier">desk</span><span class="special">,</span> <span class="string">"office"</span><span class="special">);</span>
3050    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">desk</span><span class="special">.</span><span class="identifier">location</span> <span class="special">==</span> <span class="string">"office"</span><span class="special">);</span>
3051
3052    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
3053<span class="special">}</span>
3054</pre>
3055<p>
3056      </p>
3057</div>
3058<div class="section">
3059<div class="titlepage"><div><div><h3 class="title">
3060<a name="boost_contract.examples.__mitchell02___stack__stack_like_container"></a><a class="link" href="examples.html#boost_contract.examples.__mitchell02___stack__stack_like_container" title="[Mitchell02] Stack: Stack-like container">[Mitchell02]
3061      Stack: Stack-like container</a>
3062</h3></div></div></div>
3063<p>
3064</p>
3065<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3066<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">optional</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3067<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&gt;</span>
3068<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
3069
3070<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
3071<span class="keyword">class</span> <span class="identifier">stack</span> <span class="special">{</span>
3072    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
3073
3074    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3075        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Non-negative count.</span>
3076    <span class="special">}</span>
3077
3078<span class="keyword">public</span><span class="special">:</span>
3079    <span class="comment">/* Creation */</span>
3080
3081    <span class="comment">// Create empty stack.</span>
3082    <span class="identifier">stack</span><span class="special">()</span> <span class="special">{</span>
3083        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3084            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3085                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Empty.</span>
3086            <span class="special">})</span>
3087        <span class="special">;</span>
3088    <span class="special">}</span>
3089
3090    <span class="comment">// Destroy stack.</span>
3091    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">stack</span><span class="special">()</span> <span class="special">{</span>
3092        <span class="comment">// Check invariants.</span>
3093        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3094    <span class="special">}</span>
3095
3096    <span class="comment">/* Basic Queries */</span>
3097
3098    <span class="comment">// Number of items.</span>
3099    <span class="keyword">int</span> <span class="identifier">count</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3100        <span class="comment">// Check invariants.</span>
3101        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3102        <span class="keyword">return</span> <span class="identifier">items_</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span>
3103    <span class="special">}</span>
3104
3105    <span class="comment">// Item at index in [1, count()] (as in Eiffel).</span>
3106    <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">item_at</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">index</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
3107        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3108            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3109                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">index</span> <span class="special">&gt;</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Positive index.</span>
3110                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">index</span> <span class="special">&lt;=</span> <span class="identifier">count</span><span class="special">());</span> <span class="comment">// Index within count.</span>
3111            <span class="special">})</span>
3112        <span class="special">;</span>
3113
3114        <span class="keyword">return</span> <span class="identifier">items_</span><span class="special">[</span><span class="identifier">index</span> <span class="special">-</span> <span class="number">1</span><span class="special">];</span>
3115    <span class="special">}</span>
3116
3117    <span class="comment">/* Derived Queries */</span>
3118
3119    <span class="comment">// If no items.</span>
3120    <span class="keyword">bool</span> <span class="identifier">is_empty</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3121        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
3122        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3123            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3124                <span class="comment">// Consistent with count.</span>
3125                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span>
3126            <span class="special">})</span>
3127        <span class="special">;</span>
3128
3129        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
3130    <span class="special">}</span>
3131
3132    <span class="comment">// Top item.</span>
3133    <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">item</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3134        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;</span> <span class="identifier">result</span><span class="special">;</span> <span class="comment">// Avoid extra construction of T.</span>
3135        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3136            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3137                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Not empty.</span>
3138            <span class="special">})</span>
3139            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3140                <span class="comment">// Item on top.</span>
3141                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(*</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">item_at</span><span class="special">(</span><span class="identifier">count</span><span class="special">()));</span>
3142            <span class="special">})</span>
3143        <span class="special">;</span>
3144
3145        <span class="keyword">return</span> <span class="special">*(</span><span class="identifier">result</span> <span class="special">=</span> <span class="identifier">item_at</span><span class="special">(</span><span class="identifier">count</span><span class="special">()));</span>
3146    <span class="special">}</span>
3147
3148    <span class="comment">/* Commands */</span>
3149
3150    <span class="comment">// Push item to the top.</span>
3151    <span class="keyword">void</span> <span class="identifier">put</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">new_item</span><span class="special">)</span> <span class="special">{</span>
3152        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
3153        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3154            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3155                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Count inc.</span>
3156                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">item</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">new_item</span><span class="special">);</span> <span class="comment">// Item set.</span>
3157            <span class="special">})</span>
3158        <span class="special">;</span>
3159
3160        <span class="identifier">items_</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(</span><span class="identifier">new_item</span><span class="special">);</span>
3161    <span class="special">}</span>
3162
3163    <span class="comment">// Pop top item.</span>
3164    <span class="keyword">void</span> <span class="identifier">remove</span><span class="special">()</span> <span class="special">{</span>
3165        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
3166        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3167            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3168                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Not empty.</span>
3169            <span class="special">})</span>
3170            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3171                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Count dec.</span>
3172            <span class="special">})</span>
3173        <span class="special">;</span>
3174
3175        <span class="identifier">items_</span><span class="special">.</span><span class="identifier">pop_back</span><span class="special">();</span>
3176    <span class="special">}</span>
3177
3178<span class="keyword">private</span><span class="special">:</span>
3179    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="identifier">items_</span><span class="special">;</span>
3180<span class="special">};</span>
3181
3182<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
3183    <span class="identifier">stack</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">s</span><span class="special">;</span>
3184    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
3185
3186    <span class="identifier">s</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="number">123</span><span class="special">);</span>
3187    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">item</span><span class="special">()</span> <span class="special">==</span> <span class="number">123</span><span class="special">);</span>
3188
3189    <span class="identifier">s</span><span class="special">.</span><span class="identifier">remove</span><span class="special">();</span>
3190    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">is_empty</span><span class="special">());</span>
3191
3192    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
3193<span class="special">}</span>
3194</pre>
3195<p>
3196      </p>
3197</div>
3198<div class="section">
3199<div class="titlepage"><div><div><h3 class="title">
3200<a name="boost_contract.examples.__mitchell02___simple_queue__queue_like_container_and_disable_old_value_copies_for_audit_assertions"></a><a class="link" href="examples.html#boost_contract.examples.__mitchell02___simple_queue__queue_like_container_and_disable_old_value_copies_for_audit_assertions" title="[Mitchell02] Simple Queue: Queue-like container and disable old value copies for audit assertions">[Mitchell02]
3201      Simple Queue: Queue-like container and disable old value copies for audit assertions</a>
3202</h3></div></div></div>
3203<p>
3204</p>
3205<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3206<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">optional</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3207<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&gt;</span>
3208<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
3209
3210<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
3211<span class="keyword">class</span> <span class="identifier">simple_queue</span>
3212    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">private</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span> <span class="special">\</span>
3213            <span class="identifier">simple_queue</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span>
3214    <span class="special">:</span> <span class="identifier">BASES</span>
3215<span class="special">{</span>
3216    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
3217
3218    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
3219    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
3220
3221    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3222        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Non-negative count.</span>
3223    <span class="special">}</span>
3224
3225<span class="keyword">public</span><span class="special">:</span>
3226    <span class="comment">/* Creation */</span>
3227
3228    <span class="comment">// Create empty queue.</span>
3229    <span class="keyword">explicit</span> <span class="identifier">simple_queue</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">a_capacity</span><span class="special">)</span> <span class="special">:</span>
3230        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">simple_queue</span><span class="special">&gt;([&amp;]</span> <span class="special">{</span>
3231            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">a_capacity</span> <span class="special">&gt;</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Positive capacity.</span>
3232        <span class="special">})</span>
3233    <span class="special">{</span>
3234        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3235            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3236                <span class="comment">// Capacity set.</span>
3237                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">a_capacity</span><span class="special">);</span>
3238                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">is_empty</span><span class="special">());</span> <span class="comment">// Empty.</span>
3239            <span class="special">})</span>
3240        <span class="special">;</span>
3241
3242        <span class="identifier">items_</span><span class="special">.</span><span class="identifier">reserve</span><span class="special">(</span><span class="identifier">a_capacity</span><span class="special">);</span>
3243    <span class="special">}</span>
3244
3245    <span class="comment">// Destroy queue.</span>
3246    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">simple_queue</span><span class="special">()</span> <span class="special">{</span>
3247        <span class="comment">// Check invariants.</span>
3248        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3249    <span class="special">}</span>
3250
3251    <span class="comment">/* Basic Queries */</span>
3252
3253    <span class="comment">// Items in queue (in their order).</span>
3254    <span class="comment">// (Somewhat exposes implementation but allows to check more contracts.)</span>
3255    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">items</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3256        <span class="comment">// Check invariants.</span>
3257        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3258        <span class="keyword">return</span> <span class="identifier">items_</span><span class="special">;</span>
3259    <span class="special">}</span>
3260
3261    <span class="comment">// Max number of items queue can hold.</span>
3262    <span class="keyword">int</span> <span class="identifier">capacity</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3263        <span class="comment">// Check invariants.</span>
3264        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3265        <span class="keyword">return</span> <span class="identifier">items_</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">();</span>
3266    <span class="special">}</span>
3267
3268    <span class="comment">/* Derived Queries */</span>
3269
3270    <span class="comment">// Number of items.</span>
3271    <span class="keyword">int</span> <span class="identifier">count</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3272        <span class="keyword">int</span> <span class="identifier">result</span><span class="special">;</span>
3273        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3274            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3275                <span class="comment">// Return items count.</span>
3276                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">items</span><span class="special">().</span><span class="identifier">size</span><span class="special">()));</span>
3277            <span class="special">})</span>
3278        <span class="special">;</span>
3279
3280        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">items_</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span>
3281    <span class="special">}</span>
3282
3283    <span class="comment">// Item at head.</span>
3284    <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">head</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3285        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;</span> <span class="identifier">result</span><span class="special">;</span>
3286        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3287            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3288                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">is_empty</span><span class="special">());</span> <span class="comment">// Not empty.</span>
3289            <span class="special">})</span>
3290            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3291                <span class="comment">// Return item on top.</span>
3292                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(*</span><span class="identifier">result</span> <span class="special">==</span> <span class="identifier">items</span><span class="special">().</span><span class="identifier">at</span><span class="special">(</span><span class="number">0</span><span class="special">));</span>
3293            <span class="special">})</span>
3294        <span class="special">;</span>
3295
3296        <span class="keyword">return</span> <span class="special">*(</span><span class="identifier">result</span> <span class="special">=</span> <span class="identifier">items_</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="number">0</span><span class="special">));</span>
3297    <span class="special">}</span>
3298
3299    <span class="comment">// If queue contains no item.</span>
3300    <span class="keyword">bool</span> <span class="identifier">is_empty</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3301        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
3302        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3303            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3304                <span class="comment">// Consistent with count.</span>
3305                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span>
3306            <span class="special">})</span>
3307        <span class="special">;</span>
3308
3309        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">items_</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
3310    <span class="special">}</span>
3311
3312    <span class="comment">// If queue has no room for another item.</span>
3313    <span class="keyword">bool</span> <span class="identifier">is_full</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3314        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
3315        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3316            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3317                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span> <span class="comment">// Consistent with size and capacity.</span>
3318                        <span class="identifier">result</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="keyword">int</span><span class="special">(</span><span class="identifier">items</span><span class="special">().</span><span class="identifier">size</span><span class="special">())));</span>
3319            <span class="special">})</span>
3320        <span class="special">;</span>
3321
3322        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">items_</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">items_</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">());</span>
3323    <span class="special">}</span>
3324
3325    <span class="comment">/* Commands */</span>
3326
3327    <span class="comment">// Remove head itme and shift all other items.</span>
3328    <span class="keyword">void</span> <span class="identifier">remove</span><span class="special">()</span> <span class="special">{</span>
3329        <span class="comment">// Expensive all_equal postcond. and old_items copy might be skipped.</span>
3330        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span> <span class="identifier">old_items</span><span class="special">;</span>
3331            <span class="preprocessor">#ifdef</span> <span class="identifier">BOOST_CONTRACT_AUDIITS</span>
3332                <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">items</span><span class="special">())</span>
3333            <span class="preprocessor">#endif</span> <span class="comment">// Else, leave old pointer null...</span>
3334        <span class="special">;</span>
3335        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
3336        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3337            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3338                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">is_empty</span><span class="special">());</span> <span class="comment">// Not empty.</span>
3339            <span class="special">})</span>
3340            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3341                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Count dec.</span>
3342                <span class="comment">// ...following skipped #ifndef AUDITS.</span>
3343                <span class="keyword">if</span><span class="special">(</span><span class="identifier">old_items</span><span class="special">)</span> <span class="identifier">all_equal</span><span class="special">(</span><span class="identifier">items</span><span class="special">(),</span> <span class="special">*</span><span class="identifier">old_items</span><span class="special">,</span> <span class="comment">/* shifted = */</span> <span class="number">1</span><span class="special">);</span>
3344            <span class="special">})</span>
3345        <span class="special">;</span>
3346
3347        <span class="identifier">items_</span><span class="special">.</span><span class="identifier">erase</span><span class="special">(</span><span class="identifier">items_</span><span class="special">.</span><span class="identifier">begin</span><span class="special">());</span>
3348    <span class="special">}</span>
3349
3350    <span class="comment">// Add item to tail.</span>
3351    <span class="keyword">void</span> <span class="identifier">put</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">item</span><span class="special">)</span> <span class="special">{</span>
3352        <span class="comment">// Expensive all_equal postcond. and old_items copy might be skipped.</span>
3353        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span> <span class="identifier">old_items</span><span class="special">;</span>
3354            <span class="preprocessor">#ifdef</span> <span class="identifier">BOOST_CONTRACT_AUDITS</span>
3355                <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">items</span><span class="special">())</span>
3356            <span class="preprocessor">#endif</span> <span class="comment">// Else, leave old pointer null...</span>
3357        <span class="special">;</span>
3358        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
3359        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3360            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3361                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&lt;</span> <span class="identifier">capacity</span><span class="special">());</span> <span class="comment">// Room for add.</span>
3362            <span class="special">})</span>
3363            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3364                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Count inc.</span>
3365                <span class="comment">// Second to last item.</span>
3366                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">items</span><span class="special">().</span><span class="identifier">at</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">-</span> <span class="number">1</span><span class="special">)</span> <span class="special">==</span> <span class="identifier">item</span><span class="special">);</span>
3367                <span class="comment">// ...following skipped #ifndef AUDITS.</span>
3368                <span class="keyword">if</span><span class="special">(</span><span class="identifier">old_items</span><span class="special">)</span> <span class="identifier">all_equal</span><span class="special">(</span><span class="identifier">items</span><span class="special">(),</span> <span class="special">*</span><span class="identifier">old_items</span><span class="special">);</span>
3369            <span class="special">})</span>
3370        <span class="special">;</span>
3371
3372        <span class="identifier">items_</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(</span><span class="identifier">item</span><span class="special">);</span>
3373    <span class="special">}</span>
3374
3375<span class="keyword">private</span><span class="special">:</span>
3376    <span class="comment">// Contract helper.</span>
3377    <span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">all_equal</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">left</span><span class="special">,</span>
3378            <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">right</span><span class="special">,</span> <span class="keyword">unsigned</span> <span class="identifier">offset</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="special">{</span>
3379        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
3380            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3381                <span class="comment">// Correct offset.</span>
3382                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">right</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">left</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span> <span class="special">+</span> <span class="identifier">offset</span><span class="special">);</span>
3383            <span class="special">})</span>
3384        <span class="special">;</span>
3385
3386        <span class="keyword">for</span><span class="special">(</span><span class="keyword">unsigned</span> <span class="identifier">i</span> <span class="special">=</span> <span class="identifier">offset</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">right</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="special">{</span>
3387            <span class="keyword">if</span><span class="special">(</span><span class="identifier">left</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="identifier">i</span> <span class="special">-</span> <span class="identifier">offset</span><span class="special">)</span> <span class="special">!=</span> <span class="identifier">right</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="identifier">i</span><span class="special">))</span> <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
3388        <span class="special">}</span>
3389        <span class="keyword">return</span> <span class="keyword">true</span><span class="special">;</span>
3390    <span class="special">}</span>
3391
3392    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="identifier">items_</span><span class="special">;</span>
3393<span class="special">};</span>
3394
3395<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
3396    <span class="identifier">simple_queue</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">q</span><span class="special">(</span><span class="number">10</span><span class="special">);</span>
3397    <span class="identifier">q</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="number">123</span><span class="special">);</span>
3398    <span class="identifier">q</span><span class="special">.</span><span class="identifier">put</span><span class="special">(</span><span class="number">456</span><span class="special">);</span>
3399
3400    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">q</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="number">10</span><span class="special">);</span>
3401    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">q</span><span class="special">.</span><span class="identifier">head</span><span class="special">()</span> <span class="special">==</span> <span class="number">123</span><span class="special">);</span>
3402
3403    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">q</span><span class="special">.</span><span class="identifier">is_empty</span><span class="special">());</span>
3404    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">q</span><span class="special">.</span><span class="identifier">is_full</span><span class="special">());</span>
3405
3406    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">items</span> <span class="special">=</span> <span class="identifier">q</span><span class="special">.</span><span class="identifier">items</span><span class="special">();</span>
3407    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">items</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="number">0</span><span class="special">)</span> <span class="special">==</span> <span class="number">123</span><span class="special">);</span>
3408    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">items</span><span class="special">.</span><span class="identifier">at</span><span class="special">(</span><span class="number">1</span><span class="special">)</span> <span class="special">==</span> <span class="number">456</span><span class="special">);</span>
3409
3410    <span class="identifier">q</span><span class="special">.</span><span class="identifier">remove</span><span class="special">();</span>
3411    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">q</span><span class="special">.</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">1</span><span class="special">);</span>
3412
3413    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
3414<span class="special">}</span>
3415</pre>
3416<p>
3417      </p>
3418</div>
3419<div class="section">
3420<div class="titlepage"><div><div><h3 class="title">
3421<a name="boost_contract.examples.__mitchell02___customer_manager__contracts_instead_of_defensive_programming"></a><a class="link" href="examples.html#boost_contract.examples.__mitchell02___customer_manager__contracts_instead_of_defensive_programming" title="[Mitchell02] Customer Manager: Contracts instead of defensive programming">[Mitchell02]
3422      Customer Manager: Contracts instead of defensive programming</a>
3423</h3></div></div></div>
3424<p>
3425</p>
3426<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3427<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">string</span><span class="special">&gt;</span>
3428<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">map</span><span class="special">&gt;</span>
3429<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">utility</span><span class="special">&gt;</span>
3430<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
3431
3432<span class="comment">// Basic customer information.</span>
3433<span class="keyword">struct</span> <span class="identifier">customer_info</span> <span class="special">{</span>
3434    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">customer_manager</span><span class="special">;</span>
3435
3436    <span class="keyword">typedef</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">identifier</span><span class="special">;</span>
3437
3438    <span class="identifier">identifier</span> <span class="identifier">id</span><span class="special">;</span>
3439
3440    <span class="keyword">explicit</span> <span class="identifier">customer_info</span><span class="special">(</span><span class="identifier">identifier</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">_id</span><span class="special">)</span> <span class="special">:</span>
3441            <span class="identifier">id</span><span class="special">(</span><span class="identifier">_id</span><span class="special">),</span> <span class="identifier">name_</span><span class="special">(),</span> <span class="identifier">address_</span><span class="special">(),</span> <span class="identifier">birthday_</span><span class="special">()</span> <span class="special">{}</span>
3442
3443<span class="keyword">private</span><span class="special">:</span>
3444    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">name_</span><span class="special">;</span>
3445    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">address_</span><span class="special">;</span>
3446    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">birthday_</span><span class="special">;</span>
3447<span class="special">};</span>
3448
3449<span class="comment">// Manage customers.</span>
3450<span class="keyword">class</span> <span class="identifier">customer_manager</span> <span class="special">{</span>
3451    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
3452
3453    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3454        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span> <span class="comment">// Non-negative count.</span>
3455    <span class="special">}</span>
3456
3457<span class="keyword">public</span><span class="special">:</span>
3458    <span class="comment">/* Creation */</span>
3459
3460    <span class="identifier">customer_manager</span><span class="special">()</span> <span class="special">{</span>
3461        <span class="comment">// Check invariants.</span>
3462        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3463    <span class="special">}</span>
3464
3465    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">customer_manager</span><span class="special">()</span> <span class="special">{</span>
3466        <span class="comment">// Check invariants.</span>
3467        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3468    <span class="special">}</span>
3469
3470    <span class="comment">/* Basic Queries */</span>
3471
3472    <span class="keyword">int</span> <span class="identifier">count</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3473        <span class="comment">// Check invariants.</span>
3474        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3475        <span class="keyword">return</span> <span class="identifier">customers_</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span>
3476    <span class="special">}</span>
3477
3478    <span class="keyword">bool</span> <span class="identifier">id_active</span><span class="special">(</span><span class="identifier">customer_info</span><span class="special">::</span><span class="identifier">identifier</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">id</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
3479        <span class="comment">// Check invariants.</span>
3480        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3481        <span class="keyword">return</span> <span class="identifier">customers_</span><span class="special">.</span><span class="identifier">find</span><span class="special">(</span><span class="identifier">id</span><span class="special">)</span> <span class="special">!=</span> <span class="identifier">customers_</span><span class="special">.</span><span class="identifier">cend</span><span class="special">();</span>
3482    <span class="special">}</span>
3483
3484    <span class="comment">/* Derived Queries */</span>
3485
3486    <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">name_for</span><span class="special">(</span><span class="identifier">customer_info</span><span class="special">::</span><span class="identifier">identifier</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">id</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
3487        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3488            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3489                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">id_active</span><span class="special">(</span><span class="identifier">id</span><span class="special">));</span> <span class="comment">// Active.</span>
3490            <span class="special">})</span>
3491        <span class="special">;</span>
3492
3493        <span class="comment">// Find != end because of preconditions (no defensive programming).</span>
3494        <span class="keyword">return</span> <span class="identifier">customers_</span><span class="special">.</span><span class="identifier">find</span><span class="special">(</span><span class="identifier">id</span><span class="special">)-&gt;</span><span class="identifier">second</span><span class="special">.</span><span class="identifier">name_</span><span class="special">;</span>
3495    <span class="special">}</span>
3496
3497    <span class="comment">/* Commands */</span>
3498
3499    <span class="keyword">void</span> <span class="identifier">add</span><span class="special">(</span><span class="identifier">customer_info</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">info</span><span class="special">)</span> <span class="special">{</span>
3500        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_count</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">count</span><span class="special">());</span>
3501        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3502            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3503                <span class="comment">// Not already active.</span>
3504                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">id_active</span><span class="special">(</span><span class="identifier">info</span><span class="special">.</span><span class="identifier">id</span><span class="special">));</span>
3505            <span class="special">})</span>
3506            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3507                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_count</span> <span class="special">+</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Count inc.</span>
3508                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">id_active</span><span class="special">(</span><span class="identifier">info</span><span class="special">.</span><span class="identifier">id</span><span class="special">));</span> <span class="comment">// Activated.</span>
3509            <span class="special">})</span>
3510        <span class="special">;</span>
3511
3512        <span class="identifier">customers_</span><span class="special">.</span><span class="identifier">insert</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">make_pair</span><span class="special">(</span><span class="identifier">info</span><span class="special">.</span><span class="identifier">id</span><span class="special">,</span> <span class="identifier">customer</span><span class="special">(</span><span class="identifier">info</span><span class="special">)));</span>
3513    <span class="special">}</span>
3514
3515    <span class="keyword">void</span> <span class="identifier">set_name</span><span class="special">(</span><span class="identifier">customer_info</span><span class="special">::</span><span class="identifier">identifier</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">id</span><span class="special">,</span>
3516            <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">name</span><span class="special">)</span> <span class="special">{</span>
3517        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3518            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3519                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">id_active</span><span class="special">(</span><span class="identifier">id</span><span class="special">));</span> <span class="comment">// Already active.</span>
3520            <span class="special">})</span>
3521            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3522                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">name_for</span><span class="special">(</span><span class="identifier">id</span><span class="special">)</span> <span class="special">==</span> <span class="identifier">name</span><span class="special">);</span> <span class="comment">// Name set.</span>
3523            <span class="special">})</span>
3524        <span class="special">;</span>
3525
3526        <span class="comment">// Find != end because of precondition (no defensive programming).</span>
3527        <span class="identifier">customers_</span><span class="special">.</span><span class="identifier">find</span><span class="special">(</span><span class="identifier">id</span><span class="special">)-&gt;</span><span class="identifier">second</span><span class="special">.</span><span class="identifier">name_</span> <span class="special">=</span> <span class="identifier">name</span><span class="special">;</span>
3528    <span class="special">}</span>
3529
3530<span class="keyword">private</span><span class="special">:</span>
3531    <span class="keyword">class</span> <span class="identifier">agent</span> <span class="special">{};</span> <span class="comment">// Customer agent.</span>
3532
3533    <span class="keyword">struct</span> <span class="identifier">customer</span> <span class="special">:</span> <span class="identifier">customer_info</span> <span class="special">{</span>
3534        <span class="identifier">agent</span> <span class="identifier">managing_agent</span><span class="special">;</span>
3535        <span class="identifier">std</span><span class="special">::</span><span class="identifier">string</span> <span class="identifier">last_contact</span><span class="special">;</span>
3536
3537        <span class="keyword">explicit</span> <span class="identifier">customer</span><span class="special">(</span><span class="identifier">customer_info</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">info</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">customer_info</span><span class="special">(</span><span class="identifier">info</span><span class="special">),</span>
3538                <span class="identifier">managing_agent</span><span class="special">(),</span> <span class="identifier">last_contact</span><span class="special">()</span> <span class="special">{}</span>
3539    <span class="special">};</span>
3540
3541    <span class="identifier">std</span><span class="special">::</span><span class="identifier">map</span><span class="special">&lt;</span><span class="identifier">customer_info</span><span class="special">::</span><span class="identifier">identifier</span><span class="special">,</span> <span class="identifier">customer</span><span class="special">&gt;</span> <span class="identifier">customers_</span><span class="special">;</span>
3542<span class="special">};</span>
3543
3544<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
3545    <span class="identifier">customer_manager</span> <span class="identifier">m</span><span class="special">;</span>
3546    <span class="identifier">customer_info</span> <span class="keyword">const</span> <span class="identifier">js</span><span class="special">(</span><span class="string">"john_smith_123"</span><span class="special">);</span>
3547    <span class="identifier">m</span><span class="special">.</span><span class="identifier">add</span><span class="special">(</span><span class="identifier">js</span><span class="special">);</span>
3548    <span class="identifier">m</span><span class="special">.</span><span class="identifier">set_name</span><span class="special">(</span><span class="identifier">js</span><span class="special">.</span><span class="identifier">id</span><span class="special">,</span> <span class="string">"John Smith"</span><span class="special">);</span>
3549    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">m</span><span class="special">.</span><span class="identifier">name_for</span><span class="special">(</span><span class="identifier">js</span><span class="special">.</span><span class="identifier">id</span><span class="special">)</span> <span class="special">==</span> <span class="string">"John Smith"</span><span class="special">);</span>
3550    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">m</span><span class="special">.</span><span class="identifier">count</span><span class="special">()</span> <span class="special">==</span> <span class="number">1</span><span class="special">);</span>
3551    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">m</span><span class="special">.</span><span class="identifier">id_active</span><span class="special">(</span><span class="identifier">js</span><span class="special">.</span><span class="identifier">id</span><span class="special">));</span>
3552    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
3553<span class="special">}</span>
3554</pre>
3555<p>
3556      </p>
3557</div>
3558<div class="section">
3559<div class="titlepage"><div><div><h3 class="title">
3560<a name="boost_contract.examples.__mitchell02___observer__pure_virtual_functions"></a><a class="link" href="examples.html#boost_contract.examples.__mitchell02___observer__pure_virtual_functions" title="[Mitchell02] Observer: Pure virtual functions">[Mitchell02]
3561      Observer: Pure virtual functions</a>
3562</h3></div></div></div>
3563<p>
3564</p>
3565<pre class="programlisting"><span class="preprocessor">#ifndef</span> <span class="identifier">OBSERVER_HPP_</span>
3566<span class="preprocessor">#define</span> <span class="identifier">OBSERVER_HPP_</span>
3567
3568<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3569<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
3570
3571<span class="comment">// Observer.</span>
3572<span class="keyword">class</span> <span class="identifier">observer</span> <span class="special">{</span>
3573    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">subject</span><span class="special">;</span>
3574<span class="keyword">public</span><span class="special">:</span>
3575    <span class="comment">// No inv and no bases so contracts optional if no pre, post, and override.</span>
3576
3577    <span class="comment">/* Creation */</span>
3578
3579    <span class="identifier">observer</span><span class="special">()</span> <span class="special">{</span>
3580        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3581        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3582    <span class="special">}</span>
3583
3584    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">observer</span><span class="special">()</span> <span class="special">{</span>
3585        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3586        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3587    <span class="special">}</span>
3588
3589    <span class="comment">/* Commands */</span>
3590
3591    <span class="comment">// If up-to-date with related subject.</span>
3592    <span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">up_to_date_with_subject</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
3593            <span class="keyword">const</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
3594
3595    <span class="comment">// Update this observer.</span>
3596    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">update</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
3597<span class="special">};</span>
3598
3599<span class="keyword">bool</span> <span class="identifier">observer</span><span class="special">::</span><span class="identifier">up_to_date_with_subject</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
3600    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
3601    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
3602    <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
3603<span class="special">}</span>
3604
3605<span class="keyword">void</span> <span class="identifier">observer</span><span class="special">::</span><span class="identifier">update</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="special">{</span>
3606    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
3607        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3608            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">up_to_date_with_subject</span><span class="special">());</span> <span class="comment">// Up-to-date.</span>
3609        <span class="special">})</span>
3610    <span class="special">;</span>
3611    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
3612<span class="special">}</span>
3613
3614<span class="preprocessor">#endif</span> <span class="comment">// #include guard</span>
3615</pre>
3616<p>
3617      </p>
3618<p>
3619</p>
3620<pre class="programlisting"><span class="preprocessor">#ifndef</span> <span class="identifier">SUBJECT_HPP_</span>
3621<span class="preprocessor">#define</span> <span class="identifier">SUBJECT_HPP_</span>
3622
3623<span class="preprocessor">#include</span> <span class="string">"observer.hpp"</span>
3624<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3625<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&gt;</span>
3626<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">algorithm</span><span class="special">&gt;</span>
3627<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
3628
3629<span class="comment">// Subject for observer design pattern.</span>
3630<span class="keyword">class</span> <span class="identifier">subject</span> <span class="special">{</span>
3631    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
3632
3633    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3634        <span class="identifier">BOOST_CONTRACT_ASSERT_AUDIT</span><span class="special">(</span><span class="identifier">all_observers_valid</span><span class="special">(</span><span class="identifier">observers</span><span class="special">()));</span> <span class="comment">// Valid.</span>
3635    <span class="special">}</span>
3636
3637<span class="keyword">public</span><span class="special">:</span>
3638    <span class="comment">/* Creation */</span>
3639
3640    <span class="comment">// Construct subject with no observer.</span>
3641    <span class="identifier">subject</span><span class="special">()</span> <span class="special">{</span>
3642        <span class="comment">// Check invariant.</span>
3643        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3644    <span class="special">}</span>
3645
3646    <span class="comment">// Destroy subject.</span>
3647    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">subject</span><span class="special">()</span> <span class="special">{</span>
3648        <span class="comment">// Check invariant.</span>
3649        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3650    <span class="special">}</span>
3651
3652    <span class="comment">/* Queries */</span>
3653
3654    <span class="comment">// If given object is attached.</span>
3655    <span class="keyword">bool</span> <span class="identifier">attached</span><span class="special">(</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*</span> <span class="identifier">ob</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
3656        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3657            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3658                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">ob</span><span class="special">);</span> <span class="comment">// Not null.</span>
3659            <span class="special">})</span>
3660        <span class="special">;</span>
3661
3662        <span class="keyword">return</span> <span class="identifier">std</span><span class="special">::</span><span class="identifier">find</span><span class="special">(</span><span class="identifier">observers_</span><span class="special">.</span><span class="identifier">cbegin</span><span class="special">(),</span> <span class="identifier">observers_</span><span class="special">.</span><span class="identifier">cend</span><span class="special">(),</span> <span class="identifier">ob</span><span class="special">)</span> <span class="special">!=</span>
3663                <span class="identifier">observers_</span><span class="special">.</span><span class="identifier">cend</span><span class="special">();</span>
3664    <span class="special">}</span>
3665
3666    <span class="comment">/* Commands */</span>
3667
3668    <span class="comment">// Attach given object as an observer.</span>
3669    <span class="keyword">void</span> <span class="identifier">attach</span><span class="special">(</span><span class="identifier">observer</span><span class="special">*</span> <span class="identifier">ob</span><span class="special">)</span> <span class="special">{</span>
3670        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;</span> <span class="special">&gt;</span> <span class="identifier">old_observers</span><span class="special">;</span>
3671        <span class="preprocessor">#ifdef</span> <span class="identifier">BOOST_CONTRACT_AUDITS</span>
3672            <span class="identifier">old_observers</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">observers</span><span class="special">());</span>
3673        <span class="preprocessor">#endif</span>
3674        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3675            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3676                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">ob</span><span class="special">);</span> <span class="comment">// Not null.</span>
3677                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">attached</span><span class="special">(</span><span class="identifier">ob</span><span class="special">));</span> <span class="comment">// Not already attached.</span>
3678            <span class="special">})</span>
3679            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3680                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">attached</span><span class="special">(</span><span class="identifier">ob</span><span class="special">));</span> <span class="comment">// Attached.</span>
3681                <span class="comment">// Others not changed (frame rule).</span>
3682                <span class="identifier">BOOST_CONTRACT_ASSERT_AUDIT</span><span class="special">(</span><span class="identifier">other_observers_unchanged</span><span class="special">(</span>
3683                        <span class="special">*</span><span class="identifier">old_observers</span><span class="special">,</span> <span class="identifier">observers</span><span class="special">(),</span> <span class="identifier">ob</span><span class="special">));</span>
3684            <span class="special">})</span>
3685        <span class="special">;</span>
3686
3687        <span class="identifier">observers_</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(</span><span class="identifier">ob</span><span class="special">);</span>
3688    <span class="special">}</span>
3689
3690<span class="keyword">protected</span><span class="special">:</span>
3691    <span class="comment">// Contracts could have been omitted for protected/private with no pre/post.</span>
3692
3693    <span class="comment">/* Queries */</span>
3694
3695    <span class="comment">// All observers attached to this subject.</span>
3696    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;</span> <span class="identifier">observers</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3697        <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;</span> <span class="identifier">obs</span><span class="special">;</span>
3698        <span class="keyword">for</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span><span class="special">*&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">i</span> <span class="special">=</span> <span class="identifier">observers_</span><span class="special">.</span><span class="identifier">cbegin</span><span class="special">();</span>
3699                <span class="identifier">i</span> <span class="special">!=</span> <span class="identifier">observers_</span><span class="special">.</span><span class="identifier">cend</span><span class="special">();</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="special">{</span>
3700            <span class="identifier">obs</span><span class="special">.</span><span class="identifier">push_back</span><span class="special">(*</span><span class="identifier">i</span><span class="special">);</span>
3701        <span class="special">}</span>
3702        <span class="keyword">return</span> <span class="identifier">obs</span><span class="special">;</span>
3703    <span class="special">}</span>
3704
3705    <span class="comment">/* Commands */</span>
3706
3707    <span class="comment">// Update all attached observers.</span>
3708    <span class="keyword">void</span> <span class="identifier">notify</span><span class="special">()</span> <span class="special">{</span>
3709        <span class="comment">// Protected members use `function` (no inv and no subcontracting).</span>
3710        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
3711            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3712                <span class="comment">// All updated.</span>
3713                <span class="identifier">BOOST_CONTRACT_ASSERT_AUDIT</span><span class="special">(</span><span class="identifier">all_observers_updated</span><span class="special">(</span><span class="identifier">observers</span><span class="special">()));</span>
3714            <span class="special">})</span>
3715        <span class="special">;</span>
3716
3717        <span class="keyword">for</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span><span class="special">*&gt;::</span><span class="identifier">iterator</span> <span class="identifier">i</span> <span class="special">=</span> <span class="identifier">observers_</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
3718                <span class="identifier">i</span> <span class="special">!=</span> <span class="identifier">observers_</span><span class="special">.</span><span class="identifier">end</span><span class="special">();</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="special">{</span>
3719            <span class="comment">// Class invariants ensure no null pointers in observers but class</span>
3720            <span class="comment">// invariants not checked for non-public functions so assert here.</span>
3721            <span class="identifier">assert</span><span class="special">(*</span><span class="identifier">i</span><span class="special">);</span> <span class="comment">// Pointer not null (defensive programming).</span>
3722            <span class="special">(*</span><span class="identifier">i</span><span class="special">)-&gt;</span><span class="identifier">update</span><span class="special">();</span>
3723        <span class="special">}</span>
3724    <span class="special">}</span>
3725
3726<span class="keyword">private</span><span class="special">:</span>
3727    <span class="comment">/* Contract Helpers */</span>
3728
3729    <span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">all_observers_valid</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">obs</span><span class="special">)</span> <span class="special">{</span>
3730        <span class="keyword">for</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">i</span> <span class="special">=</span> <span class="identifier">obs</span><span class="special">.</span><span class="identifier">cbegin</span><span class="special">();</span>
3731                <span class="identifier">i</span> <span class="special">!=</span> <span class="identifier">obs</span><span class="special">.</span><span class="identifier">cend</span><span class="special">();</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="special">{</span>
3732            <span class="keyword">if</span><span class="special">(!*</span><span class="identifier">i</span><span class="special">)</span> <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
3733        <span class="special">}</span>
3734        <span class="keyword">return</span> <span class="keyword">true</span><span class="special">;</span>
3735    <span class="special">}</span>
3736
3737    <span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">other_observers_unchanged</span><span class="special">(</span>
3738        <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">old_obs</span><span class="special">,</span>
3739        <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">new_obs</span><span class="special">,</span>
3740        <span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*</span> <span class="identifier">ob</span>
3741    <span class="special">)</span> <span class="special">{</span>
3742        <span class="comment">// Private members use `function` (no inv and no subcontracting).</span>
3743        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
3744            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3745                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">ob</span><span class="special">);</span> <span class="comment">// Not null.</span>
3746            <span class="special">})</span>
3747        <span class="special">;</span>
3748
3749        <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;</span> <span class="identifier">remaining</span> <span class="special">=</span> <span class="identifier">new_obs</span><span class="special">;</span>
3750        <span class="identifier">std</span><span class="special">::</span><span class="identifier">remove</span><span class="special">(</span><span class="identifier">remaining</span><span class="special">.</span><span class="identifier">begin</span><span class="special">(),</span> <span class="identifier">remaining</span><span class="special">.</span><span class="identifier">end</span><span class="special">(),</span> <span class="identifier">ob</span><span class="special">);</span>
3751
3752        <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">remaining_it</span> <span class="special">=</span>
3753                <span class="identifier">remaining</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
3754        <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">old_it</span> <span class="special">=</span> <span class="identifier">old_obs</span><span class="special">.</span><span class="identifier">begin</span><span class="special">();</span>
3755        <span class="keyword">while</span><span class="special">(</span><span class="identifier">remaining</span><span class="special">.</span><span class="identifier">cend</span><span class="special">()</span> <span class="special">!=</span> <span class="identifier">remaining_it</span> <span class="special">&amp;&amp;</span> <span class="identifier">old_obs</span><span class="special">.</span><span class="identifier">cend</span><span class="special">()</span> <span class="special">!=</span> <span class="identifier">old_it</span><span class="special">)</span> <span class="special">{</span>
3756            <span class="keyword">if</span><span class="special">(*</span><span class="identifier">remaining_it</span> <span class="special">!=</span> <span class="special">*</span><span class="identifier">old_it</span><span class="special">)</span> <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
3757            <span class="special">++</span><span class="identifier">remaining_it</span><span class="special">;</span>
3758            <span class="special">++</span><span class="identifier">old_it</span><span class="special">;</span>
3759        <span class="special">}</span>
3760        <span class="keyword">return</span> <span class="keyword">true</span><span class="special">;</span>
3761    <span class="special">}</span>
3762
3763    <span class="keyword">static</span> <span class="keyword">bool</span> <span class="identifier">all_observers_updated</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">obs</span><span class="special">)</span> <span class="special">{</span>
3764        <span class="keyword">for</span><span class="special">(</span><span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span> <span class="keyword">const</span><span class="special">*&gt;::</span><span class="identifier">const_iterator</span> <span class="identifier">i</span> <span class="special">=</span> <span class="identifier">obs</span><span class="special">.</span><span class="identifier">cbegin</span><span class="special">();</span>
3765                <span class="identifier">i</span> <span class="special">!=</span> <span class="identifier">obs</span><span class="special">.</span><span class="identifier">cend</span><span class="special">();</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="special">{</span>
3766            <span class="keyword">if</span><span class="special">(!*</span><span class="identifier">i</span><span class="special">)</span> <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
3767            <span class="keyword">if</span><span class="special">(!(*</span><span class="identifier">i</span><span class="special">)-&gt;</span><span class="identifier">up_to_date_with_subject</span><span class="special">())</span> <span class="keyword">return</span> <span class="keyword">false</span><span class="special">;</span>
3768        <span class="special">}</span>
3769        <span class="keyword">return</span> <span class="keyword">true</span><span class="special">;</span>
3770    <span class="special">}</span>
3771
3772    <span class="identifier">std</span><span class="special">::</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">observer</span><span class="special">*&gt;</span> <span class="identifier">observers_</span><span class="special">;</span>
3773<span class="special">};</span>
3774
3775<span class="preprocessor">#endif</span> <span class="comment">// #include guard</span>
3776</pre>
3777<p>
3778      </p>
3779<p>
3780</p>
3781<pre class="programlisting"><span class="preprocessor">#include</span> <span class="string">"observer/observer.hpp"</span>
3782<span class="preprocessor">#include</span> <span class="string">"observer/subject.hpp"</span>
3783<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3784<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
3785
3786<span class="keyword">int</span> <span class="identifier">test_state</span><span class="special">;</span> <span class="comment">// For testing only.</span>
3787
3788<span class="comment">// Implement an actual subject.</span>
3789<span class="keyword">class</span> <span class="identifier">concrete_subject</span>
3790    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">public</span> <span class="identifier">subject</span>
3791    <span class="special">:</span> <span class="identifier">BASES</span>
3792<span class="special">{</span>
3793    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
3794
3795    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span> <span class="comment">// Subcontracting.</span>
3796    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
3797
3798<span class="keyword">public</span><span class="special">:</span>
3799    <span class="keyword">typedef</span> <span class="keyword">int</span> <span class="identifier">state</span><span class="special">;</span> <span class="comment">// Some state being observed.</span>
3800
3801    <span class="identifier">concrete_subject</span><span class="special">()</span> <span class="special">:</span> <span class="identifier">state_</span><span class="special">()</span> <span class="special">{</span>
3802        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3803        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3804    <span class="special">}</span>
3805
3806    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">concrete_subject</span><span class="special">()</span> <span class="special">{</span>
3807        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3808        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3809    <span class="special">}</span>
3810
3811    <span class="keyword">void</span> <span class="identifier">set_state</span><span class="special">(</span><span class="identifier">state</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">new_state</span><span class="special">)</span> <span class="special">{</span>
3812        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3813        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3814
3815        <span class="identifier">state_</span> <span class="special">=</span> <span class="identifier">new_state</span><span class="special">;</span>
3816        <span class="identifier">assert</span><span class="special">(</span><span class="identifier">state_</span> <span class="special">==</span> <span class="identifier">test_state</span><span class="special">);</span>
3817        <span class="identifier">notify</span><span class="special">();</span> <span class="comment">// Notify all observers.</span>
3818    <span class="special">}</span>
3819
3820    <span class="identifier">state</span> <span class="identifier">get_state</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3821        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3822        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3823        <span class="keyword">return</span> <span class="identifier">state_</span><span class="special">;</span>
3824    <span class="special">}</span>
3825
3826<span class="keyword">private</span><span class="special">:</span>
3827    <span class="identifier">state</span> <span class="identifier">state_</span><span class="special">;</span>
3828<span class="special">};</span>
3829
3830<span class="comment">// Implement an actual observer.</span>
3831<span class="keyword">class</span> <span class="identifier">concrete_observer</span>
3832    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">public</span> <span class="identifier">observer</span>
3833    <span class="special">:</span> <span class="identifier">BASES</span>
3834<span class="special">{</span>
3835    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
3836
3837    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span> <span class="comment">// Subcontracting.</span>
3838    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
3839
3840    <span class="identifier">BOOST_CONTRACT_OVERRIDES</span><span class="special">(</span><span class="identifier">up_to_date_with_subject</span><span class="special">,</span> <span class="identifier">update</span><span class="special">)</span>
3841
3842<span class="keyword">public</span><span class="special">:</span>
3843    <span class="comment">// Create concrete observer.</span>
3844    <span class="keyword">explicit</span> <span class="identifier">concrete_observer</span><span class="special">(</span><span class="identifier">concrete_subject</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">subj</span><span class="special">)</span> <span class="special">:</span>
3845            <span class="identifier">subject_</span><span class="special">(</span><span class="identifier">subj</span><span class="special">),</span> <span class="identifier">observed_state_</span><span class="special">()</span> <span class="special">{</span>
3846        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3847        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3848    <span class="special">}</span>
3849
3850    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">concrete_observer</span><span class="special">()</span> <span class="special">{</span>
3851        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3852        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3853    <span class="special">}</span>
3854
3855    <span class="comment">// Implement base virtual functions.</span>
3856
3857    <span class="keyword">bool</span> <span class="identifier">up_to_date_with_subject</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
3858            <span class="keyword">const</span> <span class="comment">/* override */</span> <span class="special">{</span>
3859        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
3860        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
3861            <span class="identifier">override_up_to_date_with_subject</span>
3862        <span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">concrete_observer</span><span class="special">::</span><span class="identifier">up_to_date_with_subject</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
3863
3864        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="keyword">true</span><span class="special">;</span> <span class="comment">// For simplicity, assume always up-to-date.</span>
3865    <span class="special">}</span>
3866
3867    <span class="keyword">void</span> <span class="identifier">update</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="comment">/* override */</span> <span class="special">{</span>
3868        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
3869                <span class="identifier">override_update</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">concrete_observer</span><span class="special">::</span><span class="identifier">update</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
3870
3871        <span class="identifier">observed_state_</span> <span class="special">=</span> <span class="identifier">subject_</span><span class="special">.</span><span class="identifier">get_state</span><span class="special">();</span>
3872        <span class="identifier">assert</span><span class="special">(</span><span class="identifier">observed_state_</span> <span class="special">==</span> <span class="identifier">test_state</span><span class="special">);</span>
3873    <span class="special">}</span>
3874
3875<span class="keyword">private</span><span class="special">:</span>
3876    <span class="identifier">concrete_subject</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">subject_</span><span class="special">;</span>
3877    <span class="identifier">concrete_subject</span><span class="special">::</span><span class="identifier">state</span> <span class="identifier">observed_state_</span><span class="special">;</span>
3878<span class="special">};</span>
3879
3880<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
3881    <span class="identifier">concrete_subject</span> <span class="identifier">subj</span><span class="special">;</span>
3882    <span class="identifier">concrete_observer</span> <span class="identifier">ob</span><span class="special">(</span><span class="identifier">subj</span><span class="special">);</span>
3883    <span class="identifier">subj</span><span class="special">.</span><span class="identifier">attach</span><span class="special">(&amp;</span><span class="identifier">ob</span><span class="special">);</span>
3884
3885    <span class="identifier">subj</span><span class="special">.</span><span class="identifier">set_state</span><span class="special">(</span><span class="identifier">test_state</span> <span class="special">=</span> <span class="number">123</span><span class="special">);</span>
3886    <span class="identifier">subj</span><span class="special">.</span><span class="identifier">set_state</span><span class="special">(</span><span class="identifier">test_state</span> <span class="special">=</span> <span class="number">456</span><span class="special">);</span>
3887
3888    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
3889<span class="special">}</span>
3890</pre>
3891<p>
3892      </p>
3893</div>
3894<div class="section">
3895<div class="titlepage"><div><div><h3 class="title">
3896<a name="boost_contract.examples.__mitchell02___counter__subcontracting"></a><a name="Mitchell02_counter_anchor"></a><a class="link" href="examples.html#boost_contract.examples.__mitchell02___counter__subcontracting" title="[Mitchell02] Counter: Subcontracting">[Mitchell02]
3897      Counter: Subcontracting</a>
3898</h3></div></div></div>
3899<p>
3900</p>
3901<pre class="programlisting"><span class="preprocessor">#ifndef</span> <span class="identifier">PUSH_BUTTON_HPP_</span>
3902<span class="preprocessor">#define</span> <span class="identifier">PUSH_BUTTON_HPP_</span>
3903
3904<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3905<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
3906
3907<span class="keyword">class</span> <span class="identifier">push_button</span> <span class="special">{</span>
3908<span class="keyword">public</span><span class="special">:</span>
3909    <span class="comment">// No inv and no bases so contracts optional if no pre, post, and override.</span>
3910
3911    <span class="comment">/* Creation */</span>
3912
3913    <span class="comment">// Create an enabled button.</span>
3914    <span class="identifier">push_button</span><span class="special">()</span> <span class="special">:</span> <span class="identifier">enabled_</span><span class="special">(</span><span class="keyword">true</span><span class="special">)</span> <span class="special">{</span>
3915        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3916            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3917                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">enabled</span><span class="special">());</span> <span class="comment">// Enabled.</span>
3918            <span class="special">})</span>
3919        <span class="special">;</span>
3920    <span class="special">}</span>
3921
3922    <span class="comment">// Destroy button.</span>
3923    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">push_button</span><span class="special">()</span> <span class="special">{</span>
3924        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3925        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3926    <span class="special">}</span>
3927
3928    <span class="comment">/* Queries */</span>
3929
3930    <span class="comment">// If button is enabled.</span>
3931    <span class="keyword">bool</span> <span class="identifier">enabled</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
3932        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
3933        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
3934        <span class="keyword">return</span> <span class="identifier">enabled_</span><span class="special">;</span>
3935    <span class="special">}</span>
3936
3937    <span class="comment">/* Commands */</span>
3938
3939    <span class="comment">// Enable button.</span>
3940    <span class="keyword">void</span> <span class="identifier">enable</span><span class="special">()</span> <span class="special">{</span>
3941        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3942            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3943                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">enabled</span><span class="special">());</span> <span class="comment">// Enabled.</span>
3944            <span class="special">})</span>
3945        <span class="special">;</span>
3946
3947        <span class="identifier">enabled_</span> <span class="special">=</span> <span class="keyword">true</span><span class="special">;</span>
3948    <span class="special">}</span>
3949
3950    <span class="comment">// Disable button.</span>
3951    <span class="keyword">void</span> <span class="identifier">disable</span><span class="special">()</span> <span class="special">{</span>
3952        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
3953            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3954                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">enabled</span><span class="special">());</span> <span class="comment">// Disabled.</span>
3955            <span class="special">})</span>
3956        <span class="special">;</span>
3957
3958        <span class="identifier">enabled_</span> <span class="special">=</span> <span class="keyword">false</span><span class="special">;</span>
3959    <span class="special">}</span>
3960
3961    <span class="comment">// Invoke externally when button clicked.</span>
3962    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">on_bn_clicked</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
3963
3964<span class="keyword">private</span><span class="special">:</span>
3965    <span class="keyword">bool</span> <span class="identifier">enabled_</span><span class="special">;</span>
3966<span class="special">};</span>
3967
3968<span class="keyword">void</span> <span class="identifier">push_button</span><span class="special">::</span><span class="identifier">on_bn_clicked</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="special">{</span>
3969    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
3970        <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
3971            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">enabled</span><span class="special">());</span> <span class="comment">// Enabled.</span>
3972        <span class="special">})</span>
3973    <span class="special">;</span>
3974    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
3975<span class="special">}</span>
3976
3977<span class="preprocessor">#endif</span> <span class="comment">// #include guard</span>
3978</pre>
3979<p>
3980      </p>
3981<p>
3982</p>
3983<pre class="programlisting"><span class="preprocessor">#ifndef</span> <span class="identifier">DECREMENT_BUTTON_HPP_</span>
3984<span class="preprocessor">#define</span> <span class="identifier">DECREMENT_BUTTON_HPP_</span>
3985
3986<span class="preprocessor">#include</span> <span class="string">"push_button.hpp"</span>
3987<span class="preprocessor">#include</span> <span class="string">"counter.hpp"</span>
3988<span class="preprocessor">#include</span> <span class="string">"../observer/observer.hpp"</span>
3989<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3990<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">noncopyable</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
3991
3992<span class="keyword">class</span> <span class="identifier">decrement_button</span>
3993    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">public</span> <span class="identifier">push_button</span><span class="special">,</span> <span class="keyword">public</span> <span class="identifier">observer</span><span class="special">,</span> <span class="special">\</span>
3994            <span class="keyword">private</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">noncopyable</span>
3995    <span class="special">:</span> <span class="identifier">BASES</span>
3996<span class="special">{</span>
3997    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
3998
3999    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
4000    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
4001
4002    <span class="identifier">BOOST_CONTRACT_OVERRIDES</span><span class="special">(</span><span class="identifier">on_bn_clicked</span><span class="special">,</span> <span class="identifier">up_to_date_with_subject</span><span class="special">,</span> <span class="identifier">update</span><span class="special">);</span>
4003
4004<span class="keyword">public</span><span class="special">:</span>
4005    <span class="comment">/* Creation */</span>
4006
4007    <span class="keyword">explicit</span> <span class="identifier">decrement_button</span><span class="special">(</span><span class="identifier">counter</span><span class="special">&amp;</span> <span class="identifier">a_counter</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">counter_</span><span class="special">(</span><span class="identifier">a_counter</span><span class="special">)</span> <span class="special">{</span>
4008        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4009            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4010                <span class="comment">// Enable iff positive value.</span>
4011                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">enabled</span><span class="special">()</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">a_counter</span><span class="special">.</span><span class="identifier">value</span><span class="special">()</span> <span class="special">&gt;</span> <span class="number">0</span><span class="special">));</span>
4012            <span class="special">})</span>
4013        <span class="special">;</span>
4014        <span class="identifier">counter_</span><span class="special">.</span><span class="identifier">attach</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4015    <span class="special">}</span>
4016
4017    <span class="comment">// Destroy button.</span>
4018    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">decrement_button</span><span class="special">()</span> <span class="special">{</span>
4019        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
4020        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4021    <span class="special">}</span>
4022
4023    <span class="comment">/* Commands */</span>
4024
4025    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">on_bn_clicked</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
4026            <span class="comment">/* override */</span> <span class="special">{</span>
4027        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_value</span> <span class="special">=</span>
4028                <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">counter_</span><span class="special">.</span><span class="identifier">value</span><span class="special">());</span>
4029        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4030            <span class="identifier">override_on_bn_clicked</span>
4031        <span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">decrement_button</span><span class="special">::</span><span class="identifier">on_bn_clicked</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
4032            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4033                <span class="comment">// Counter decremented.</span>
4034                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">counter_</span><span class="special">.</span><span class="identifier">value</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_value</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span>
4035            <span class="special">})</span>
4036        <span class="special">;</span>
4037        <span class="identifier">counter_</span><span class="special">.</span><span class="identifier">decrement</span><span class="special">();</span>
4038    <span class="special">}</span>
4039
4040    <span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">up_to_date_with_subject</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
4041            <span class="keyword">const</span> <span class="comment">/* override */</span> <span class="special">{</span>
4042        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
4043        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4044            <span class="identifier">override_up_to_date_with_subject</span>
4045        <span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">decrement_button</span><span class="special">::</span><span class="identifier">up_to_date_with_subject</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
4046
4047        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="keyword">true</span><span class="special">;</span> <span class="comment">// For simplicity, assume always up-to-date.</span>
4048    <span class="special">}</span>
4049
4050    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">update</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="comment">/* override */</span> <span class="special">{</span>
4051        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4052                <span class="identifier">override_update</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">decrement_button</span><span class="special">::</span><span class="identifier">update</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
4053            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4054                <span class="comment">// Enabled iff positive value.</span>
4055                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">enabled</span><span class="special">()</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">counter_</span><span class="special">.</span><span class="identifier">value</span><span class="special">()</span> <span class="special">&gt;</span> <span class="number">0</span><span class="special">));</span>
4056            <span class="special">})</span>
4057        <span class="special">;</span>
4058
4059        <span class="keyword">if</span><span class="special">(</span><span class="identifier">counter_</span><span class="special">.</span><span class="identifier">value</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">)</span> <span class="identifier">disable</span><span class="special">();</span>
4060        <span class="keyword">else</span> <span class="identifier">enable</span><span class="special">();</span>
4061    <span class="special">}</span>
4062
4063<span class="keyword">private</span><span class="special">:</span>
4064    <span class="identifier">counter</span><span class="special">&amp;</span> <span class="identifier">counter_</span><span class="special">;</span>
4065<span class="special">};</span>
4066
4067<span class="preprocessor">#endif</span> <span class="comment">// #include guard</span>
4068</pre>
4069<p>
4070      </p>
4071<p>
4072</p>
4073<pre class="programlisting"><span class="preprocessor">#ifndef</span> <span class="identifier">COUNTER_HPP_</span>
4074<span class="preprocessor">#define</span> <span class="identifier">COUNTER_HPP_</span>
4075
4076<span class="preprocessor">#include</span> <span class="string">"../observer/subject.hpp"</span>
4077<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4078
4079<span class="keyword">class</span> <span class="identifier">counter</span>
4080    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">public</span> <span class="identifier">subject</span>
4081    <span class="special">:</span> <span class="identifier">BASES</span>
4082<span class="special">{</span>
4083    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
4084
4085    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
4086    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
4087
4088<span class="keyword">public</span><span class="special">:</span>
4089    <span class="comment">/* Creation */</span>
4090
4091    <span class="comment">// Construct counter with specified value.</span>
4092    <span class="keyword">explicit</span> <span class="identifier">counter</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">a_value</span> <span class="special">=</span> <span class="number">10</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">value_</span><span class="special">(</span><span class="identifier">a_value</span><span class="special">)</span> <span class="special">{</span>
4093        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4094            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4095                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">value</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">a_value</span><span class="special">);</span> <span class="comment">// Value set.</span>
4096            <span class="special">})</span>
4097        <span class="special">;</span>
4098    <span class="special">}</span>
4099
4100    <span class="comment">// Destroy counter.</span>
4101    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">counter</span><span class="special">()</span> <span class="special">{</span>
4102        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
4103        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4104    <span class="special">}</span>
4105
4106    <span class="comment">/* Queries */</span>
4107
4108    <span class="comment">// Current counter value.</span>
4109    <span class="keyword">int</span> <span class="identifier">value</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4110        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
4111        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4112        <span class="keyword">return</span> <span class="identifier">value_</span><span class="special">;</span>
4113    <span class="special">}</span>
4114
4115    <span class="comment">/* Commands */</span>
4116
4117    <span class="comment">// Decrement counter value.</span>
4118    <span class="keyword">void</span> <span class="identifier">decrement</span><span class="special">()</span> <span class="special">{</span>
4119        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">old_value</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">value</span><span class="special">());</span>
4120        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4121            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4122                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">value</span><span class="special">()</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_value</span> <span class="special">-</span> <span class="number">1</span><span class="special">);</span> <span class="comment">// Decrement.</span>
4123            <span class="special">})</span>
4124        <span class="special">;</span>
4125
4126        <span class="special">--</span><span class="identifier">value_</span><span class="special">;</span>
4127        <span class="identifier">notify</span><span class="special">();</span> <span class="comment">// Notify all attached observers.</span>
4128    <span class="special">}</span>
4129
4130<span class="keyword">private</span><span class="special">:</span>
4131    <span class="keyword">int</span> <span class="identifier">value_</span><span class="special">;</span>
4132<span class="special">};</span>
4133
4134<span class="preprocessor">#endif</span> <span class="comment">// #include guard</span>
4135</pre>
4136<p>
4137      </p>
4138<p>
4139</p>
4140<pre class="programlisting"><span class="preprocessor">#include</span> <span class="string">"counter/counter.hpp"</span>
4141<span class="preprocessor">#include</span> <span class="string">"counter/decrement_button.hpp"</span>
4142<span class="preprocessor">#include</span> <span class="string">"observer/observer.hpp"</span>
4143<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
4144
4145<span class="keyword">int</span> <span class="identifier">test_counter</span><span class="special">;</span>
4146
4147<span class="keyword">class</span> <span class="identifier">view_of_counter</span>
4148    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">public</span> <span class="identifier">observer</span>
4149    <span class="special">:</span> <span class="identifier">BASES</span>
4150<span class="special">{</span>
4151    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
4152
4153    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
4154    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
4155
4156    <span class="identifier">BOOST_CONTRACT_OVERRIDES</span><span class="special">(</span><span class="identifier">up_to_date_with_subject</span><span class="special">,</span> <span class="identifier">update</span><span class="special">)</span>
4157
4158<span class="keyword">public</span><span class="special">:</span>
4159    <span class="comment">/* Creation */</span>
4160
4161    <span class="comment">// Create view associated with given counter.</span>
4162    <span class="keyword">explicit</span> <span class="identifier">view_of_counter</span><span class="special">(</span><span class="identifier">counter</span><span class="special">&amp;</span> <span class="identifier">a_counter</span><span class="special">)</span> <span class="special">:</span> <span class="identifier">counter_</span><span class="special">(</span><span class="identifier">a_counter</span><span class="special">)</span> <span class="special">{</span>
4163        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
4164        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4165
4166        <span class="identifier">counter_</span><span class="special">.</span><span class="identifier">attach</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4167        <span class="identifier">assert</span><span class="special">(</span><span class="identifier">counter_</span><span class="special">.</span><span class="identifier">value</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">test_counter</span><span class="special">);</span>
4168    <span class="special">}</span>
4169
4170    <span class="comment">// Destroy view.</span>
4171    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">view_of_counter</span><span class="special">()</span> <span class="special">{</span>
4172        <span class="comment">// Could have omitted contracts here (nothing to check).</span>
4173        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4174    <span class="special">}</span>
4175
4176    <span class="comment">/* Commands */</span>
4177
4178    <span class="keyword">virtual</span> <span class="keyword">bool</span> <span class="identifier">up_to_date_with_subject</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
4179            <span class="keyword">const</span> <span class="comment">/* override */</span> <span class="special">{</span>
4180        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
4181        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4182            <span class="identifier">override_up_to_date_with_subject</span>
4183        <span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">view_of_counter</span><span class="special">::</span><span class="identifier">up_to_date_with_subject</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
4184
4185        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="keyword">true</span><span class="special">;</span> <span class="comment">// For simplicity, assume always up-to-date.</span>
4186    <span class="special">}</span>
4187
4188    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">update</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="comment">/* override */</span> <span class="special">{</span>
4189        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4190                <span class="identifier">override_update</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">view_of_counter</span><span class="special">::</span><span class="identifier">update</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
4191
4192        <span class="identifier">assert</span><span class="special">(</span><span class="identifier">counter_</span><span class="special">.</span><span class="identifier">value</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">test_counter</span><span class="special">);</span>
4193    <span class="special">}</span>
4194
4195<span class="keyword">private</span><span class="special">:</span>
4196    <span class="identifier">counter</span><span class="special">&amp;</span> <span class="identifier">counter_</span><span class="special">;</span>
4197<span class="special">};</span>
4198
4199<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
4200    <span class="identifier">counter</span> <span class="identifier">cnt</span><span class="special">(</span><span class="identifier">test_counter</span> <span class="special">=</span> <span class="number">1</span><span class="special">);</span>
4201    <span class="identifier">view_of_counter</span> <span class="identifier">view</span><span class="special">(</span><span class="identifier">cnt</span><span class="special">);</span>
4202
4203    <span class="identifier">decrement_button</span> <span class="identifier">dec</span><span class="special">(</span><span class="identifier">cnt</span><span class="special">);</span>
4204    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">dec</span><span class="special">.</span><span class="identifier">enabled</span><span class="special">());</span>
4205
4206    <span class="identifier">test_counter</span><span class="special">--;</span>
4207    <span class="identifier">dec</span><span class="special">.</span><span class="identifier">on_bn_clicked</span><span class="special">();</span>
4208    <span class="identifier">assert</span><span class="special">(!</span><span class="identifier">dec</span><span class="special">.</span><span class="identifier">enabled</span><span class="special">());</span>
4209
4210    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
4211<span class="special">}</span>
4212</pre>
4213<p>
4214      </p>
4215</div>
4216<div class="section">
4217<div class="titlepage"><div><div><h3 class="title">
4218<a name="boost_contract.examples.__cline90___vector__comparison_with_a___proposal_syntax"></a><a name="Cline90_vector_anchor"></a><a class="link" href="examples.html#boost_contract.examples.__cline90___vector__comparison_with_a___proposal_syntax" title="[Cline90] Vector: Comparison with A++ proposal syntax">[Cline90]
4219      Vector: Comparison with A++ proposal syntax</a>
4220</h3></div></div></div>
4221<div class="informaltable"><table class="table">
4222<colgroup>
4223<col>
4224<col>
4225</colgroup>
4226<thead><tr>
4227<th>
4228                <p>
4229                  This Library
4230                </p>
4231              </th>
4232<th>
4233                <p>
4234                  A++ Proposal (never actually implemented)
4235                </p>
4236              </th>
4237</tr></thead>
4238<tbody>
4239<tr>
4240<td>
4241                <p>
4242</p>
4243<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#ifndef</span> <span class="identifier">VECTOR_HPP_</span>
4244<span class="preprocessor">#define</span> <span class="identifier">VECTOR_HPP_</span>
4245
4246<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4247
4248<span class="comment">// NOTE: Incomplete contract assertions, addressing only `size`.</span>
4249<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4250<span class="keyword">class</span> <span class="identifier">vector</span>
4251    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">private</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span>
4252    <span class="special">:</span> <span class="identifier">BASES</span>
4253<span class="special">{</span>
4254    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
4255
4256    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
4257    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
4258
4259    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4260        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4261    <span class="special">}</span>
4262
4263<span class="keyword">public</span><span class="special">:</span>
4264    <span class="keyword">explicit</span> <span class="identifier">vector</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">count</span> <span class="special">=</span> <span class="number">10</span><span class="special">)</span> <span class="special">:</span>
4265        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">vector</span><span class="special">&gt;([&amp;]</span> <span class="special">{</span>
4266            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4267        <span class="special">}),</span>
4268        <span class="identifier">data_</span><span class="special">(</span><span class="keyword">new</span> <span class="identifier">T</span><span class="special">[</span><span class="identifier">count</span><span class="special">]),</span>
4269        <span class="identifier">size_</span><span class="special">(</span><span class="identifier">count</span><span class="special">)</span>
4270    <span class="special">{</span>
4271        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4272            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4273                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">);</span>
4274            <span class="special">})</span>
4275        <span class="special">;</span>
4276
4277        <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">size_</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">i</span><span class="special">]</span> <span class="special">=</span> <span class="identifier">T</span><span class="special">();</span>
4278    <span class="special">}</span>
4279
4280    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">vector</span><span class="special">()</span> <span class="special">{</span>
4281        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4282        <span class="keyword">delete</span><span class="special">[]</span> <span class="identifier">data_</span><span class="special">;</span>
4283    <span class="special">}</span>
4284
4285    <span class="keyword">int</span> <span class="identifier">size</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4286        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4287        <span class="keyword">return</span> <span class="identifier">size_</span><span class="special">;</span> <span class="comment">// Non-negative result already checked by invariant.</span>
4288    <span class="special">}</span>
4289
4290    <span class="keyword">void</span> <span class="identifier">resize</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">count</span><span class="special">)</span> <span class="special">{</span>
4291        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4292            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4293                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4294            <span class="special">})</span>
4295            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4296                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">);</span>
4297            <span class="special">})</span>
4298        <span class="special">;</span>
4299
4300        <span class="identifier">T</span><span class="special">*</span> <span class="identifier">slice</span> <span class="special">=</span> <span class="keyword">new</span> <span class="identifier">T</span><span class="special">[</span><span class="identifier">count</span><span class="special">];</span>
4301        <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">count</span> <span class="special">&amp;&amp;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">size_</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="identifier">slice</span><span class="special">[</span><span class="identifier">i</span><span class="special">]</span> <span class="special">=</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">i</span><span class="special">];</span>
4302        <span class="keyword">delete</span><span class="special">[]</span> <span class="identifier">data_</span><span class="special">;</span>
4303        <span class="identifier">data_</span> <span class="special">=</span> <span class="identifier">slice</span><span class="special">;</span>
4304        <span class="identifier">size_</span> <span class="special">=</span> <span class="identifier">count</span><span class="special">;</span>
4305    <span class="special">}</span>
4306
4307    <span class="identifier">T</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">[](</span><span class="keyword">int</span> <span class="identifier">index</span><span class="special">)</span> <span class="special">{</span>
4308        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4309            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4310                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">index</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4311                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">index</span> <span class="special">&lt;</span> <span class="identifier">size</span><span class="special">());</span>
4312            <span class="special">})</span>
4313        <span class="special">;</span>
4314
4315        <span class="keyword">return</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">index</span><span class="special">];</span>
4316    <span class="special">}</span>
4317
4318    <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">[](</span><span class="keyword">int</span> <span class="identifier">index</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
4319        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4320            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4321                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">index</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4322                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">index</span> <span class="special">&lt;</span> <span class="identifier">size</span><span class="special">());</span>
4323            <span class="special">})</span>
4324        <span class="special">;</span>
4325
4326        <span class="keyword">return</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">index</span><span class="special">];</span>
4327    <span class="special">}</span>
4328
4329<span class="keyword">private</span><span class="special">:</span>
4330    <span class="identifier">T</span><span class="special">*</span> <span class="identifier">data_</span><span class="special">;</span>
4331    <span class="keyword">int</span> <span class="identifier">size_</span><span class="special">;</span>
4332<span class="special">};</span>
4333
4334<span class="preprocessor">#endif</span> <span class="comment">// #include guard</span>
4335</pre>
4336<p>
4337                </p>
4338              </td>
4339<td>
4340                <p>
4341</p>
4342<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="comment">// Extra spaces, newlines, etc. for visual alignment with this library code.</span>
4343
4344
4345
4346
4347
4348<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4349<span class="keyword">class</span> <span class="identifier">vector</span> <span class="special">{</span>
4350
4351
4352
4353
4354
4355
4356
4357
4358<span class="identifier">legal</span><span class="special">:</span> <span class="comment">// Class invariants (legal).</span>
4359    <span class="identifier">size</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">;</span>
4360
4361
4362<span class="keyword">public</span><span class="special">:</span>
4363    <span class="keyword">explicit</span> <span class="identifier">vector</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">count</span> <span class="special">=</span> <span class="number">10</span><span class="special">)</span> <span class="special">:</span>
4364        <span class="identifier">data_</span><span class="special">(</span><span class="keyword">new</span> <span class="identifier">T</span><span class="special">[</span><span class="identifier">count</span><span class="special">]),</span>
4365        <span class="identifier">size_</span><span class="special">(</span><span class="identifier">count</span><span class="special">)</span>
4366    <span class="special">{</span>
4367        <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">size_</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">i</span><span class="special">]</span> <span class="special">=</span> <span class="identifier">T</span><span class="special">();</span>
4368    <span class="special">}</span>
4369
4370
4371
4372
4373
4374
4375
4376
4377
4378
4379    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">vector</span><span class="special">()</span> <span class="special">{</span> <span class="keyword">delete</span><span class="special">[]</span> <span class="identifier">data_</span><span class="special">;</span> <span class="special">}</span>
4380
4381
4382
4383
4384    <span class="keyword">int</span> <span class="identifier">size</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span> <span class="keyword">return</span> <span class="identifier">size_</span><span class="special">;</span> <span class="special">}</span>
4385
4386
4387
4388
4389    <span class="keyword">void</span> <span class="identifier">resize</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">count</span><span class="special">)</span> <span class="special">{</span>
4390        <span class="identifier">T</span><span class="special">*</span> <span class="identifier">slice</span> <span class="special">=</span> <span class="keyword">new</span> <span class="identifier">T</span><span class="special">[</span><span class="identifier">count</span><span class="special">];</span>
4391        <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">count</span> <span class="special">&amp;&amp;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">size_</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="identifier">slice</span><span class="special">[</span><span class="identifier">i</span><span class="special">]</span> <span class="special">=</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">i</span><span class="special">];</span>
4392        <span class="keyword">delete</span><span class="special">[]</span> <span class="identifier">data_</span><span class="special">;</span>
4393        <span class="identifier">data_</span> <span class="special">=</span> <span class="identifier">slice</span><span class="special">;</span>
4394        <span class="identifier">size_</span> <span class="special">=</span> <span class="identifier">count</span><span class="special">;</span>
4395    <span class="special">}</span>
4396
4397
4398
4399
4400
4401
4402
4403
4404
4405
4406    <span class="identifier">T</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">[](</span><span class="keyword">int</span> <span class="identifier">index</span><span class="special">)</span> <span class="special">{</span> <span class="keyword">return</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">index</span><span class="special">];</span> <span class="special">}</span>
4407
4408
4409
4410
4411
4412
4413
4414
4415
4416
4417    <span class="identifier">T</span><span class="special">&amp;</span> <span class="keyword">operator</span><span class="special">[](</span><span class="keyword">int</span> <span class="identifier">index</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span> <span class="keyword">return</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">index</span><span class="special">];</span> <span class="special">}</span>
4418
4419
4420
4421
4422<span class="identifier">axioms</span><span class="special">:</span> <span class="comment">// Preconditions (require) and postconditions (promise) for each func.</span>
4423    <span class="special">[</span><span class="keyword">int</span> <span class="identifier">count</span><span class="special">;</span> <span class="identifier">require</span> <span class="identifier">count</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">promise</span> <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">]</span> <span class="identifier">vector</span><span class="special">(</span><span class="identifier">count</span><span class="special">);</span>
4424    <span class="special">[</span><span class="keyword">int</span> <span class="identifier">count</span><span class="special">;</span> <span class="identifier">require</span> <span class="identifier">count</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">promise</span> <span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">]</span> <span class="identifier">resize</span><span class="special">(</span><span class="identifier">count</span><span class="special">);</span>
4425    <span class="special">[</span><span class="keyword">int</span> <span class="identifier">index</span><span class="special">;</span> <span class="identifier">require</span> <span class="identifier">index</span> <span class="special">&gt;=</span> <span class="number">0</span> <span class="special">&amp;&amp;</span> <span class="identifier">index</span> <span class="special">&lt;</span> <span class="identifier">size</span><span class="special">()]</span> <span class="special">(*</span><span class="keyword">this</span><span class="special">)[</span><span class="identifier">x</span><span class="special">];</span>       <span class="comment">// Op[].</span>
4426    <span class="special">[</span><span class="keyword">int</span> <span class="identifier">index</span><span class="special">;</span> <span class="identifier">require</span> <span class="identifier">index</span> <span class="special">&gt;=</span> <span class="number">0</span> <span class="special">&amp;&amp;</span> <span class="identifier">index</span> <span class="special">&lt;</span> <span class="identifier">size</span><span class="special">()]</span> <span class="special">(*</span><span class="keyword">this</span><span class="special">)[</span><span class="identifier">x</span><span class="special">]</span> <span class="keyword">const</span><span class="special">;</span> <span class="comment">// Op[].</span>
4427
4428<span class="keyword">private</span><span class="special">:</span>
4429    <span class="identifier">T</span><span class="special">*</span> <span class="identifier">data_</span><span class="special">;</span>
4430    <span class="keyword">int</span> <span class="identifier">size_</span><span class="special">;</span>
4431<span class="special">};</span>
4432
4433<span class="comment">// End.</span>
4434</pre>
4435<p>
4436                </p>
4437              </td>
4438</tr>
4439<tr>
4440<td>
4441                <p>
4442</p>
4443<pre xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" class="table-programlisting"><span class="preprocessor">#include</span> <span class="string">"vector.hpp"</span>
4444<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
4445
4446<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
4447    <span class="identifier">vector</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">v</span> <span class="special">(</span><span class="number">3</span><span class="special">);</span>
4448    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">v</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">3</span><span class="special">);</span>
4449
4450    <span class="identifier">v</span><span class="special">[</span><span class="number">0</span><span class="special">]</span> <span class="special">=</span> <span class="number">123</span><span class="special">;</span>
4451    <span class="identifier">v</span><span class="special">.</span><span class="identifier">resize</span><span class="special">(</span><span class="number">2</span><span class="special">);</span>
4452    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">v</span><span class="special">[</span><span class="number">0</span><span class="special">]</span> <span class="special">==</span> <span class="number">123</span><span class="special">);</span>
4453    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">v</span><span class="special">.</span><span class="identifier">size</span><span class="special">()</span> <span class="special">==</span> <span class="number">2</span><span class="special">);</span>
4454
4455    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
4456<span class="special">}</span>
4457</pre>
4458<p>
4459                </p>
4460              </td>
4461<td>
4462              </td>
4463</tr>
4464</tbody>
4465</table></div>
4466</div>
4467<div class="section">
4468<div class="titlepage"><div><div><h3 class="title">
4469<a name="boost_contract.examples.__cline90___stack__stack_like_container"></a><a class="link" href="examples.html#boost_contract.examples.__cline90___stack__stack_like_container" title="[Cline90] Stack: Stack-like container">[Cline90]
4470      Stack: Stack-like container</a>
4471</h3></div></div></div>
4472<p>
4473</p>
4474<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4475<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
4476
4477<span class="comment">// NOTE: Incomplete contract assertions, addressing only `empty` and `full`.</span>
4478<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4479<span class="keyword">class</span> <span class="identifier">stack</span>
4480    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">private</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">stack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;</span>
4481    <span class="special">:</span> <span class="identifier">BASES</span>
4482<span class="special">{</span>
4483    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
4484
4485    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
4486    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
4487
4488<span class="keyword">public</span><span class="special">:</span>
4489    <span class="keyword">explicit</span> <span class="identifier">stack</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">capacity</span><span class="special">)</span> <span class="special">:</span>
4490        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">stack</span><span class="special">&gt;([&amp;]</span> <span class="special">{</span>
4491            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4492        <span class="special">}),</span>
4493        <span class="identifier">data_</span><span class="special">(</span><span class="keyword">new</span> <span class="identifier">T</span><span class="special">[</span><span class="identifier">capacity</span><span class="special">]),</span> <span class="identifier">capacity_</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">),</span> <span class="identifier">size_</span><span class="special">(</span><span class="number">0</span><span class="special">)</span>
4494    <span class="special">{</span>
4495        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4496            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4497                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">());</span>
4498                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">full</span><span class="special">()</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">capacity</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span>
4499            <span class="special">})</span>
4500        <span class="special">;</span>
4501
4502        <span class="keyword">for</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">i</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span> <span class="identifier">i</span> <span class="special">&lt;</span> <span class="identifier">capacity_</span><span class="special">;</span> <span class="special">++</span><span class="identifier">i</span><span class="special">)</span> <span class="identifier">data_</span><span class="special">[</span><span class="identifier">i</span><span class="special">]</span> <span class="special">=</span> <span class="identifier">T</span><span class="special">();</span>
4503    <span class="special">}</span>
4504
4505    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">stack</span><span class="special">()</span> <span class="special">{</span>
4506        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4507        <span class="keyword">delete</span><span class="special">[]</span> <span class="identifier">data_</span><span class="special">;</span>
4508    <span class="special">}</span>
4509
4510    <span class="keyword">bool</span> <span class="identifier">empty</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4511        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4512        <span class="keyword">return</span> <span class="identifier">size_</span> <span class="special">==</span> <span class="number">0</span><span class="special">;</span>
4513    <span class="special">}</span>
4514
4515    <span class="keyword">bool</span> <span class="identifier">full</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4516        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4517        <span class="keyword">return</span> <span class="identifier">size_</span> <span class="special">==</span> <span class="identifier">capacity_</span><span class="special">;</span>
4518    <span class="special">}</span>
4519
4520    <span class="keyword">void</span> <span class="identifier">push</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">)</span> <span class="special">{</span>
4521        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4522            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4523                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">full</span><span class="special">());</span>
4524            <span class="special">})</span>
4525            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4526                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
4527            <span class="special">})</span>
4528        <span class="special">;</span>
4529
4530        <span class="identifier">data_</span><span class="special">[</span><span class="identifier">size_</span><span class="special">++]</span> <span class="special">=</span> <span class="identifier">value</span><span class="special">;</span>
4531    <span class="special">}</span>
4532
4533    <span class="identifier">T</span> <span class="identifier">pop</span><span class="special">()</span> <span class="special">{</span>
4534        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4535            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4536                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
4537            <span class="special">})</span>
4538            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4539                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">full</span><span class="special">());</span>
4540            <span class="special">})</span>
4541        <span class="special">;</span>
4542
4543        <span class="keyword">return</span> <span class="identifier">data_</span><span class="special">[--</span><span class="identifier">size_</span><span class="special">];</span>
4544    <span class="special">}</span>
4545
4546<span class="keyword">private</span><span class="special">:</span>
4547    <span class="identifier">T</span><span class="special">*</span> <span class="identifier">data_</span><span class="special">;</span>
4548    <span class="keyword">int</span> <span class="identifier">capacity_</span><span class="special">;</span>
4549    <span class="keyword">int</span> <span class="identifier">size_</span><span class="special">;</span>
4550<span class="special">};</span>
4551
4552<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
4553    <span class="identifier">stack</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">s</span><span class="special">(</span><span class="number">3</span><span class="special">);</span>
4554    <span class="identifier">s</span><span class="special">.</span><span class="identifier">push</span><span class="special">(</span><span class="number">123</span><span class="special">);</span>
4555    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">pop</span><span class="special">()</span> <span class="special">==</span> <span class="number">123</span><span class="special">);</span>
4556    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
4557<span class="special">}</span>
4558</pre>
4559<p>
4560      </p>
4561</div>
4562<div class="section">
4563<div class="titlepage"><div><div><h3 class="title">
4564<a name="boost_contract.examples.__cline90___vector_stack__subcontracting"></a><a class="link" href="examples.html#boost_contract.examples.__cline90___vector_stack__subcontracting" title="[Cline90] Vector-Stack: Subcontracting">[Cline90]
4565      Vector-Stack: Subcontracting</a>
4566</h3></div></div></div>
4567<p>
4568</p>
4569<pre class="programlisting"><span class="preprocessor">#include</span> <span class="string">"vector.hpp"</span>
4570<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4571<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">optional</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4572<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
4573
4574<span class="comment">// NOTE: Incomplete contract assertions, addressing only `empty` and `full`.</span>
4575<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4576<span class="keyword">class</span> <span class="identifier">abstract_stack</span> <span class="special">{</span>
4577<span class="keyword">public</span><span class="special">:</span>
4578    <span class="identifier">abstract_stack</span><span class="special">()</span> <span class="special">{</span>
4579        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4580            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4581                <span class="comment">// AXIOM as empty() cannot actually be checked here to avoid</span>
4582                <span class="comment">// calling pure virtual function length() during construction).</span>
4583                <span class="identifier">BOOST_CONTRACT_ASSERT_AXIOM</span><span class="special">(</span><span class="identifier">empty</span><span class="special">());</span>
4584            <span class="special">})</span>
4585        <span class="special">;</span>
4586    <span class="special">}</span>
4587
4588    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">abstract_stack</span><span class="special">()</span> <span class="special">{</span>
4589        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4590    <span class="special">}</span>
4591
4592    <span class="keyword">bool</span> <span class="identifier">full</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4593        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
4594        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4595            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4596                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">==</span> <span class="special">(</span><span class="identifier">length</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">capacity</span><span class="special">()));</span>
4597            <span class="special">})</span>
4598        <span class="special">;</span>
4599
4600        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">length</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">capacity</span><span class="special">());</span>
4601    <span class="special">}</span>
4602
4603    <span class="keyword">bool</span> <span class="identifier">empty</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4604        <span class="keyword">bool</span> <span class="identifier">result</span><span class="special">;</span>
4605        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4606            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4607                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">length</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">));</span>
4608            <span class="special">})</span>
4609        <span class="special">;</span>
4610
4611        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="special">(</span><span class="identifier">length</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
4612    <span class="special">}</span>
4613
4614    <span class="keyword">virtual</span> <span class="keyword">int</span> <span class="identifier">length</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
4615    <span class="keyword">virtual</span> <span class="keyword">int</span> <span class="identifier">capacity</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
4616
4617    <span class="keyword">virtual</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">item</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
4618
4619    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">push</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
4620    <span class="keyword">virtual</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">pop</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
4621
4622    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">clear</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
4623<span class="special">};</span>
4624
4625<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4626<span class="keyword">int</span> <span class="identifier">abstract_stack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">length</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
4627    <span class="keyword">int</span> <span class="identifier">result</span><span class="special">;</span>
4628    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
4629        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">(</span><span class="keyword">int</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
4630            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4631        <span class="special">})</span>
4632    <span class="special">;</span>
4633    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
4634    <span class="keyword">return</span> <span class="identifier">result</span><span class="special">;</span>
4635<span class="special">}</span>
4636
4637<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4638<span class="keyword">int</span> <span class="identifier">abstract_stack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">capacity</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
4639    <span class="keyword">int</span> <span class="identifier">result</span><span class="special">;</span>
4640    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
4641        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">(</span><span class="keyword">int</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
4642            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4643        <span class="special">})</span>
4644    <span class="special">;</span>
4645    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
4646    <span class="keyword">return</span> <span class="identifier">result</span><span class="special">;</span>
4647<span class="special">}</span>
4648
4649<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4650<span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">abstract_stack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">item</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="keyword">const</span> <span class="special">{</span>
4651    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;</span> <span class="identifier">result</span><span class="special">;</span>
4652    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
4653        <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4654            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
4655        <span class="special">})</span>
4656    <span class="special">;</span>
4657    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
4658    <span class="keyword">return</span> <span class="special">*</span><span class="identifier">result</span><span class="special">;</span>
4659<span class="special">}</span>
4660
4661<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4662<span class="keyword">void</span> <span class="identifier">abstract_stack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">push</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="special">{</span>
4663    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
4664        <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4665            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">full</span><span class="special">());</span>
4666        <span class="special">})</span>
4667        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4668            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
4669        <span class="special">})</span>
4670    <span class="special">;</span>
4671    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
4672<span class="special">}</span>
4673
4674<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4675<span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">abstract_stack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">pop</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="special">{</span>
4676    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;</span> <span class="identifier">result</span><span class="special">;</span>
4677    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">old_ptr</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="identifier">old_item</span> <span class="special">=</span> <span class="identifier">BOOST_CONTRACT_OLDOF</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">item</span><span class="special">());</span>
4678    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
4679        <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4680            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">empty</span><span class="special">());</span>
4681        <span class="special">})</span>
4682        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">result</span><span class="special">)</span> <span class="special">{</span>
4683            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(!</span><span class="identifier">full</span><span class="special">());</span>
4684            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(*</span><span class="identifier">result</span> <span class="special">==</span> <span class="special">*</span><span class="identifier">old_item</span><span class="special">);</span>
4685        <span class="special">})</span>
4686    <span class="special">;</span>
4687    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
4688    <span class="keyword">return</span> <span class="special">*</span><span class="identifier">result</span><span class="special">;</span>
4689<span class="special">}</span>
4690
4691<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4692<span class="keyword">void</span> <span class="identifier">abstract_stack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;::</span><span class="identifier">clear</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span><span class="special">)</span> <span class="special">{</span>
4693    <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="identifier">v</span><span class="special">,</span> <span class="keyword">this</span><span class="special">)</span>
4694        <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4695            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">empty</span><span class="special">());</span>
4696        <span class="special">})</span>
4697    <span class="special">;</span>
4698    <span class="identifier">assert</span><span class="special">(</span><span class="keyword">false</span><span class="special">);</span>
4699<span class="special">}</span>
4700
4701<span class="keyword">template</span><span class="special">&lt;</span><span class="keyword">typename</span> <span class="identifier">T</span><span class="special">&gt;</span>
4702<span class="keyword">class</span> <span class="identifier">vstack</span>
4703    <span class="preprocessor">#define</span> <span class="identifier">BASES</span> <span class="keyword">private</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span> <span class="special">\</span>
4704            <span class="identifier">vstack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="special">&gt;,</span> <span class="keyword">public</span> <span class="identifier">abstract_stack</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span>
4705    <span class="special">:</span> <span class="identifier">BASES</span>
4706<span class="special">{</span>
4707    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
4708
4709    <span class="keyword">typedef</span> <span class="identifier">BOOST_CONTRACT_BASE_TYPES</span><span class="special">(</span><span class="identifier">BASES</span><span class="special">)</span> <span class="identifier">base_types</span><span class="special">;</span>
4710    <span class="preprocessor">#undef</span> <span class="identifier">BASES</span>
4711
4712    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4713        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">length</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4714        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">length</span><span class="special">()</span> <span class="special">&lt;</span> <span class="identifier">capacity</span><span class="special">());</span>
4715    <span class="special">}</span>
4716
4717    <span class="identifier">BOOST_CONTRACT_OVERRIDES</span><span class="special">(</span><span class="identifier">length</span><span class="special">,</span> <span class="identifier">capacity</span><span class="special">,</span> <span class="identifier">item</span><span class="special">,</span> <span class="identifier">push</span><span class="special">,</span> <span class="identifier">pop</span><span class="special">,</span> <span class="identifier">clear</span><span class="special">)</span>
4718
4719<span class="keyword">public</span><span class="special">:</span>
4720    <span class="keyword">explicit</span> <span class="identifier">vstack</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">count</span> <span class="special">=</span> <span class="number">10</span><span class="special">)</span> <span class="special">:</span>
4721        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor_precondition</span><span class="special">&lt;</span><span class="identifier">vstack</span><span class="special">&gt;([&amp;]</span> <span class="special">{</span>
4722            <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">count</span> <span class="special">&gt;=</span> <span class="number">0</span><span class="special">);</span>
4723        <span class="special">}),</span>
4724        <span class="identifier">vect_</span><span class="special">(</span><span class="identifier">count</span><span class="special">),</span> <span class="comment">// OK, executed after precondition so count &gt;= 0.</span>
4725        <span class="identifier">len_</span><span class="special">(</span><span class="number">0</span><span class="special">)</span>
4726    <span class="special">{</span>
4727        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4728            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4729                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">length</span><span class="special">()</span> <span class="special">==</span> <span class="number">0</span><span class="special">);</span>
4730                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">count</span><span class="special">);</span>
4731            <span class="special">})</span>
4732        <span class="special">;</span>
4733    <span class="special">}</span>
4734
4735    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">vstack</span><span class="special">()</span> <span class="special">{</span>
4736        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4737    <span class="special">}</span>
4738
4739    <span class="comment">// Inherited from abstract_stack.</span>
4740
4741    <span class="keyword">virtual</span> <span class="keyword">int</span> <span class="identifier">length</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="keyword">const</span> <span class="comment">/* override */</span> <span class="special">{</span>
4742        <span class="keyword">int</span> <span class="identifier">result</span><span class="special">;</span>
4743        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4744                <span class="identifier">override_length</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">vstack</span><span class="special">::</span><span class="identifier">length</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
4745        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">len_</span><span class="special">;</span>
4746    <span class="special">}</span>
4747
4748    <span class="keyword">virtual</span> <span class="keyword">int</span> <span class="identifier">capacity</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
4749            <span class="keyword">const</span> <span class="comment">/* override */</span> <span class="special">{</span>
4750        <span class="keyword">int</span> <span class="identifier">result</span><span class="special">;</span>
4751        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4752                <span class="identifier">override_capacity</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">vstack</span><span class="special">::</span><span class="identifier">capacity</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
4753        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">.</span><span class="identifier">size</span><span class="special">();</span>
4754    <span class="special">}</span>
4755
4756    <span class="keyword">virtual</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">item</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
4757            <span class="keyword">const</span> <span class="comment">/* override */</span> <span class="special">{</span>
4758        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;</span> <span class="identifier">result</span><span class="special">;</span>
4759        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4760                <span class="identifier">override_item</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">vstack</span><span class="special">::</span><span class="identifier">item</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
4761        <span class="keyword">return</span> <span class="special">*(</span><span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">[</span><span class="identifier">len_</span> <span class="special">-</span> <span class="number">1</span><span class="special">]);</span>
4762    <span class="special">}</span>
4763
4764    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">push</span><span class="special">(</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">value</span><span class="special">,</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span>
4765            <span class="comment">/* override */</span> <span class="special">{</span>
4766        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4767                <span class="identifier">override_push</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">vstack</span><span class="special">::</span><span class="identifier">push</span><span class="special">,</span> <span class="keyword">this</span><span class="special">,</span> <span class="identifier">value</span><span class="special">);</span>
4768        <span class="identifier">vect_</span><span class="special">[</span><span class="identifier">len_</span><span class="special">++]</span> <span class="special">=</span> <span class="identifier">value</span><span class="special">;</span>
4769    <span class="special">}</span>
4770
4771    <span class="keyword">virtual</span> <span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;</span> <span class="identifier">pop</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="comment">/* override */</span> <span class="special">{</span>
4772        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">optional</span><span class="special">&lt;</span><span class="identifier">T</span> <span class="keyword">const</span><span class="special">&amp;&gt;</span> <span class="identifier">result</span><span class="special">;</span>
4773        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4774                <span class="identifier">override_pop</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="identifier">result</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">vstack</span><span class="special">::</span><span class="identifier">pop</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
4775        <span class="keyword">return</span> <span class="special">*(</span><span class="identifier">result</span> <span class="special">=</span> <span class="identifier">vect_</span><span class="special">[--</span><span class="identifier">len_</span><span class="special">]);</span>
4776    <span class="special">}</span>
4777
4778    <span class="keyword">virtual</span> <span class="keyword">void</span> <span class="identifier">clear</span><span class="special">(</span><span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">virtual_</span><span class="special">*</span> <span class="identifier">v</span> <span class="special">=</span> <span class="number">0</span><span class="special">)</span> <span class="comment">/* override */</span> <span class="special">{</span>
4779        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">&lt;</span>
4780                <span class="identifier">override_clear</span><span class="special">&gt;(</span><span class="identifier">v</span><span class="special">,</span> <span class="special">&amp;</span><span class="identifier">vstack</span><span class="special">::</span><span class="identifier">clear</span><span class="special">,</span> <span class="keyword">this</span><span class="special">);</span>
4781        <span class="identifier">len_</span> <span class="special">=</span> <span class="number">0</span><span class="special">;</span>
4782    <span class="special">}</span>
4783
4784<span class="keyword">private</span><span class="special">:</span>
4785    <span class="identifier">vector</span><span class="special">&lt;</span><span class="identifier">T</span><span class="special">&gt;</span> <span class="identifier">vect_</span><span class="special">;</span>
4786    <span class="keyword">int</span> <span class="identifier">len_</span><span class="special">;</span>
4787<span class="special">};</span>
4788
4789<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
4790    <span class="identifier">vstack</span><span class="special">&lt;</span><span class="keyword">int</span><span class="special">&gt;</span> <span class="identifier">s</span><span class="special">(</span><span class="number">3</span><span class="special">);</span>
4791    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">capacity</span><span class="special">()</span> <span class="special">==</span> <span class="number">3</span><span class="special">);</span>
4792
4793    <span class="identifier">s</span><span class="special">.</span><span class="identifier">push</span><span class="special">(</span><span class="number">123</span><span class="special">);</span>
4794    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">length</span><span class="special">()</span> <span class="special">==</span> <span class="number">1</span><span class="special">);</span>
4795    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">s</span><span class="special">.</span><span class="identifier">pop</span><span class="special">()</span> <span class="special">==</span> <span class="number">123</span><span class="special">);</span>
4796
4797    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
4798<span class="special">}</span>
4799</pre>
4800<p>
4801      </p>
4802</div>
4803<div class="section">
4804<div class="titlepage"><div><div><h3 class="title">
4805<a name="boost_contract.examples.__cline90___calendar__a_very_simple_calendar"></a><a class="link" href="examples.html#boost_contract.examples.__cline90___calendar__a_very_simple_calendar" title="[Cline90] Calendar: A very simple calendar">[Cline90]
4806      Calendar: A very simple calendar</a>
4807</h3></div></div></div>
4808<p>
4809</p>
4810<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">contract</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span>
4811<span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">cassert</span><span class="special">&gt;</span>
4812
4813<span class="keyword">class</span> <span class="identifier">calendar</span> <span class="special">{</span>
4814    <span class="keyword">friend</span> <span class="keyword">class</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">access</span><span class="special">;</span>
4815
4816    <span class="keyword">void</span> <span class="identifier">invariant</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4817        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">month</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">1</span><span class="special">);</span>
4818        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">month</span><span class="special">()</span> <span class="special">&lt;=</span> <span class="number">12</span><span class="special">);</span>
4819        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">date</span><span class="special">()</span> <span class="special">&gt;=</span> <span class="number">1</span><span class="special">);</span>
4820        <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">date</span><span class="special">()</span> <span class="special">&lt;=</span> <span class="identifier">days_in</span><span class="special">(</span><span class="identifier">month</span><span class="special">()));</span>
4821    <span class="special">}</span>
4822
4823<span class="keyword">public</span><span class="special">:</span>
4824    <span class="identifier">calendar</span><span class="special">()</span> <span class="special">:</span> <span class="identifier">month_</span><span class="special">(</span><span class="number">1</span><span class="special">),</span> <span class="identifier">date_</span><span class="special">(</span><span class="number">31</span><span class="special">)</span> <span class="special">{</span>
4825        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">constructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4826            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4827                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">month</span><span class="special">()</span> <span class="special">==</span> <span class="number">1</span><span class="special">);</span>
4828                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">date</span><span class="special">()</span> <span class="special">==</span> <span class="number">31</span><span class="special">);</span>
4829            <span class="special">})</span>
4830        <span class="special">;</span>
4831    <span class="special">}</span>
4832
4833    <span class="keyword">virtual</span> <span class="special">~</span><span class="identifier">calendar</span><span class="special">()</span> <span class="special">{</span>
4834        <span class="comment">// Check invariants.</span>
4835        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">destructor</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4836    <span class="special">}</span>
4837
4838    <span class="keyword">int</span> <span class="identifier">month</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4839        <span class="comment">// Check invariants.</span>
4840        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4841        <span class="keyword">return</span> <span class="identifier">month_</span><span class="special">;</span>
4842    <span class="special">}</span>
4843
4844    <span class="keyword">int</span> <span class="identifier">date</span><span class="special">()</span> <span class="keyword">const</span> <span class="special">{</span>
4845        <span class="comment">// Check invariants.</span>
4846        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">);</span>
4847        <span class="keyword">return</span> <span class="identifier">date_</span><span class="special">;</span>
4848    <span class="special">}</span>
4849
4850    <span class="keyword">void</span> <span class="identifier">reset</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">new_month</span><span class="special">)</span> <span class="special">{</span>
4851        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">public_function</span><span class="special">(</span><span class="keyword">this</span><span class="special">)</span>
4852            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4853                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">new_month</span> <span class="special">&gt;=</span> <span class="number">1</span><span class="special">);</span>
4854                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">new_month</span> <span class="special">&lt;=</span> <span class="number">12</span><span class="special">);</span>
4855            <span class="special">})</span>
4856            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4857                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">month</span><span class="special">()</span> <span class="special">==</span> <span class="identifier">new_month</span><span class="special">);</span>
4858            <span class="special">})</span>
4859        <span class="special">;</span>
4860
4861        <span class="identifier">month_</span> <span class="special">=</span> <span class="identifier">new_month</span><span class="special">;</span>
4862    <span class="special">}</span>
4863
4864<span class="keyword">private</span><span class="special">:</span>
4865    <span class="keyword">static</span> <span class="keyword">int</span> <span class="identifier">days_in</span><span class="special">(</span><span class="keyword">int</span> <span class="identifier">month</span><span class="special">)</span> <span class="special">{</span>
4866        <span class="keyword">int</span> <span class="identifier">result</span><span class="special">;</span>
4867        <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">check</span> <span class="identifier">c</span> <span class="special">=</span> <span class="identifier">boost</span><span class="special">::</span><span class="identifier">contract</span><span class="special">::</span><span class="identifier">function</span><span class="special">()</span>
4868            <span class="special">.</span><span class="identifier">precondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4869                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">month</span> <span class="special">&gt;=</span> <span class="number">1</span><span class="special">);</span>
4870                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">month</span> <span class="special">&lt;=</span> <span class="number">12</span><span class="special">);</span>
4871            <span class="special">})</span>
4872            <span class="special">.</span><span class="identifier">postcondition</span><span class="special">([&amp;]</span> <span class="special">{</span>
4873                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&gt;=</span> <span class="number">1</span><span class="special">);</span>
4874                <span class="identifier">BOOST_CONTRACT_ASSERT</span><span class="special">(</span><span class="identifier">result</span> <span class="special">&lt;=</span> <span class="number">31</span><span class="special">);</span>
4875            <span class="special">})</span>
4876        <span class="special">;</span>
4877
4878        <span class="keyword">return</span> <span class="identifier">result</span> <span class="special">=</span> <span class="number">31</span><span class="special">;</span> <span class="comment">// For simplicity, assume all months have 31 days.</span>
4879    <span class="special">}</span>
4880
4881    <span class="keyword">int</span> <span class="identifier">month_</span><span class="special">,</span> <span class="identifier">date_</span><span class="special">;</span>
4882<span class="special">};</span>
4883
4884<span class="keyword">int</span> <span class="identifier">main</span><span class="special">()</span> <span class="special">{</span>
4885    <span class="identifier">calendar</span> <span class="identifier">cal</span><span class="special">;</span>
4886    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">cal</span><span class="special">.</span><span class="identifier">date</span><span class="special">()</span> <span class="special">==</span> <span class="number">31</span><span class="special">);</span>
4887    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">cal</span><span class="special">.</span><span class="identifier">month</span><span class="special">()</span> <span class="special">==</span> <span class="number">1</span><span class="special">);</span>
4888
4889    <span class="identifier">cal</span><span class="special">.</span><span class="identifier">reset</span><span class="special">(</span><span class="number">8</span><span class="special">);</span> <span class="comment">// Set month </span>
4890    <span class="identifier">assert</span><span class="special">(</span><span class="identifier">cal</span><span class="special">.</span><span class="identifier">month</span><span class="special">()</span> <span class="special">==</span> <span class="number">8</span><span class="special">);</span>
4891
4892    <span class="keyword">return</span> <span class="number">0</span><span class="special">;</span>
4893<span class="special">}</span>
4894</pre>
4895<p>
4896      </p>
4897</div>
4898</div>
4899<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
4900<td align="left"></td>
4901<td align="right"><div class="copyright-footer">Copyright © 2008-2019 Lorenzo Caminiti<p>
4902        Distributed under the Boost Software License, Version 1.0 (see accompanying
4903        file LICENSE_1_0.txt or a copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
4904      </p>
4905</div></td>
4906</tr></table>
4907<hr>
4908<div class="spirit-nav">
4909<a accesskey="p" href="extras.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../index.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="../reference.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
4910</div>
4911</body>
4912</html>
4913