std::ranges::views::drop, std::ranges::drop_view

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

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

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

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

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

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

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

Члены-данные

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

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

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

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

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

Пример

#include <initializer_list>
#include <iostream>
#include <ranges>

int main()
{
    const auto nums = {1, 2, 3, 4, 5, 6, 7};

    std::cout << "drop " << 2 << ": ";
    for (int i : std::ranges::drop_view{nums, 2})
        std::cout << i << ' ';
    std::cout << '\n';

    std::cout << "drop " << 3 << ": ";
    for (int i : nums | std::views::drop(3))
        std::cout << i << ' ';
    std::cout << '\n';

    std::cout << "drop " << 4 << ": ";
    for (int i : std::views::iota(1, 8) | std::views::drop(4))
        std::cout << i << ' ';
    std::cout << '\n';

    // Note that dropping more than the number of elements is OK:
    for (int dp : {5, 6, 7, 890, 100500})
    {
        std::cout << "drop " << dp << ": ";
        for (int i : std::views::iota(1, 8) | std::views::drop(dp))
            std::cout << i << ' ';
        std::cout << '\n';
    }
}

drop 2: 3 4 5 6 7
drop 3: 4 5 6 7
drop 4: 5 6 7
drop 5: 6 7
drop 6: 7
drop 7:
drop 890: 
drop 100500:

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

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

См. также