Namespaces
Variants

std::optional<T>:: begin

From cppreference.net
Utilities library
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());
    // поддержка цикла ranged-for
    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]

Смотрите также

(C++26)
возвращает итератор на конец
(публичная функция-член)