CKTIS / C++
std::views::drop — preskok prvih N elementov
std::views::drop ustvari pogled na obseg brez njegovih prvih N elementov, ne da bi jih odstranil iz vsebnika. Uporabite lahko klic z dvema argumentoma ali cevno sintakso. Število elementov, ki jih preskočimo, mora biti nenegativno.
Različica: C++23; repository compiler flag, production runtime not attested
Sintaksa
#include <ranges>
std::views::drop(range, count)
range | std::views::drop(count)std::views::drop, dostopen prek <ranges>, je objekt prilagodilnika obsegov. Zapis std::views::drop(range, count) ali range | std::views::drop(count) ustvari pogled, ki preskoči elemente na začetku obsega. Število preskočenih položajev določa vrednost count po pretvorbi v razlikovalni tip iteratorjev obsega. Če je pretvorjena vrednost nič, pogled zajema vse elemente; če je enaka dolžini končnega obsega ali večja od nje, je rezultat prazen.
Prilagodilnik ne odstrani elementov iz vsebnika in ne ustvari novega vsebnika s kopijami preostalih vrednosti. Rezultat je običajno std::ranges::drop_view, vendar standard za nekatere vrste obsegov določa drug, enakovreden pogled. Zato ne predpostavljajte določene vrste rezultata; uporabite auto.
count mora biti pretvorljiv v razlikovalni tip iteratorjev obsega. Tako podana kot pretvorjena vrednost morata biti nenegativni. Negativna vrednost ne pomeni preskakovanja od konca. Če se pogled sklicuje na obstoječi vsebnik, mora ta obstajati, dokler uporabljate pogled; operacije, ki razveljavijo njegove iteratorje, lahko tudi onemogočijo varno uporabo pogleda.
Preskakovanje ni vedno konstantno zahtevno: iskanje začetka lahko zahteva prehod čez preskočene elemente. Pri obsegu, ki izpolnjuje forward_range, drop_view shrani izračunani začetek, kadar je to potrebno za izpolnjevanje zahtev glede zahtevnosti. V primeru values še vedno vsebuje pet elementov, medtem ko iteriranje po tail izpiše 30 40 50.
Primeri
#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';
}
Rezultat
30 40 50
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.