std::expected<T,E>::transform_error

從 cppreference.com

主模板
template< class F > constexpr auto transform_error( F&& f ) &;	(1)	(C++23 起)
template< class F > constexpr auto transform_error( F&& f ) const&;	(2)	(C++23 起)
template< class F > constexpr auto transform_error( F&& f ) &&;	(3)	(C++23 起)
template< class F > constexpr auto transform_error( F&& f ) const&&;	(4)	(C++23 起)
void 部分特化
template< class F > constexpr auto transform_error( F&& f ) &;	(5)	(C++23 起)
template< class F > constexpr auto transform_error( F&& f ) const&;	(6)	(C++23 起)
template< class F > constexpr auto transform_error( F&& f ) &&;	(7)	(C++23 起)
template< class F > constexpr auto transform_error( F&& f ) const&&;	(8)	(C++23 起)

如果 *this 包含非預期值，那麼以 *this 的非預期值作為實參調用 f 並返回一個包含預期值的 std::expected 對象，以 f 的結果初始化該值。否則返回一個表示預期值的 std::expected 對象。

1-4) 以 *this 的預期值 val 初始化該預期值。

給定類型 G 為：

3,4) std::remove_cv_t<std::invoke_result_t<F, decltype(std::move(error()))>>

7,8) std::remove_cv_t<std::invoke_result_t<F, decltype(std::move(error()))>>

如果滿足以下任意條件，那麼程序非良構：

1,2) G g(std::invoke(std::forward<F>(f), error()));

3,4) G g(std::invoke(std::forward<F>(f), std::move(error()));

5,6) G g(std::invoke(std::forward<F>(f), error()));

7,8) G g(std::invoke(std::forward<F>(f), std::move(error()));

1,2) 此重載只有在 std::is_constructible_v<T, decltype((val))> 是 true 時才會參與重載決議。

3,4) 此重載只有在 std::is_constructible_v<T, decltype(std::move(val))> 是 true 時才會參與重載決議。

成員函數
expected::expected
expected::~expected
expected::operator=
觀察器
expected::operator->expected::operator*
expected::operator boolexpected::has_value
expected::value
expected::error
expected::value_or
expected::error_or
單子函數
expected::and_then
expected::or_else
expected::transform
expected::transform_error
修改器
expected::emplace
expected::swap
非成員函數
operator==(std::expected)
swap(std::expected)
輔助類
unexpected
bad_expected_access
unexpect_tunexpect

重載	`has_value()` 的值
重載	true	false
(1,2)	std::expected<T, G>(std::in_place, `val`)	std::expected<T, G> (std::unexpect, expr)
(3,4)	std::expected<T, G>(std::in_place, std::move(`val`))
(5,6)	std::expected<T, G>()
(7,8)	std::expected<T, G>()

缺陷報告	應用於	出版時的行為	正確行為
LWG 3938	C++23	通過 value() 獲取預期值^[1]	改成 **this
LWG 3973	C++23	通過 **this 獲取預期值^[2]	改成 `val`

or_else	若 `expected` 含有預期值則返回其自身，否則返回給定的函數在非預期值上的結果 (公開成員函數) [編輯]
transform	若存在預期值則返回含有變換後的預期值的 `expected`，否則返回 `expected` 本身 (公開成員函數) [編輯]

目錄