CKTIS / C++
std::views::take — una vista dei primi elementi di un intervallo
std::views::take, dichiarato in <ranges>, crea una vista di al massimo count elementi iniziali di un intervallo. Ne mantiene l’ordine, non crea un contenitore separato e supporta sia la chiamata diretta sia la notazione a pipeline.
Versione: C++23; repository compiler flag, production runtime not attested
Sintassi
#include <ranges>
std::views::take(range, count)
range | std::views::take(count)std::views::take è un oggetto adattatore di intervalli fornito da <ranges>. L’espressione std::views::take(range, count) corrisponde a range | std::views::take(count). Se count è non negativo e rappresentabile nel tipo differenza degli iteratori dell’intervallo, il risultato espone i primi count elementi nel loro ordine originale oppure l’intero intervallo se contiene meno elementi. Se count è 0, il risultato è vuoto.
È una vista, non un contenitore copiato: l’applicazione dell’adattatore non copia gli elementi in una nuova raccolta e non rimuove gli elementi finali dalla sorgente. Gli elementi vengono letti durante l’iterazione. Il risultato non deve necessariamente essere di tipo std::ranges::take_view; per alcuni tipi di intervalli lo standard prevede altre rappresentazioni di vista equivalenti, quindi di solito è opportuno usare auto.
L’argomento count deve essere convertibile nel tipo differenza degli iteratori dell’intervallo. Si usi un valore non negativo e rappresentabile in quel tipo, anche quando l’adattatore non costruisce una std::ranges::take_view. Per esempio, nel caso ottimizzato di std::span, l’adattatore converte count in quel tipo prima di calcolare il minimo tra il valore convertito e la lunghezza dell’intervallo. Un valore di tipo senza segno troppo grande per essere rappresentato può diventare -1 dopo la conversione e causare operazioni aritmetiche non valide sugli iteratori, anziché selezionare l’intero intervallo. Quando l’adattatore costruisce una std::ranges::take_view, il costruttore richiede che il valore convertito sia non negativo. Un valore negativo non indica un conteggio a partire dalla fine. Se il tipo dell’intervallo di input è una specializzazione di std::ranges::empty_view, l’adattatore valuta l’argomento count e ne scarta il valore senza costruire una std::ranges::take_view, quindi un valore negativo non viola tale precondizione.
Quando si adatta un contenitore esistente tramite un lvalue, la vista fa riferimento a quel contenitore. La sorgente deve quindi rimanere in vita mentre la vista viene usata; le operazioni che invalidano gli iteratori possono invalidare anche l’accesso tramite la vista. Nell’esempio, la modifica di values[0] dopo la creazione di first è visibile nell’output: 11 20 30. Il codice mostrato è stato eseguito senza modifiche in un ambiente isolato. Il suo output standard corrispondeva esattamente a quello indicato.
Esempi
#include <array>
#include <iostream>
#include <ranges>
int main() {
std::array<int, 5> values{10, 20, 30, 40, 50};
auto first = values | std::views::take(3);
values[0] = 11;
bool separator = false;
for (int value : first) {
if (separator) std::cout << ' ';
std::cout << value;
separator = true;
}
std::cout << '\n';
}
Risultato
11 20 30
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.