doc

Author: jll63

doc/modules/ROOT/examples/rolex/1/employee.cpp

@@ -0,0 +1,16 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+#include "roles.hpp"
+#include <boost/openmethod.hpp>
+
+BOOST_OPENMETHOD_OVERRIDE(
+    pay, (boost::openmethod::virtual_ptr<const Employee>), double) {
+    return 5000.0;
+}
+
+BOOST_OPENMETHOD_CLASSES(Employee)
+// end::content[]

doc/modules/ROOT/examples/rolex/1/main.cpp

@@ -0,0 +1,23 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+// main.cpp
+
+#include "roles.hpp"
+#include <iostream>
+
+#include <boost/openmethod/initialize.hpp>
+
+int main() {
+    boost::openmethod::initialize();
+
+    Employee bill;
+    Salesman bob; bob.sales = 100'000.0;
+
+    std::cout << "pay bill: $" << pay(bill) << "\n"; // pay bill: $5000
+    std::cout << "pay bob: $" << pay(bob) << "\n"; // pay bob: $10000
+}
+// end::content[]

doc/modules/ROOT/examples/rolex/1/roles.hpp

@@ -0,0 +1,23 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+// roles.hpp
+
+#ifndef ROLES_HPP
+#define ROLES_HPP
+
+#include <boost/openmethod.hpp>
+
+struct Employee { virtual ~Employee() = default; };
+
+struct Salesman : Employee {
+    double sales = 0.0;
+};
+
+BOOST_OPENMETHOD(pay, (boost::openmethod::virtual_ptr<const Employee>), double);
+
+#endif // ROLES_HPP
+// end::content[]

doc/modules/ROOT/examples/rolex/1/salesman.cpp

@@ -0,0 +1,17 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+#include "roles.hpp"
+#include <boost/openmethod.hpp>
+
+BOOST_OPENMETHOD_OVERRIDE(
+    pay, (boost::openmethod::virtual_ptr<const Salesman> emp), double) {
+    return next(emp) + emp->sales * 0.05; // base + commission
+}
+
+BOOST_OPENMETHOD_CLASSES(Employee, Salesman)
+
+// end::content[]

doc/modules/ROOT/examples/rolex/2/employee.cpp

@@ -0,0 +1,16 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+#include "roles.hpp"
+#include <boost/openmethod.hpp>
+
+BOOST_OPENMETHOD_DEFINE_OVERRIDER(
+    pay, (boost::openmethod::virtual_ptr<const Employee>), double) {
+    return 5000.0;
+}
+
+BOOST_OPENMETHOD_CLASSES(Employee)
+// end::content[]

doc/modules/ROOT/examples/rolex/2/main.cpp

@@ -0,0 +1,23 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+// main.cpp
+
+#include "roles.hpp"
+#include <iostream>
+
+#include <boost/openmethod/initialize.hpp>
+
+int main() {
+    boost::openmethod::initialize();
+
+    Employee bill;
+    Salesman bob; bob.sales = 100'000.0;
+
+    std::cout << "pay bill: $" << pay(bill) << "\n"; // pay bill: $5000
+    std::cout << "pay bob: $" << pay(bob) << "\n"; // pay bob: $10000
+}
+// end::content[]

doc/modules/ROOT/examples/rolex/2/roles.hpp

@@ -0,0 +1,27 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+// roles.hpp
+
+#ifndef ROLES_HPP
+#define ROLES_HPP
+
+#include <boost/openmethod.hpp>
+
+struct Employee { virtual ~Employee() = default; };
+
+struct Salesman : Employee {
+    double sales = 0.0;
+};
+
+BOOST_OPENMETHOD(pay, (boost::openmethod::virtual_ptr<const Employee>), double);
+
+BOOST_OPENMETHOD_DECLARE_OVERRIDER(
+    pay, (boost::openmethod::virtual_ptr<const Employee>), double);
+
+
+#endif // ROLES_HPP
+// end::content[]

doc/modules/ROOT/examples/rolex/2/salesman.cpp

@@ -0,0 +1,19 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+#include "roles.hpp"
+#include <boost/openmethod.hpp>
+
+// tag::content[]
+BOOST_OPENMETHOD_OVERRIDE(
+    pay, (boost::openmethod::virtual_ptr<const Salesman> emp), double) {
+    return BOOST_OPENMETHOD_OVERRIDER(
+               pay, (boost::openmethod::virtual_ptr<const Employee> emp),
+               double)::fn(emp) +
+        emp->sales * 0.05; // base + commission
+}
+// end::content[]
+
+BOOST_OPENMETHOD_CLASSES(Employee, Salesman)

doc/modules/ROOT/examples/rolex/3/employee.cpp

@@ -0,0 +1,11 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+#include "roles.hpp"
+#include <boost/openmethod.hpp>
+
+BOOST_OPENMETHOD_CLASSES(Employee)
+// end::content[]

doc/modules/ROOT/examples/rolex/3/main.cpp

@@ -0,0 +1,23 @@
+// Copyright (c) 2018-2025 Jean-Louis Leroy
+// Distributed under the Boost Software License, Version 1.0.
+// See accompanying file LICENSE_1_0.txt
+// or copy at http://www.boost.org/LICENSE_1_0.txt)
+
+// tag::content[]
+// main.cpp
+
+#include "roles.hpp"
+#include <iostream>
+
+#include <boost/openmethod/initialize.hpp>
+
+int main() {
+    boost::openmethod::initialize();
+
+    Employee bill;
+    Salesman bob; bob.sales = 100'000.0;
+
+    std::cout << "pay bill: $" << pay(bill) << "\n"; // pay bill: $5000
+    std::cout << "pay bob: $" << pay(bob) << "\n"; // pay bob: $10000
+}
+// end::content[]