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

template< ranges::view V >
class take_view
    : public ranges::view_interface<take_view<V>>

namespace views {
    inline constexpr /* unspecified */ take = /* unspecified */;
}

template< ranges::viewable_range R >
    requires /* see below */
constexpr ranges::view auto
    take( R&& r, ranges::range_difference_t<R> count );

template< class DifferenceType >
constexpr /* range adaptor closure */ take( DifferenceType&& count );

views::take(e, f) эквивалентно выражению (где T — это std::remove_cvref_t<decltype((e))>, а D — это ranges::range_difference_t<decltype((e))>):

• ((void)f, decay-copy(e)), если T является специализацией ranges::empty_view, за исключением того, что вычисления e и f упорядочены неопределённым образом;
• U(ranges::begin(e), ranges::begin(e) + std::min<D>(ranges::distance(e), f)), если T является специализацией std::span, std::basic_string_view или ranges::subrange, которая моделирует одновременно random_access_range и sized_range, где U — это
• std::span<typename T::element_type>, если T является специализацией std::span;
• T, если T является специализацией std::basic_string_view;
• ranges::subrange<ranges::iterator_t<T>>, если T является специализацией ranges::subrange;
• ranges::iota_view(*ranges::begin(e),*(ranges::begin(e) + std::min<D>(ranges::distance(e), f))), если T является специализацией ranges::iota_view, которая моделирует одновременно random_access_range и sized_range;

• в противном случае — take_view(e, f).

take_view моделирует концепции contiguous_range, random_access_range, bidirectional_range, forward_range, input_range и sized_range, если базовое представление V моделирует соответствующие концепции. Оно моделирует common_range, если базовое представление V моделирует одновременно random_access_range и sized_range.

Члены данных

Функции-члены

Направляющие вывода

Вложенные классы

Вспомогательные шаблоны

template< class T >
constexpr bool enable_borrowed_range<std::ranges::take_view<T>> =
    ranges::enable_borrowed_range<T>;

Эта специализация ranges::enable_borrowed_range позволяет take_view удовлетворять концепции borrowed_range, если ей удовлетворяет базовое представление.

Пример

#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

Отчёты об ошибках

Следующие отчёты об ошибках, изменяющие поведение, были применены ретроспективно к ранее опубликованным стандартам C++.

См. также