Updated documentation

git-svn-id: https://svn.code.sf.net/p/turtle/code/trunk@579 860be788-9bd5-4423-9f1e-828f051e677b

build/boost/doc/example/retrieve_cref.cpp

@@ -0,0 +1,42 @@
+//[ retrieve_cref_problem
+namespace
+{
+    class base_class
+    {
+    public:
+        virtual void method( int value ) = 0;
+    };
+
+    class my_class
+    {
+    public:
+        explicit my_class( base_class& );
+
+        void process(); // the processing will call 'method' two times with the same value, but we don't know what value beforehand
+    };
+}
+//]
+
+//[ retrieve_cref_solution
+#define BOOST_AUTO_TEST_MAIN
+#include <boost/test/auto_unit_test.hpp>
+#include <turtle/mock.hpp>
+
+namespace
+{
+    MOCK_BASE_CLASS( mock_base_class, base_class )
+    {
+        MOCK_METHOD( method, 1 )
+    };
+}
+
+BOOST_AUTO_TEST_CASE( method_is_called_two_times_with_the_same_value )
+{
+    mock_base_class mock;
+    my_class c( mock );
+    int value;
+    MOCK_EXPECT( mock.method ).once().with( mock::retrieve( value ) ); // on first call retrieve the value, this expectation takes precedence because it can never fail
+    MOCK_EXPECT( mock.method ).once().with( boost::cref( value ) );    // on second call compare the previously retrieved value with the newly received one
+    c.process();
+}
+//]