std::optional<T>::begin

constexpr iterator begin() noexcept;		(начиная с C++26)
constexpr const_iterator begin() const noexcept;		(начиная с C++26)

Если *this содержит значение, возвращает итератор на содержащееся значение. В противном случае возвращается итератор за последним элементом.

Возвращаемое значение

Итератор на содержащееся значение, если 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());

    // ranged-for loop support
    for (int i : none)
        std::println("'none' has a value of {}", i);

    for (int i : some)
        std::println("'some' has a value of {}", i);

    std::optional<std::vector<int>> many({0, 1, 2});
    for (const auto& v : many)
        std::println("'many' has a value of {}", v);
}

Вывод:

'some' has a value of 42
'many' has a value of [0, 1, 2]

См. также

end

(C++26)

возвращает итератор на конец
(открытая функция-член)

© cppreference.com
Licensed under the Creative Commons Attribution-ShareAlike Unported License v3.0.
https://en.cppreference.com/cpp/utility/optional/begin