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

constexpr /*iterator*/ begin();

(since C++20)

Возвращает итератор iterator на первый найденный поддиапазон.

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

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

Данные члены-члены base_ и cached_begin_ описаны здесь.

Параметры

(нет)

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

Итератор iterator.

Сложность

Амортизированная \(\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 (std::string_view word : words)
        std::cout << std::quoted(word) << ' ';
 
    std::ranges::split_view letters{sentence, std::string_view{""}};
    std::cout << "\nbegin(): " << std::quoted(std::string_view{*letters.begin()})
              << "\nLetters: ";
    for (std::string_view letter : letters)
        std::cout << 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 (C++20)	возвращает итератор или конечную точку конца (публичный член-функция)
begin (C++20)	возвращает итератор в начало (публичный член-функция `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/w/cpp/ranges/split_view/begin