Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C++

std::views::drop — saltare i primi N elementi

std::views::drop crea una vista di un intervallo senza i suoi primi N elementi, senza rimuoverli dal contenitore. Si può usare la chiamata con due argomenti oppure la sintassi a pipeline. Il numero di elementi da saltare deve essere non negativo.

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

Sintassi

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

std::views::drop, disponibile tramite <ranges>, è un oggetto adattatore di intervallo. Con std::views::drop(range, count) o range | std::views::drop(count) si ottiene una vista che salta gli elementi iniziali dell’intervallo. Il numero di posizioni da saltare è determinato dal valore di count dopo la conversione nel tipo differenza degli iteratori dell’intervallo. Se il valore convertito è zero, la vista include tutti gli elementi; se è almeno pari alla lunghezza di un intervallo finito, il risultato è vuoto.

L’adattatore non rimuove elementi dal contenitore e non crea un nuovo contenitore con copie dei valori rimanenti. Il risultato è di solito una std::ranges::drop_view, ma per alcuni tipi di intervallo lo standard specifica una vista equivalente diversa. Non dare quindi per scontato un tipo di risultato specifico; usa auto.

count deve essere convertibile nel tipo differenza degli iteratori dell’intervallo. Sia il valore fornito sia quello convertito devono essere non negativi. Un valore negativo non significa saltare elementi a partire dalla fine. Se la vista fa riferimento a un contenitore esistente, questo deve restare in vita mentre si usa la vista; anche le operazioni che invalidano i suoi iteratori possono rendere insicuro l’uso della vista.

Saltare elementi non ha sempre un costo costante: trovare l’inizio può richiedere di attraversare gli elementi saltati. Per un intervallo che soddisfa forward_range, drop_view memorizza l’inizio calcolato quando serve a rispettare i requisiti di complessità. Nell’esempio, values contiene ancora cinque elementi, mentre l’iterazione su tail stampa 30 40 50.

Esempi

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

Risultato

30 40 50

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti