CKTIS / C++
std::views::drop — přeskočení prvních N prvků
std::views::drop vytvoří pohled na rozsah bez jeho prvních N prvků, aniž by je odstranil z kontejneru. Lze použít volání se dvěma argumenty nebo zápis s operátorem `|` pro řetězení adaptérů. Počet přeskakovaných prvků musí být nezáporný.
Verze: C++23; repository compiler flag, production runtime not attested
Syntaxe
#include <ranges>
std::views::drop(range, count)
range | std::views::drop(count)std::views::drop, dostupné přes <ranges>, je objekt adaptéru rozsahů. Přímé volání std::views::drop(range, count) i zápis range | std::views::drop(count) s operátorem pro řetězení adaptérů vytvoří pohled, který přeskakuje prvky na začátku rozsahu. Počet přeskočených pozic určuje hodnota count po převodu na rozdílový typ iterátorů rozsahu. Je-li převedená hodnota nulová, pohled zahrnuje všechny prvky; je-li rovna délce konečného rozsahu nebo je větší, výsledek je prázdný.
Adaptér neodstraňuje prvky z kontejneru ani nevytváří nový kontejner s kopiemi zbývajících hodnot. Výsledkem je obvykle std::ranges::drop_view, ale pro některé typy rozsahů standard stanoví jiný, ekvivalentní pohled. Nepředpokládejte proto konkrétní typ výsledku; použijte auto.
count musí být převoditelné na rozdílový typ iterátorů rozsahu. Předaná i převedená hodnota musí být nezáporná. Záporná hodnota neznamená přeskakování od konce. Pokud pohled odkazuje na existující kontejner, musí tento kontejner zůstat živý po dobu používání pohledu; operace, které zneplatní jeho iterátory, mohou také znemožnit bezpečné používání pohledu.
Přeskakování nemá vždy konstantní časovou složitost: nalezení začátku může vyžadovat průchod přes přeskakované prvky. U rozsahu splňujícího forward_range ukládá drop_view vypočtený začátek do mezipaměti, je-li to potřeba ke splnění požadavků na složitost. V příkladu values stále obsahuje pět prvků, zatímco iterace přes tail vypíše 30 40 50.
Příklady
#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';
}
Výsledek
30 40 50
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.