Navigation :
Prerequisites
Build and install
Review of Error Handling Frameworks
Motivation
Future ABI stability guarantees
Tutorial
Recipes
Experimental
API reference
-
Macros
-
Concepts
-
Converters
-
Traits
-
Policies
-
Types
--
`basic_outcome<T, EC, EP, NoValuePolicy>`
--
`basic_result<T, E, NoValuePolicy>`
--- `basic_result() = delete`
--- `basic_result(basic_result &&)`
--- `basic_result(const basic_result &)`
--- `basic_result &operator=(basic_result &&)`
--- `basic_result &operator=(const basic_result &)`
--- `~basic_result()`
--- `basic_result(Args...) = delete`
--- `basic_result(X &&) = delete`
--- `basic_result(R &&)`
--- `basic_result(S &&)`
--- `basic_result(ErrorCondEnum &&)`
--- `explicit basic_result(concepts::value_or_error<T, E> &&)`
--- `explicit basic_result(const basic_result<R, S, P> &)`
--- `explicit basic_result(basic_result<R, S, P> &&)`
--- `explicit basic_result(const basic_result<R, S, P> &)`
--- `explicit basic_result(basic_result<R, S, P> &&)`
--- `explicit basic_result(const basic_result<R, S, P> &)`
--- `explicit basic_result(basic_result<R, S, P> &&)`
--- `explicit basic_result(in_place_type_t<value_type_if_enabled>, Args ...)`
--- `explicit basic_result(in_place_type_t<value_type_if_enabled>, std::initializer_list<U>, Args ...)`
--- `explicit basic_result(in_place_type_t<error_type_if_enabled>, Args ...)`
--- `explicit basic_result(in_place_type_t<error_type_if_enabled>, std::initializer_list<U>, Args ...)`
--- `basic_result(A1 &&, A2 &&, Args ...)`
--- `basic_result(const success_type<T> &)`
--- `basic_result(success_type<T> &&)`
--- `basic_result(const failure_type<T> &)`
--- `basic_result(failure_type<T> &&)`
--- `basic_result(const failure_type<T> &)`
--- `basic_result(failure_type<T> &&)`
--- `basic_result(const failure_type<T> &)`
--- `basic_result(failure_type<T> &&)`
--- `explicit operator bool() const noexcept`
--- `bool has_value() const noexcept`
--- `bool has_error() const noexcept`
--- `bool has_exception() const noexcept`
--- `bool has_failure() const noexcept`
--- `bool has_lost_consistency() const noexcept`
--- `value_type &assume_value() & noexcept`
--- `const value_type &assume_value() const & noexcept`
--- `value_type &&assume_value() && noexcept`
--- `const value_type &&assume_value() const && noexcept`
--- `value_type &value() &`
--- `const value_type &value() const &`
--- `value_type &&value() &&`
--- `const value_type &&value() const &&`
--- `error_type &assume_error() & noexcept`
--- `const error_type &assume_error() const & noexcept`
--- `error_type &&assume_error() && noexcept`
--- `const error_type &&assume_error() const && noexcept`
--- `error_type &error() &`
--- `const error_type &error() const &`
--- `error_type &&error() &&`
--- `const error_type &&error() const &&`
--- `bool operator==(const basic_result<A, B, C> &) const`
--- `bool operator==(const success_type<A> &) const`
--- `bool operator==(const failure_type<A, void> &) const`
--- `bool operator!=(const basic_result<A, B, C> &) const`
--- `bool operator!=(const success_type<A> &) const`
--- `bool operator!=(const failure_type<A, void> &) const`
--- `void swap(basic_result &)`
--- `auto as_failure() const &`
--- `auto as_failure() &&`
-- `bad_outcome_access`
-- `bad_result_access_with<EC>`
-- `bad_result_access`
-- `eager<T, Executor = void>/atomic_eager<T, Executor = void>`
-- `failure_type<EC, EP = void>`
-- `generator<T, Executor = void>`
-- `in_place_type_t<T>`
-- `lazy<T, Executor = void>/atomic_lazy<T, Executor = void>`
-- `success_type<T>`
-
Aliases
-
Functions
Frequently asked questions
Videos
Changelog
History
void swap(basic_result &)
Swap one basic_result with another, with the strong guarantee. Constexpr if move constructors and move assignments of value_type
and error_type
are noexcept.
Requires : Always available.
Complexity : If the move constructor and move assignment for value_type
and error_type
are noexcept, the complexity is the same as for the swap()
implementations of the value_type
and error_type
. Otherwise, complexity is not preserved, as strong_swap(bool &all_good, T &a, T &b)
is used instead of swap()
. This function defaults to using one move construction and two assignments, and it will attempt extra move assignments in order to restore the state upon entry if a failure occurs.
Guarantees : If an exception is thrown during the swap operation, the state of both operands on entry is attempted to be restored, in order to implement the strong guarantee. If that too fails, the flag bits are forced to something consistent such that there can be no simultaneously valued and errored state, or valueless and errorless. The flag has_lost_consistency()
becomes true for both operands, which are now likely in an inconsistent state.