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 >
inline constexpr bool enable_borrowed_range<std::ranges::take_view<T>> =
    std::ranges::enable_borrowed_range<T>;

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

Пример

#include <algorithm>
#include <iostream>
#include <ranges>
 
auto print = [](char x){ std::cout << x; };
 
int main()
{
    constexpr char pi[]{'3', '.', '1', '4', '1', '5', '9', '2'};
 
    std::ranges::for_each(pi | std::ranges::views::take(6), print);
    std::cout << '\n';
 
    // safely takes 8 chars only, i.e. min(pi.size(), 42)
    std::ranges::for_each(std::ranges::take_view{pi, 42}, print);
 
    std::cout << '\n';
}

3.1415
3.141592

Отчёты о дефектах

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

См. также