cppdraft_translate/cppdraft/expected/expected.md

[expected.expected]

22 General utilities library [utilities]

22.8 Expected objects [expected]

22.8.6 Class template expected [expected.expected]

22.8.6.1 General [expected.object.general]

namespace std {template<class T, class E>class expected {public:using value_type = T; using error_type = E; using unexpected_type = unexpected; templateusing rebind = expected<U, error_type>; // [expected.object.cons], constructorsconstexpr expected(); constexpr expected(const expected&); constexpr expected(expected&&) noexcept(see below); template<class U, class G>constexpr explicit(see below) expected(const expected<U, G>&); template<class U, class G>constexpr explicit(see below) expected(expected<U, G>&&); template<class U = remove_cv_t>constexpr explicit(see below) expected(U&& v); templateconstexpr explicit(see below) expected(const unexpected&); templateconstexpr explicit(see below) expected(unexpected&&); template<class... Args>constexpr explicit expected(in_place_t, Args&&...); template<class U, class... Args>constexpr explicit expected(in_place_t, initializer_list, Args&&...); template<class... Args>constexpr explicit expected(unexpect_t, Args&&...); template<class U, class... Args>constexpr explicit expected(unexpect_t, initializer_list, Args&&...); // [expected.object.dtor], destructorconstexpr ~expected(); // [expected.object.assign], assignmentconstexpr expected& operator=(const expected&); constexpr expected& operator=(expected&&) noexcept(see below); template<class U = remove_cv_t> constexpr expected& operator=(U&&); templateconstexpr expected& operator=(const unexpected&); templateconstexpr expected& operator=(unexpected&&); template<class... Args>constexpr T& emplace(Args&&...) noexcept; template<class U, class... Args>constexpr T& emplace(initializer_list, Args&&...) noexcept; // [expected.object.swap], swapconstexpr void swap(expected&) noexcept(see below); friend constexpr void swap(expected& x, expected& y) noexcept(noexcept(x.swap(y))); // [expected.object.obs], observersconstexpr const T* operator->() const noexcept; constexpr T* operator->() noexcept; constexpr const T& operator*() const & noexcept; constexpr T& operator*() & noexcept; constexpr const T&& operator*() const && noexcept; constexpr T&& operator*() && noexcept; constexpr explicit operator bool() const noexcept; constexpr bool has_value() const noexcept; constexpr const T& value() const &; // freestanding-deletedconstexpr T& value() &; // freestanding-deletedconstexpr const T&& value() const &&; // freestanding-deletedconstexpr T&& value() &&; // freestanding-deletedconstexpr const E& error() const & noexcept; constexpr E& error() & noexcept; constexpr const E&& error() const && noexcept; constexpr E&& error() && noexcept; template<class U = remove_cv_t> constexpr T value_or(U&&) const &; template<class U = remove_cv_t> constexpr T value_or(U&&) &&; template constexpr E error_or(G&&) const &; template constexpr E error_or(G&&) &&; // [expected.object.monadic], monadic operationstemplate constexpr auto and_then(F&& f) &; template constexpr auto and_then(F&& f) &&; template constexpr auto and_then(F&& f) const &; template constexpr auto and_then(F&& f) const &&; template constexpr auto or_else(F&& f) &; template constexpr auto or_else(F&& f) &&; template constexpr auto or_else(F&& f) const &; template constexpr auto or_else(F&& f) const &&; template constexpr auto transform(F&& f) &; template constexpr auto transform(F&& f) &&; template constexpr auto transform(F&& f) const &; template constexpr auto transform(F&& f) const &&; template constexpr auto transform_error(F&& f) &; template constexpr auto transform_error(F&& f) &&; template constexpr auto transform_error(F&& f) const &; template constexpr auto transform_error(F&& f) const &&; // [expected.object.eq], equality operatorstemplate<class T2, class E2> requires (!is_void_v)friend constexpr bool operator==(const expected& x, const expected<T2, E2>& y); templatefriend constexpr bool operator==(const expected&, const T2&); templatefriend constexpr bool operator==(const expected&, const unexpected&); private:bool has_val; // exposition onlyunion { T val; // exposition only E unex; // exposition only}; };}

1

#

Any object of type expected<T, E> either contains a value of type T or a value of type E nested within ([intro.object]) it.

Member has_val indicates whether the expected<T, E> object contains an object of type T.

2

#

A type T is a valid value type for expected, if remove_cv_t is void or a complete non-array object type that is not in_place_t,unexpect_t, or a specialization of unexpected.

A program which instantiates class template expected<T, E> with an argument T that is not a valid value type for expected is ill-formed.

A program that instantiates the definition of the template expected<T, E> with a type for the E parameter that is not a valid template argument for unexpected is ill-formed.

3

#

When T is not cv void, it shall meet the Cpp17Destructible requirements (Table 35).

E shall meet the Cpp17Destructible requirements.

22.8.6.2 Constructors [expected.object.cons]

1

#

The exposition-only variable template converts-from-any-cvref defined in [optional.ctor] is used by some constructors for expected.

🔗

constexpr expected();

2

#

Constraints: is_default_constructible_v is true.

3

#

Effects: Value-initializes val.

4

#

Postconditions: has_value() is true.

5

#

Throws: Any exception thrown by the initialization of val.

🔗

constexpr expected(const expected& rhs);

6

#

Effects: If rhs.has_value() is true, direct-non-list-initializes val with *rhs.

Otherwise, direct-non-list-initializes unex with rhs.error().

7

#

Postconditions: rhs.has_value() == this->has_value().

8

#

Throws: Any exception thrown by the initialization of val or unex.

9

#

Remarks: This constructor is defined as deleted unless

• (9.1)

is_copy_constructible_v is true and

• (9.2)

is_copy_constructible_v is true.

10

#

This constructor is trivial if

• (10.1)

is_trivially_copy_constructible_v is true and

• (10.2)

is_trivially_copy_constructible_v is true.

🔗

constexpr expected(expected&& rhs) noexcept(see below);

11

#

Constraints:

• (11.1)

is_move_constructible_v is true and

• (11.2)

is_move_constructible_v is true.

12

#

Effects: If rhs.has_value() is true, direct-non-list-initializes val with std​::​move(*rhs).

Otherwise, direct-non-list-initializes unex with std​::​move(rhs.error()).

13

#

Postconditions: rhs.has_value() is unchanged;rhs.has_value() == this->has_value() is true.

14

#

Throws: Any exception thrown by the initialization of val or unex.

15

#

Remarks: The exception specification is equivalent tois_nothrow_move_constructible_v && is_nothrow_move_constructible_v.

16

#

This constructor is trivial if

• (16.1)

is_trivially_move_constructible_v is true and

• (16.2)

is_trivially_move_constructible_v is true.

🔗

template<class U, class G> constexpr explicit(see below) expected(const expected<U, G>& rhs); template<class U, class G> constexpr explicit(see below) expected(expected<U, G>&& rhs);

17

#

Let:

• (17.1)

