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.