std::optional<T>::begin

来自cppreference.com
< cpp‎ | utility‎ | optional
 
C++
 
工具库
通用工具
关系运算符 (C++20 弃用)
 
std::optional
 
constexpr iterator begin() noexcept;
 (C++26 起)
constexpr const_iterator begin() const noexcept;
 (C++26 起)

若 *this 含值，则返回指向所含值的迭代器。否则返回尾后迭代器值。

range-begin-end.svg

目录

[编辑] 返回值

若 has_value() 为 true 则返回指向所含值的迭代器。否则返回尾后迭代器。

[编辑] 复杂度

常数。

[编辑] 注解

功能特性测试宏 值 标准 功能特性
__cpp_lib_optional_range_support 202406L (C++26) std::optional 的范围支持

[编辑] 示例

运行此代码
#include <optional>
#include <print>
#include <vector>
 
int main()
{
    constexpr std::optional<int> none{std::nullopt};
    constexpr std::optional<int> some{42};
 
    static_assert(none.begin() == none.end());
    static_assert(some.begin() != some.end());
 
    // 支持范围 for 循环
    for (int i : none)
        std::println("'none' 的值为 {}", i);
 
    for (int i : some)
        std::println("'some' 的值为 {}", i);
 
    std::optional<std::vector<int>> many({0, 1, 2});
    for (const auto& v : many)
        std::println("'many' 的值为 {}", v);
}

输出： 

'some' 的值为 42
'many' 的值为 [0, 1, 2]

[编辑] 参阅

(C++26)
 返回指向末尾的迭代器
(公开成员函数) [编辑]
来自“https://zh.cppreference.com/mwiki/index.php?title=cpp/utility/optional/begin&oldid=100156”