Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C++

std::views::drop — pomijanie pierwszych N elementów

std::views::drop tworzy widok zakresu bez pierwszych N elementów, nie usuwając ich z kontenera. Można użyć wywołania z dwoma argumentami albo składni potokowej. Liczba pomijanych elementów musi być nieujemna.

Wersja: C++23; repository compiler flag, production runtime not attested

Składnia

#include <ranges>
std::views::drop(range, count)
range | std::views::drop(count)

std::views::drop, dostępne przez <ranges>, jest obiektem adaptora zakresu. Zapis std::views::drop(range, count) lub range | std::views::drop(count) udostępnia widok, który pomija elementy od początku zakresu. O liczbie pomijanych pozycji decyduje wartość count po konwersji do typu różnicy iteratorów zakresu. Jeśli po konwersji wartość wynosi zero, widok obejmuje wszystkie elementy; jeśli jest co najmniej równa długości skończonego zakresu, wynik jest pusty.

Adaptor nie usuwa elementów z kontenera ani nie tworzy nowego kontenera z kopią pozostałych wartości. Zwykle wynikiem jest std::ranges::drop_view, ale dla niektórych typów zakresów standard przewiduje inny, równoważny widok. Nie zakładaj więc konkretnego typu wyniku; użyj auto.

count musi być konwertowalne do typu różnicy iteratorów zakresu. Zarówno przekazana wartość, jak i wartość po konwersji muszą być nieujemne. Wartość ujemna nie oznacza pomijania od końca. Jeśli widok odwołuje się do istniejącego kontenera, kontener musi żyć podczas korzystania z widoku; operacje unieważniające jego iteratory mogą też uniemożliwić bezpieczne używanie widoku.

Pomijanie nie zawsze ma stały koszt: ustalenie początku może wymagać przejścia przez pomijane elementy. drop_view dla zakresu spełniającego forward_range zapamiętuje obliczony początek, gdy jest to potrzebne do spełnienia wymagań złożoności. W przykładzie values nadal zawiera pięć elementów, natomiast iteracja po tail wypisuje 30 40 50.

Przykłady

#include <array>
#include <iostream>
#include <ranges>

int main() {
    std::array<int, 5> values{10, 20, 30, 40, 50};
    auto tail = values | std::views::drop(2);

    bool first = true;
    for (int value : tail) {
        if (!first) std::cout << ' ';
        std::cout << value;
        first = false;
    }
    std::cout << '\n';
}

Wynik

30 40 50

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła