std::ranges:: views:: take, std::ranges:: take_view

1) Ein Bereichsadapter, der eine view der Elemente aus einer zugrunde liegenden Sequenz darstellt, beginnend am Anfang und endend an einer gegebenen Grenze.

2) views::take is a RangeAdaptorObject . The expression views :: take ( e, f ) results in a view that represents the first f elements from e . The result is not necessarily a take_view .

views :: take ( e, f ) ist ausdrucksäquivalent zu (wobei T für std:: remove_cvref_t < decltype ( ( e ) ) > und D für ranges:: range_difference_t < decltype ( ( e ) ) > steht):

• ( ( void ) f, decay-copy ( e ) ) , falls T ein ranges:: empty_view ist, außer dass die Auswertungen von e und f unbestimmt sequenziert sind;
• U ( ranges:: begin ( e ) , ranges:: begin ( e ) + std:: min < D > ( ranges:: distance ( e ) , f ) ) , falls T eine Spezialisierung von std:: span , std::basic_string_view , oder ranges:: subrange ist, die sowohl random_access_range als auch sized_range modelliert, wobei U ist

• std:: span < typename T :: element_type > , falls T eine Spezialisierung von std:: span ist;
• T , falls T eine Spezialisierung von std::basic_string_view ist;
• ranges:: subrange < ranges:: iterator_t < T >> , falls T eine Spezialisierung von ranges:: subrange ist;

• ranges:: iota_view ( * ranges:: begin ( e ) ,
  * ( ranges:: begin ( e ) + std:: min < D > ( ranges:: distance ( e ) , f ) ) ) , falls T eine Spezialisierung von ranges:: iota_view ist, die sowohl random_access_range als auch sized_range modelliert;

andernfalls, falls T eine Spezialisierung von ranges::repeat_view ist: views:: repeat ( * e. value_ , std:: min < D > ( ranges:: distance ( e ) , f ) ) , falls T das Konzept sized_range modelliert; in diesem Fall wird e nur einmal ausgewertet; views:: repeat ( * e. value_ , static_cast < D > ( e ) ) andernfalls;

(seit C++23)

• ansonsten, take_view ( e, f ) .

In all cases, decltype ( ( f ) ) must model std:: convertible_to < D > .

#include <algorithm>
#include <iostream>
#include <ranges>
int main()
{
    namespace views = std::views;
    auto print = [](char x){ std::cout << x; };
    for (const char nums[]{'1', '2', '3'};
         int n : views::iota(0, 5))
    {
        std::cout << "take(" << n << "): ";
        // safely takes only upto min(n, nums.size()) elements:
        std::ranges::for_each(nums | views::take(n), print);
        std::cout << '\n';
    }
}

take(0): 
take(1): 1
take(2): 12
take(3): 123
take(4): 123