WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C++

std::views::drop — die ersten N Elemente überspringen

std::views::drop erstellt eine Sicht auf einen Bereich ohne dessen erste N Elemente, ohne sie aus dem Container zu entfernen. Möglich sind sowohl der Aufruf mit zwei Argumenten als auch die Pipe-Syntax. Die Anzahl der zu überspringenden Elemente muss nichtnegativ sein.

Version: 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, verfügbar über <ranges>, ist ein Range-Adaptor-Objekt. Mit std::views::drop(range, count) oder range | std::views::drop(count) erhältst du eine Sicht, die Elemente am Anfang des Bereichs überspringt. Wie viele Positionen übersprungen werden, bestimmt der Wert von count nach der Konvertierung in den Differenztyp der Iteratoren des Bereichs. Ist der konvertierte Wert null, umfasst die Sicht alle Elemente; erreicht oder überschreitet er die Länge eines endlichen Bereichs, ist das Ergebnis leer.

Der Adaptor entfernt keine Elemente aus dem Container und erstellt auch keinen neuen Container mit Kopien der verbleibenden Werte. Das Ergebnis ist gewöhnlich eine std::ranges::drop_view; für bestimmte Bereichstypen sieht der Standard jedoch eine andere, gleichwertige Sicht vor. Gehe daher nicht von einem bestimmten Ergebnistyp aus, sondern verwende auto.

count muss in den Differenztyp der Iteratoren des Bereichs konvertierbar sein. Sowohl der übergebene als auch der konvertierte Wert müssen nichtnegativ sein. Ein negativer Wert bedeutet nicht, dass vom Ende aus übersprungen wird. Wenn die Sicht auf einen vorhandenen Container verweist, muss dieser während der Verwendung der Sicht weiterhin existieren. Operationen, die seine Iteratoren ungültig machen, können die sichere Verwendung der Sicht ebenfalls verhindern.

Das Überspringen ist nicht immer konstant schnell: Das Ermitteln des Anfangs kann erfordern, die übersprungenen Elemente zu durchlaufen. Bei einem Bereich, der forward_range erfüllt, speichert drop_view den berechneten Anfang zwischen, wenn dies zur Einhaltung der Komplexitätsanforderungen nötig ist. Im Beispiel enthält values weiterhin fünf Elemente, während die Iteration über tail 30 40 50 ausgibt.

Beispiele

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

Ergebnis

30 40 50

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen