1 /* Copyright (c) 2015-2022. The SimGrid Team. All rights reserved. */
3 /* This program is free software; you can redistribute it and/or modify it
4 * under the terms of the license (GNU LGPL) which comes with this package. */
6 #ifndef XBT_PROMISE_HPP
7 #define XBT_PROMISE_HPP
11 #include <boost/variant.hpp>
14 #include <future> // std::future_error
16 #include <type_traits>
23 /** A value or an exception (or nothing)
25 * This is similar to `optional<expected<T>>`` but it with a Future/Promise
28 * Also the name is not so great.
30 template <class T> class Result {
32 bool is_valid() const { return value_.which() > 0; }
33 void set_exception(std::exception_ptr e) { value_ = std::move(e); }
34 void set_value(T&& value) { value_ = std::move(value); }
35 void set_value(T const& value) { value_ = value; }
37 /** Extract the value from the future
39 * After this, the value is invalid.
43 switch (value_.which()) {
45 T value = std::move(boost::get<T>(value_));
46 value_ = boost::blank();
50 std::exception_ptr exception = std::move(boost::get<std::exception_ptr>(value_));
51 value_ = boost::blank();
52 std::rethrow_exception(std::move(exception));
56 throw std::future_error(std::future_errc::no_state);
61 boost::variant<boost::blank, T, std::exception_ptr> value_;
64 template <> class Result<void> : public Result<std::nullptr_t> {
66 void set_value() { Result<std::nullptr_t>::set_value(nullptr); }
67 void get() { Result<std::nullptr_t>::get(); }
70 template <class T> class Result<T&> : public Result<std::reference_wrapper<T>> {
72 void set_value(T& value) { Result<std::reference_wrapper<T>>::set_value(std::ref(value)); }
73 T& get() { return Result<std::reference_wrapper<T>>::get(); }
76 /** Execute some code and set a promise or result accordingly
81 * promise.set_value(code());
84 * but it takes care of exceptions and works with `void`.
86 * We might need this when working with generic code because
87 * the trivial implementation does not work with `void` (before C++1z).
89 * @param code What we want to do
90 * @param promise Where to want to store the result
92 template <class R, class F> auto fulfill_promise(R& promise, F&& code) -> decltype(promise.set_value(code()))
95 promise.set_value(std::forward<F>(code)());
97 promise.set_exception(std::current_exception());
101 template <class R, class F> auto fulfill_promise(R& promise, F&& code) -> decltype(promise.set_value())
104 std::forward<F>(code)();
107 promise.set_exception(std::current_exception());
111 /** Set a promise/result from a future/result
115 * <pre>promise.set_value(future);</pre>
117 * but it takes care of exceptions and works with `void`.
119 * We might need this when working with generic code because
120 * the trivial implementation does not work with `void` (before C++1z).
122 * @param promise output (a valid future or a result)
123 * @param future input (a ready/waitable future or a valid result)
125 template <class P, class F> inline void set_promise(P& promise, F&& future)
127 fulfill_promise(promise, [&future] { return std::forward<F>(future).get(); });