std::optional<T>:: transform
|
template
<
class
F
>
constexpr auto transform ( F && f ) & ; |
(1) | (C++23 起) |
|
template
<
class
F
>
constexpr auto transform ( F && f ) const & ; |
(2) | (C++23 起) |
|
template
<
class
F
>
constexpr auto transform ( F && f ) && ; |
(3) | (C++23 起) |
|
template
<
class
F
>
constexpr auto transform ( F && f ) const && ; |
(4) | (C++23 起) |
若
*
this
包含值,则以所含值作为参数调用
f
,并返回包含该调用结果的
std::optional
;否则返回空的
std::optional
。
结果中包含的值的类型(下文以
U
表示)必须是非数组对象类型,且不能是
std::in_place_t
或
std::nullopt_t
)。否则程序将处于非良构状态。
U
为
std::
remove_cv_t
<
std::
invoke_result_t
<
F, T
&
>>
。若
*
this
包含值,则返回一个
std::
optional
<
U
>
,其内含值通过
直接初始化
自
std::
invoke
(
std::
forward
<
F
>
(
f
)
,
**
this
)
(与必须直接返回
std::optional
的
and_then()
不同)。否则返回空的
std::
optional
<
U
>
。
若变量定义 U x ( std:: invoke ( std:: forward < F > ( f ) , ** this ) ) ; 非良构,则程序非良构。
U
为
std::
remove_cv_t
<
std::
invoke_result_t
<
F, T
>>
。若
*
this
包含值,则返回一个
std::
optional
<
U
>
,其包含的值由
std::
invoke
(
std::
forward
<
F
>
(
f
)
, std
::
move
(
**
this
)
)
直接初始化。否则返回空的
std::
optional
<
U
>
。
若变量定义 U x ( std:: invoke ( std:: forward < F > ( f ) , std :: move ( ** this ) ) ) ; 非良构,则程序非良构。
目录 |
参数
| f | - | 一个合适的函数或 Callable 对象,其调用签名返回非引用类型 |
返回值
一个包含
f
函数结果的
std::optional
或空的
std::optional
,如上所述。
注释
由于
transform
直接在目标位置构造
U
对象,而非将其传递给构造函数,因此
std::
is_move_constructible_v
<
U
>
可能为
false
。
由于可调用对象
f
无法返回引用类型,因此它不能是
指向数据成员的指针
。
某些语言将此操作称为 map 。
| 功能测试 宏 | 值 | 标准 | 特性 |
|---|---|---|---|
__cpp_lib_optional
|
202110L
|
(C++23) | std::optional 中的单子操作 |
示例
#include <iostream> #include <optional> struct A { /* ... */ }; struct B { /* ... */ }; struct C { /* ... */ }; struct D { /* ... */ }; auto A_to_B(A) -> B { /* ... */ std::cout << "A => B \n"; return {}; } auto B_to_C(B) -> C { /* ... */ std::cout << "B => C \n"; return {}; } auto C_to_D(C) -> D { /* ... */ std::cout << "C => D \n"; return {}; } void try_transform_A_to_D(std::optional<A> o_A) { std::cout << (o_A ? "o_A has a value\n" : "o_A is empty\n"); std::optional<D> o_D = o_A.transform(A_to_B) .transform(B_to_C) .transform(C_to_D); std::cout << (o_D ? "o_D has a value\n\n" : "o_D is empty\n\n"); }; int main() { try_transform_A_to_D( A{} ); try_transform_A_to_D( {} ); }
输出:
o_A has a value A => B B => C C => D o_D has a value o_A is empty o_D is empty
参见
|
若存在被容纳值则返回该值,否则返回另一值
(公开成员函数) |
|
|
(C++23)
|
若存在被容纳值则返回给定函数在该值上的结果,否则返回空的
optional
(公开成员函数) |
|
(C++23)
|
若
optional
本身包含值则返回它,否则返回给定函数的结果
(公开成员函数) |