KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C++

std::views::drop — de eerste N elementen overslaan

std::views::drop maakt een view van een bereik zonder de eerste N elementen, maar verwijdert ze niet uit de container. Je kunt de aanroep met twee argumenten of de pipe-syntaxis gebruiken. Het aantal over te slaan elementen moet niet-negatief zijn.

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

Syntax

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

std::views::drop, beschikbaar via <ranges>, is een range-adaptorobject. Met std::views::drop(range, count) of range | std::views::drop(count) krijg je een view die elementen aan het begin van het bereik overslaat. Het aantal over te slaan posities wordt bepaald door de waarde van count na conversie naar het verschiltype van de iterators van het bereik. Als de geconverteerde waarde nul is, bevat de view alle elementen; als de waarde minstens gelijk is aan de lengte van een eindig bereik, is het resultaat leeg.

De adaptor verwijdert geen elementen uit de container en maakt ook geen nieuwe container met kopieën van de resterende waarden. Het resultaat is meestal een std::ranges::drop_view, maar voor bepaalde bereiktypen schrijft de standaard een andere, gelijkwaardige view voor. Ga dus niet uit van een specifiek resultaattype; gebruik auto.

count moet converteerbaar zijn naar het verschiltype van de iterators van het bereik. Zowel de opgegeven als de geconverteerde waarde moet niet-negatief zijn. Een negatieve waarde betekent niet dat er vanaf het einde elementen worden overgeslagen. Als de view naar een bestaande container verwijst, moet die container blijven bestaan zolang de view wordt gebruikt; bewerkingen die de iterators ongeldig maken, kunnen het gebruik van de view ook onveilig maken.

Overslaan heeft niet altijd constante kosten: het begin bepalen kan vereisen dat de overgeslagen elementen worden doorlopen. Voor een bereik dat aan forward_range voldoet, slaat drop_view het berekende begin op wanneer dat nodig is om aan de complexiteitseisen te voldoen. In het voorbeeld bevat values nog steeds vijf elementen, terwijl itereren over tail 30 40 50 afdrukt.

Voorbeelden

#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';
}

Resultaat

30 40 50

De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.

Bronnen