std::ranges::split_view<V,Pattern>::begin

constexpr /*iterator*/ begin();

(начиная с C++20)

Возвращает итератор к первому найденному поддиапазону.

Чтобы обеспечить амортизированную сложность константного времени, требуемую концепцией range, эта функция кэширует результат внутри split_view (с помощью члена cached_begin_) для использования при последующих вызовах.

Пусть base_ — базовый элемент данных. Эквивалентно:

constexpr /*iterator*/ begin()
{
    if (!cached_begin_.has_value())
        cached_begin_ = this->find_next(ranges::begin(base_));
    return {*this, ranges::begin(base_), cached_begin_.value()};
}

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

Итератор.

Сложность

Амортизированная \(\scriptsize \mathcal{O}(1)\)O(1).

Пример

#include <iomanip>
#include <iostream>
#include <ranges>
#include <string_view>

int main()
{
    constexpr std::string_view sentence{"Keep..moving..forward.."};
    constexpr std::string_view delim{".."};
    std::ranges::split_view words{sentence, delim};

    std::cout << "begin(): " << std::quoted(std::string_view{*words.begin()})
              << "\nSubstrings: ";
    for (auto word : words)
        std::cout << std::quoted(std::string_view(word)) << ' ';

    std::ranges::split_view letters{sentence, std::string_view{""}};
    std::cout << "\nbegin(): " << std::quoted(std::string_view{*letters.begin()})
              << "\nLetters: ";
    for (auto letter : letters)
        std::cout << std::string_view(letter) << ' ';
    std::cout << '\n';
}

Вывод:

begin(): "Keep"
Substrings: "Keep" "moving" "forward" ""
begin(): "K"
Letters: K e e p . . m o v i n g . . f o r w a r d . .

См. также

end	возвращает итератор или sentinel для конца (открытая функция-член)
begin	возвращает итератор к началу (открытая функция-член `std::ranges::lazy_split_view<V,Pattern>`)
ranges::begin (C++20)	возвращает итератор к началу диапазона (объект точки настройки)

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