/* Type sugar for success and failure (C) 2017-2024 Niall Douglas (25 commits) File Created: July 2017 Boost Software License - Version 1.0 - August 17th, 2003 Permission is hereby granted, free of charge, to any person or organization obtaining a copy of the software and accompanying documentation covered by this license (the "Software") to use, reproduce, display, distribute, execute, and transmit the Software, and to prepare derivative works of the Software, and to permit third-parties to whom the Software is furnished to do so, all subject to the following: The copyright notices in the Software and this entire statement, including the above license grant, this restriction and the following disclaimer, must be included in all copies of the Software, in whole or in part, and all derivative works of the Software, unless such copies or derivative works are solely in the form of machine-executable object code generated by a source language processor. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, TITLE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR ANYONE DISTRIBUTING THE SOFTWARE BE LIABLE FOR ANY DAMAGES OR OTHER LIABILITY, WHETHER IN CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */ #ifndef BOOST_OUTCOME_SUCCESS_FAILURE_HPP #define BOOST_OUTCOME_SUCCESS_FAILURE_HPP #include "config.hpp" BOOST_OUTCOME_V2_NAMESPACE_BEGIN /*! AWAITING HUGO JSON CONVERSION TOOL type definition template success_type. Potential doc page: `success_type` */ template struct BOOST_OUTCOME_NODISCARD success_type { using value_type = T; private: value_type _value; uint16_t _spare_storage{0}; public: success_type() = default; success_type(const success_type &) = default; success_type(success_type &&) = default; // NOLINT success_type &operator=(const success_type &) = default; success_type &operator=(success_type &&) = default; // NOLINT ~success_type() = default; BOOST_OUTCOME_TEMPLATE(class U) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(!std::is_same>::value)) constexpr explicit success_type(U &&v, uint16_t spare_storage = 0) : _value(static_cast(v)) // NOLINT , _spare_storage(spare_storage) { } constexpr value_type &value() & { return _value; } constexpr const value_type &value() const & { return _value; } constexpr value_type &&value() && { return static_cast(_value); } constexpr const value_type &&value() const && { return static_cast(_value); } constexpr uint16_t spare_storage() const { return _spare_storage; } }; template <> struct BOOST_OUTCOME_NODISCARD success_type { using value_type = void; constexpr uint16_t spare_storage() const { return 0; } }; /*! Returns type sugar for implicitly constructing a `basic_result` with a successful state, default constructing `T` if necessary. */ inline constexpr success_type success() noexcept { return success_type{}; } /*! Returns type sugar for implicitly constructing a `basic_result` with a successful state. \effects Copies the successful state supplied into the returned type sugar. */ BOOST_OUTCOME_TEMPLATE(class T) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(std::is_copy_constructible::value)) inline constexpr success_type> success(const T &v, uint16_t spare_storage = 0) { return success_type>{v, spare_storage}; } /*! Returns type sugar for implicitly constructing a `basic_result` with a successful state. \effects Moves the successful state supplied into the returned type sugar. */ BOOST_OUTCOME_TEMPLATE(class T) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(std::is_move_constructible::value)) inline constexpr success_type> success(T &&v, uint16_t spare_storage = 0) { return success_type>{static_cast(v), spare_storage}; } /*! AWAITING HUGO JSON CONVERSION TOOL type definition template failure_type. Potential doc page: `failure_type` */ template struct BOOST_OUTCOME_NODISCARD failure_type { using error_type = EC; using exception_type = E; private: error_type _error; exception_type _exception; bool _have_error{false}, _have_exception{false}; uint16_t _spare_storage{0}; struct error_init_tag { }; struct exception_init_tag { }; public: failure_type() = default; failure_type(const failure_type &) = default; failure_type(failure_type &&) = default; // NOLINT failure_type &operator=(const failure_type &) = default; failure_type &operator=(failure_type &&) = default; // NOLINT ~failure_type() = default; template constexpr explicit failure_type(U &&u, V &&v, uint16_t spare_storage = 0) : _error(static_cast(u)) , _exception(static_cast(v)) , _have_error(true) , _have_exception(true) , _spare_storage(spare_storage) { } template constexpr explicit failure_type(in_place_type_t /*unused*/, U &&u, uint16_t spare_storage = 0, error_init_tag /*unused*/ = error_init_tag()) : _error(static_cast(u)) , _exception() , _have_error(true) , _spare_storage(spare_storage) { } template constexpr explicit failure_type(in_place_type_t /*unused*/, U &&u, uint16_t spare_storage = 0, exception_init_tag /*unused*/ = exception_init_tag()) : _error() , _exception(static_cast(u)) , _have_exception(true) , _spare_storage(spare_storage) { } constexpr bool has_error() const { return _have_error; } constexpr bool has_exception() const { return _have_exception; } constexpr error_type &error() & { return _error; } constexpr const error_type &error() const & { return _error; } constexpr error_type &&error() && { return static_cast(_error); } constexpr const error_type &&error() const && { return static_cast(_error); } constexpr exception_type &exception() & { return _exception; } constexpr const exception_type &exception() const & { return _exception; } constexpr exception_type &&exception() && { return static_cast(_exception); } constexpr const exception_type &&exception() const && { return static_cast(_exception); } constexpr uint16_t spare_storage() const { return _spare_storage; } }; template struct BOOST_OUTCOME_NODISCARD failure_type { using error_type = EC; using exception_type = void; private: error_type _error; uint16_t _spare_storage{0}; public: failure_type() = default; failure_type(const failure_type &) = default; failure_type(failure_type &&) = default; // NOLINT failure_type &operator=(const failure_type &) = default; failure_type &operator=(failure_type &&) = default; // NOLINT ~failure_type() = default; BOOST_OUTCOME_TEMPLATE(class U) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(!std::is_same>::value)) constexpr explicit failure_type(U &&u, uint16_t spare_storage = 0) : _error(static_cast(u)) // NOLINT , _spare_storage(spare_storage) { } constexpr error_type &error() & { return _error; } constexpr const error_type &error() const & { return _error; } constexpr error_type &&error() && { return static_cast(_error); } constexpr const error_type &&error() const && { return static_cast(_error); } constexpr uint16_t spare_storage() const { return _spare_storage; } }; template struct BOOST_OUTCOME_NODISCARD failure_type { using error_type = void; using exception_type = E; private: exception_type _exception; uint16_t _spare_storage{0}; public: failure_type() = default; failure_type(const failure_type &) = default; failure_type(failure_type &&) = default; // NOLINT failure_type &operator=(const failure_type &) = default; failure_type &operator=(failure_type &&) = default; // NOLINT ~failure_type() = default; BOOST_OUTCOME_TEMPLATE(class V) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(!std::is_same>::value)) constexpr explicit failure_type(V &&v, uint16_t spare_storage = 0) : _exception(static_cast(v)) // NOLINT , _spare_storage(spare_storage) { } constexpr exception_type &exception() & { return _exception; } constexpr const exception_type &exception() const & { return _exception; } constexpr exception_type &&exception() && { return static_cast(_exception); } constexpr const exception_type &&exception() const && { return static_cast(_exception); } constexpr uint16_t spare_storage() const { return _spare_storage; } }; /*! AWAITING HUGO JSON CONVERSION TOOL SIGNATURE NOT RECOGNISED */ BOOST_OUTCOME_TEMPLATE(class EC) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(std::is_copy_constructible::value)) inline constexpr failure_type> failure(const EC &v, uint16_t spare_storage = 0) { return failure_type>{v, spare_storage}; } /*! AWAITING HUGO JSON CONVERSION TOOL SIGNATURE NOT RECOGNISED */ BOOST_OUTCOME_TEMPLATE(class EC) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(std::is_move_constructible::value)) inline constexpr failure_type> failure(EC &&v, uint16_t spare_storage = 0) { return failure_type>{static_cast(v), spare_storage}; } /*! AWAITING HUGO JSON CONVERSION TOOL SIGNATURE NOT RECOGNISED */ BOOST_OUTCOME_TEMPLATE(class EC, class E) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(std::is_copy_constructible::value &&std::is_copy_constructible::value)) inline constexpr failure_type, std::decay_t> failure(const EC &v, const E &w, uint16_t spare_storage = 0) { return failure_type, std::decay_t>{v, w, spare_storage}; } /*! AWAITING HUGO JSON CONVERSION TOOL SIGNATURE NOT RECOGNISED */ BOOST_OUTCOME_TEMPLATE(class EC, class E) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(std::is_copy_constructible::value &&std::is_move_constructible::value)) inline constexpr failure_type, std::decay_t> failure(const EC &v, E &&w, uint16_t spare_storage = 0) { return failure_type, std::decay_t>{v, static_cast(w), spare_storage}; } /*! AWAITING HUGO JSON CONVERSION TOOL SIGNATURE NOT RECOGNISED */ BOOST_OUTCOME_TEMPLATE(class EC, class E) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(std::is_move_constructible::value &&std::is_copy_constructible::value)) inline constexpr failure_type, std::decay_t> failure(EC &&v, const E &w, uint16_t spare_storage = 0) { return failure_type, std::decay_t>{static_cast(v), w, spare_storage}; } /*! AWAITING HUGO JSON CONVERSION TOOL SIGNATURE NOT RECOGNISED */ BOOST_OUTCOME_TEMPLATE(class EC, class E) BOOST_OUTCOME_TREQUIRES(BOOST_OUTCOME_TPRED(std::is_move_constructible::value &&std::is_move_constructible::value)) inline constexpr failure_type, std::decay_t> failure(EC &&v, E &&w, uint16_t spare_storage = 0) { return failure_type, std::decay_t>{static_cast(v), static_cast(w), spare_storage}; } namespace detail { template struct is_success_type { static constexpr bool value = false; }; template struct is_success_type> { static constexpr bool value = true; }; template struct is_failure_type { static constexpr bool value = false; }; template struct is_failure_type> { static constexpr bool value = true; }; } // namespace detail /*! AWAITING HUGO JSON CONVERSION TOOL SIGNATURE NOT RECOGNISED */ template static constexpr bool is_success_type = detail::is_success_type>::value; /*! AWAITING HUGO JSON CONVERSION TOOL SIGNATURE NOT RECOGNISED */ template static constexpr bool is_failure_type = detail::is_failure_type>::value; BOOST_OUTCOME_V2_NAMESPACE_END #endif