Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

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.

Zdroje