  UF be const U& for the first overload andU for the second overload.

• (17.2)

  GF be const G& for the first overload andG for the second overload.

18

#

Constraints:

• (18.1)

is_constructible_v<T, UF> is true; and

• (18.2)

is_constructible_v<E, GF> is true; and

• (18.3)

if T is not cv bool,converts-from-any-cvref<T, expected<U, G>> is false; and

• (18.4)

is_constructible_v<unexpected, expected<U, G>&> is false; and

• (18.5)

is_constructible_v<unexpected, expected<U, G>> is false; and

• (18.6)

is_constructible_v<unexpected, const expected<U, G>&> is false; and

• (18.7)

is_constructible_v<unexpected, const expected<U, G>> is false.

19

#

Effects: If rhs.has_value(), direct-non-list-initializes val with std​::​forward(*rhs).

Otherwise, direct-non-list-initializes unex with std​::​forward(rhs.error()).

20

#

Postconditions: rhs.has_value() is unchanged;rhs.has_value() == this->has_value() is true.

21

#

Throws: Any exception thrown by the initialization of val or unex.

22

#

Remarks: The expression inside explicit is equivalent to!is_convertible_v<UF, T> || !is_convertible_v<GF, E>.

🔗

template<class U = remove_cv_t<T>> constexpr explicit(!is_convertible_v<U, T>) expected(U&& v);

23

#

Constraints:

• (23.1)

is_same_v<remove_cvref_t, in_place_t> is false; and

• (23.2)

is_same_v<remove_cvref_t, expected> is false; and

• (23.3)

is_same_v<remove_cvref_t, unexpect_t> is false; and

• (23.4)

remove_cvref_t is not a specialization of unexpected; and

• (23.5)

is_constructible_v<T, U> is true; and

• (23.6)

if T is cv bool,remove_cvref_t is not a specialization of expected.

24

#

Effects: Direct-non-list-initializes val with std​::​forward(v).

25

#

Postconditions: has_value() is true.

26

#

Throws: Any exception thrown by the initialization of val.

🔗

template<class G> constexpr explicit(!is_convertible_v<const G&, E>) expected(const unexpected<G>& e); template<class G> constexpr explicit(!is_convertible_v<G, E>) expected(unexpected<G>&& e);

27

#

Let GF be const G& for the first overload andG for the second overload.

28

#

Constraints: is_constructible_v<E, GF> is true.

29

#

Effects: Direct-non-list-initializes unex with std​::​forward(e.error()).

30

#

Postconditions: has_value() is false.

31

#

Throws: Any exception thrown by the initialization of unex.

🔗

template<class... Args> constexpr explicit expected(in_place_t, Args&&... args);

32

#

Constraints: is_constructible_v<T, Args...> is true.

33

#

Effects: Direct-non-list-initializes val with std​::​forward(args)....

34

#

Postconditions: has_value() is true.

35

#

Throws: Any exception thrown by the initialization of val.

🔗

template<class U, class... Args> constexpr explicit expected(in_place_t, initializer_list<U> il, Args&&... args);

36

#

Constraints: is_constructible_v<T, initializer_list&, Args...> is true.

37

#

Effects: Direct-non-list-initializes val withil, std​::​forward(args)....

38

#

Postconditions: has_value() is true.

39

#

Throws: Any exception thrown by the initialization of val.

🔗

template<class... Args> constexpr explicit expected(unexpect_t, Args&&... args);

40

#

Constraints: is_constructible_v<E, Args...> is true.

41

#

Effects: Direct-non-list-initializes unex withstd​::​forward(args)....

42

#

Postconditions: has_value() is false.

43

#

Throws: Any exception thrown by the initialization of unex.

🔗

template<class U, class... Args> constexpr explicit expected(unexpect_t, initializer_list<U> il, Args&&... args);

44

#

Constraints: is_constructible_v<E, initializer_list&, Args...> is true.

45

#

Effects: Direct-non-list-initializes unex withil, std​::​forward(args)....

46

#

Postconditions: has_value() is false.

47

#

Throws: Any exception thrown by the initialization of unex.

22.8.6.3 Destructor [expected.object.dtor]

🔗

constexpr ~expected();

1

#

Effects: If has_value() is true, destroys val, otherwise destroys unex.

2

#

Remarks: If is_trivially_destructible_v is true, andis_trivially_destructible_v is true, then this destructor is a trivial destructor.

22.8.6.4 Assignment [expected.object.assign]

1

#

This subclause makes use of the following exposition-only function template:template<class T, class U, class... Args>constexpr void reinit-expected(T& newval, U& oldval, Args&&... args) { // exposition onlyif constexpr (is_nothrow_constructible_v<T, Args...>) { destroy_at(addressof(oldval)); construct_at(addressof(newval), std::forward(args)...); } else if constexpr (is_nothrow_move_constructible_v) { T tmp(std::forward(args)...); destroy_at(addressof(oldval)); construct_at(addressof(newval), std::move(tmp)); } else { U tmp(std::move(oldval)); destroy_at(addressof(oldval)); try { construct_at(addressof(newval), std::forward(args)...); } catch (...) { construct_at(addressof(oldval), std::move(tmp)); throw; }}}

🔗

constexpr expected& operator=(const expected& rhs);

2

#

Effects:

• (2.1)

  If this->has_value() && rhs.has_value() is true, equivalent to val = *rhs.

• (2.2)

  Otherwise, if this->has_value() is true, equivalent to:reinit-expected(unex, val, rhs.error())

• (2.3)

  Otherwise, if rhs.has_value() is true, equivalent to:reinit-expected(val, unex, *rhs)

• (2.4)

  Otherwise, equivalent to unex = rhs.error().

Then, if no exception was thrown, equivalent to: has_val = rhs.has_value(); return *this;

3

#

Returns: *this.

4

#

Remarks: This operator is defined as deleted unless:

• (4.1)

is_copy_assignable_v is true and

• (4.2)

is_copy_constructible_v is true and

• (4.3)

is_copy_assignable_v is true and

• (4.4)

is_copy_constructible_v is true and

• (4.5)

is_nothrow_move_constructible_v || is_nothrow_move_constructible_v is true.

🔗

constexpr expected& operator=(expected&& rhs) noexcept(see below);

5

#

Constraints:

• (5.1)

is_move_constructible_v is true and

• (5.2)

is_move_assignable_v is true and

• (5.3)

is_move_constructible_v is true and

• (5.4)

is_move_assignable_v is true and

• (5.5)

is_nothrow_move_constructible_v || is_nothrow_move_constructible_v is true.

6

#

Effects:

• (6.1)

  If this->has_value() && rhs.has_value() is true, equivalent to val = std​::​move(*rhs).

• (6.2)

  Otherwise, if this->has_value() is true, equivalent to:reinit-expected(unex, val, std::move(rhs.error()))

• (6.3)

  Otherwise, if rhs.has_value() is true, equivalent to:reinit-expected(val, unex, std::move(*rhs))

• (6.4)

  Otherwise, equivalent to unex = std​::​move(rhs.error()).

Then, if no exception was thrown, equivalent to: has_val = rhs.has_value(); return *this;

7

#

Returns: *this.

8

#

Remarks: The exception specification is equivalent to:is_nothrow_move_assignable_v && is_nothrow_move_constructible_v && is_nothrow_move_assignable_v && is_nothrow_move_constructible_v

🔗

template<class U = remove_cv_t<T>> constexpr expected& operator=(U&& v);

9

#

Constraints:

• (9.1)

is_same_v<expected, remove_cvref_t> is false; and

• (9.2)

remove_cvref_t is not a specialization of unexpected; and

• (9.3)

is_constructible_v<T, U> is true; and

• (9.4)

is_assignable_v<T&, U> is true; and

• (9.5)

is_nothrow_constructible_v<T, U> || is_nothrow_move_constructible_v ||
is_nothrow_move_constructible_v is true.

10

#

Effects:

• (10.1)

If has_value() is true, equivalent to: val = std​::​forward(v);

• (10.2)

Otherwise, equivalent to:reinit-expected(val, unex, std::forward(v));has_val = true;

11

#

Returns: *this.

🔗

template<class G> constexpr expected& operator=(const unexpected<G>& e); template<class G> constexpr expected& operator=(unexpected<G>&& e);

12

#

Let GF be const G& for the first overload andG for the second overload.

13

#

Constraints:

• (13.1)

is_constructible_v<E, GF> is true; and

• (13.2)

is_assignable_v<E&, GF> is true; and

• (13.3)

is_nothrow_constructible_v<E, GF> || is_nothrow_move_constructible_v ||
is_nothrow_move_constructible_v is true.

14

#

Effects:

• (14.1)

If has_value() is true, equivalent to:reinit-expected(unex, val, std::forward(e.error()));has_val = false;

• (14.2)

Otherwise, equivalent to:unex = std​::​forward(e.error());

15

#

Returns: *this.

🔗

template<class... Args> constexpr T& emplace(Args&&... args) noexcept;

16

#

Constraints: is_nothrow_constructible_v<T, Args...> is true.

17

#

Effects: Equivalent to:if (has_value()) { destroy_at(addressof(val));} else { destroy_at(addressof(unex)); has_val = true;}return *construct_at(addressof(val), std::forward(args)...);

🔗

template<class U, class... Args> constexpr T& emplace(initializer_list<U> il, Args&&... args) noexcept;

18

#

Constraints: is_nothrow_constructible_v<T, initializer_list&, Args...> is true.

19

#

Effects: Equivalent to:if (has_value()) { destroy_at(addressof(val));} else { destroy_at(addressof(unex)); has_val = true;}return *construct_at(addressof(val), il, std::forward(args)...);

22.8.6.5 Swap [expected.object.swap]

🔗

constexpr void swap(expected& rhs) noexcept(see below);

1

#

Constraints:

• (1.1)

is_swappable_v is true and

• (1.2)

is_swappable_v is true and

• (1.3)

is_move_constructible_v && is_move_constructible_v is true, and

• (1.4)

is_nothrow_move_constructible_v || is_nothrow_move_constructible_v is true.

2

#

Effects: See Table 72.

Table 72 — swap(expected&) effects [tab:expected.object.swap]

🔗	this->has_value()	!this->has_value()
🔗 rhs.has_value()	equivalent to: using std​::​swap; swap(val, rhs.val);	calls rhs.swap(*this)
🔗 !rhs.has_value()	see below	equivalent to: using std​::​swap; swap(unex, rhs.unex);

For the case where rhs.has_value() is false andthis->has_value() is true, equivalent to:if constexpr (is_nothrow_move_constructible_v) { E tmp(std::move(rhs.unex)); destroy_at(addressof(rhs.unex)); try { construct_at(addressof(rhs.val), std::move(val)); destroy_at(addressof(val)); construct_at(addressof(unex), std::move(tmp)); } catch(...) { construct_at(addressof(rhs.unex), std::move(tmp)); throw; }} else { T tmp(std::move(val)); destroy_at(addressof(val)); try { construct_at(addressof(unex), std::move(rhs.unex)); destroy_at(addressof(rhs.unex)); construct_at(addressof(rhs.val), std::move(tmp)); } catch (...) { construct_at(addressof(val), std::move(tmp)); throw; }}has_val = false; rhs.has_val = true;

3

#

Throws: Any exception thrown by the expressions in the Effects.

4

#

Remarks: The exception specification is equivalent to:is_nothrow_move_constructible_v && is_nothrow_swappable_v && is_nothrow_move_constructible_v && is_nothrow_swappable_v

🔗

friend constexpr void swap(expected& x, expected& y) noexcept(noexcept(x.swap(y)));

5

#

Effects: Equivalent to x.swap(y).

22.8.6.6 Observers [expected.object.obs]

🔗

constexpr const T* operator->() const noexcept; constexpr T* operator->() noexcept;

1

#

Hardened preconditions: has_value() is true.

2

#

Returns: addressof(val).

🔗

constexpr const T& operator*() const & noexcept; constexpr T& operator*() & noexcept;

3

#

Hardened preconditions: has_value() is true.

4

#

Returns: val.

🔗

constexpr T&& operator*() && noexcept; constexpr const T&& operator*() const && noexcept;

5

#

Hardened preconditions: has_value() is true.

6

#

Returns: std​::​move(val).

🔗

constexpr explicit operator bool() const noexcept; constexpr bool has_value() const noexcept;

7

#

Returns: has_val.

🔗

constexpr const T& value() const &; constexpr T& value() &;

8

#

Mandates: is_copy_constructible_v is true.

9

#

Returns: val, if has_value() is true.

10

#

Throws: bad_expected_access(as_const(error())) if has_value() is false.

🔗

constexpr T&& value() &&; constexpr const T&& value() const &&;

11

#

Mandates: is_copy_constructible_v is true andis_constructible_v<E, decltype(std​::​move(error()))> is true.

12

#

Returns: std​::​move(val), if has_value() is true.

13

#

Throws: bad_expected_access(std​::​move(error())) if has_value() is false.

🔗

constexpr const E& error() const & noexcept; constexpr E& error() & noexcept;

14

#

Hardened preconditions: has_value() is false.

15

#

Returns: unex.

🔗

constexpr E&& error() && noexcept; constexpr const E&& error() const && noexcept;

16

#

Hardened preconditions: has_value() is false.

17

#

Returns: std​::​move(unex).

🔗

template<class U = remove_cv_t<T>> constexpr T value_or(U&& v) const &;

18

#

Mandates: is_copy_constructible_v is true andis_convertible_v<U, T> is true.

19

#

Returns: has_value() ? **this : static_cast(std​::​forward(v)).

🔗

template<class U = remove_cv_t<T>> constexpr T value_or(U&& v) &&;

20

#

Mandates: is_move_constructible_v is true andis_convertible_v<U, T> is true.

21

#

Returns: has_value() ? std​::​move(**this) : static_cast(std​::​forward(v)).

🔗

template<class G = E> constexpr E error_or(G&& e) const &;

22

#

Mandates: is_copy_constructible_v is true andis_convertible_v<G, E> is true.

23

#

Returns: std​::​forward(e) if has_value() is true,error() otherwise.

🔗

template<class G = E> constexpr E error_or(G&& e) &&;

24

#

Mandates: is_move_constructible_v is true andis_convertible_v<G, E> is true.

25

#

Returns: std​::​forward(e) if has_value() is true,std​::​move(error()) otherwise.

22.8.6.7 Monadic operations [expected.object.monadic]

🔗

template<class F> constexpr auto and_then(F&& f) &; template<class F> constexpr auto and_then(F&& f) const &;

1

#

Let U be remove_cvref_t<invoke_result_t<F, decltype((val))>>.

2

#

Constraints: is_constructible_v<E, decltype(error())> is true.

3

#

Mandates: U is a specialization of expected andis_same_v<U​::​error_type, E> is true.

4

#

Effects: Equivalent to:if (has_value())return invoke(std::forward(f), val);elsereturn U(unexpect, error());

🔗

template<class F> constexpr auto and_then(F&& f) &&; template<class F> constexpr auto and_then(F&& f) const &&;

5

#

Let U beremove_cvref_t<invoke_result_t<F, decltype(std​::​move(val))>>.

6

#

Constraints: is_constructible_v<E, decltype(std​::​move(error()))> is true.

7

#

Mandates: U is a specialization of expected andis_same_v<U​::​error_type, E> is true.

8

#

Effects: Equivalent to:if (has_value())return invoke(std::forward(f), std::move(val));elsereturn U(unexpect, std::move(error()));

🔗

template<class F> constexpr auto or_else(F&& f) &; template<class F> constexpr auto or_else(F&& f) const &;

9

#

Let G be remove_cvref_t<invoke_result_t<F, decltype(error())>>.

10

#

Constraints: is_constructible_v<T, decltype((val))> is true.

11

#

Mandates: G is a specialization of expected andis_same_v<G​::​value_type, T> is true.

12

#

Effects: Equivalent to:if (has_value())return G(in_place, val);elsereturn invoke(std::forward(f), error());

🔗

template<class F> constexpr auto or_else(F&& f) &&; template<class F> constexpr auto or_else(F&& f) const &&;

13

#

Let G beremove_cvref_t<invoke_result_t<F, decltype(std​::​move(error()))>>.

14

#

Constraints: is_constructible_v<T, decltype(std​::​move(val))> is true.

15

#

Mandates: G is a specialization of expected andis_same_v<G​::​value_type, T> is true.

16

#

Effects: Equivalent to:if (has_value())return G(in_place, std::move(val));elsereturn invoke(std::forward(f), std::move(error()));

🔗

template<class F> constexpr auto transform(F&& f) &; template<class F> constexpr auto transform(F&& f) const &;

17

#

Let U beremove_cv_t<invoke_result_t<F, decltype((val))>>.

18

#

Constraints: is_constructible_v<E, decltype(error())> is true.

19

#

Mandates: U is a valid value type for expected.

If is_void_v is false, the declarationU u(invoke(std::forward(f), val)); is well-formed.

20

#

Effects:

• (20.1)

  If has_value() is false, returnsexpected<U, E>(unexpect, error()).

• (20.2)

  Otherwise, if is_void_v is false, returns anexpected<U, E> object whose has_val member is true and val member is direct-non-list-initialized withinvoke(std​::​forward(f), val).

• (20.3)

  Otherwise, evaluates invoke(std​::​forward(f), val) and then returns expected<U, E>().

🔗

template<class F> constexpr auto transform(F&& f) &&; template<class F> constexpr auto transform(F&& f) const &&;

21

#

Let U beremove_cv_t<invoke_result_t<F, decltype(std​::​move(val))>>.

22

#

Constraints: is_constructible_v<E, decltype(std​::​move(error()))> is true.

23

#

Mandates: U is a valid value type for expected.

If is_void_v isfalse, the declarationU u(invoke(std::forward(f), std::move(val))); is well-formed.

24

#

Effects:

• (24.1)

  If has_value() is false, returnsexpected<U, E>(unexpect, std​::​move(error())).

• (24.2)

  Otherwise, if is_void_v is false, returns anexpected<U, E> object whose has_val member is true and val member is direct-non-list-initialized withinvoke(std​::​forward(f), std​::​move(val)).

• (24.3)

  Otherwise, evaluates invoke(std​::​forward(f), std​::​move(val)) and then returns expected<U, E>().

🔗

template<class F> constexpr auto transform_error(F&& f) &; template<class F> constexpr auto transform_error(F&& f) const &;

25

#

Let G be remove_cv_t<invoke_result_t<F, decltype(error())>>.

26

#

Constraints: is_constructible_v<T, decltype((val))> is true.

27

#

Mandates: G is a valid template argument for unexpected ([expected.un.general]) and the declarationG g(invoke(std::forward(f), error())); is well-formed.

28

#

Returns: If has_value() is true,expected<T, G>(in_place, val); otherwise, an expected<T, G> object whose has_val member is false and unex member is direct-non-list-initialized with invoke(std​::​forward(f), error()).

🔗

template<class F> constexpr auto transform_error(F&& f) &&; template<class F> constexpr auto transform_error(F&& f) const &&;

29

#

Let G beremove_cv_t<invoke_result_t<F, decltype(std​::​move(error()))>>.

30

#

Constraints: is_constructible_v<T, decltype(std​::​move(val))> is true.

31

#

Mandates: G is a valid template argument for unexpected ([expected.un.general]) and the declarationG g(invoke(std::forward(f), std::move(error()))); is well-formed.

32

#

Returns: If has_value() is true,expected<T, G>(in_place, std​::​move(val)); otherwise, anexpected<T, G> object whose has_val member is false and unex member is direct-non-list-initialized withinvoke(std​::​forward(f), std​::​move(error())).

22.8.6.8 Equality operators [expected.object.eq]

🔗

template<class T2, class E2> requires (!is_void_v<T2>) friend constexpr bool operator==(const expected& x, const expected<T2, E2>& y);

1

#

Constraints: The expressions *x == *y and x.error() == y.error() are well-formed and their results are convertible to bool.

2

#

Returns: If x.has_value() does not equal y.has_value(), false; otherwise if x.has_value() is true, *x == *y; otherwise x.error() == y.error().

🔗

template<class T2> friend constexpr bool operator==(const expected& x, const T2& v);

3

#

Constraints: T2 is not a specialization of expected.

The expression *x == v is well-formed and its result is convertible to bool.

[Note 1:

T need not be Cpp17EqualityComparable.

— end note]

4

#

Returns: x.has_value() && static_cast(*x == v).

🔗

template<class E2> friend constexpr bool operator==(const expected& x, const unexpected<E2>& e);

5

#

Constraints: The expression x.error() == e.error() is well-formed and its result is convertible to bool.

6

#

Returns: !x.has_value() && static_cast(x.error() == e.error()).